Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tuco.ai/llms.txt

Use this file to discover all available pages before exploring further.

What is the Tuco MCP Server?

The Model Context Protocol (MCP) server lets AI assistants control your Tuco workspace using natural language. Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

Installation

npx @tuco-ai/mcp-server

Configuration

Add to your Claude Desktop config (claude_desktop_config.json):
{
  "mcpServers": {
    "tuco": {
      "command": "npx",
      "args": ["@tuco-ai/mcp-server"],
      "env": {
        "TUCO_API_KEY": "tuco_your_api_key"
      }
    }
  }
}

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

  • “Send an iMessage to +12125551234 saying Hey, wanted to follow up”
  • “How are my sending lines doing?”
  • “Show me the last 5 unread replies”
  • “Add a lead: John Doe, +15551234567, CEO at Acme Corp”

Getting Your API Key

Get your API key from Integrations → API Keys in the Tuco dashboard, or at app.tuco.ai/integrations.