Skip to main content

​
MCP Server

The Tuco MCP (Model Context Protocol) Server lets AI assistants manage your iMessage platform using natural language.

​
Install

npx @tuco-ai/mcp-server

​
Configure Claude Desktop

Add this to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json): 
{
  "mcpServers": {
    "tuco": {
      "command": "npx",
      "args": ["@tuco-ai/mcp-server"],
      "env": {
        "TUCO_API_KEY": "tuco_your_api_key"
      }
    }
  }
}
Get your API key from API Keys tab in the Tuco dashboard.

​
Available Tools

ToolDescription
send-imessageSend an iMessage to any phone number
add-leadAdd a new contact to your workspace
check-imessageCheck if a number has iMessage
lines-healthMonitor all sending line health status
check-limitsView line limits and current usage
check-repliesList recent unread replies
list-campaignsView campaigns with status and stats
check-healthVerify API connection status

​
Example Prompts

Once connected, just talk to your AI assistant:
  • “Send an iMessage to +12125551234 saying Hey, wanted to follow up on our call”
  • “Check if +19042956129 has iMessage enabled”
  • “How are my sending lines doing?”
  • “Show me the last 5 unread replies”
  • “Add a lead: John Doe, +15551234567, CEO at Acme Corp”

​
Supported Clients

  • Claude Desktop
  • Cursor
  • Windsurf
  • Any MCP-compatible AI client

​
Source Code

View on npm