MCP Integration

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external services using typed function calls. Instead of pasting API responses into a chat window, MCP lets Claude or Cursor call Mailto.Bot directly and act on the results.

Mailto.Bot exposes an MCP server at https://mailto.bot/mcp that speaks the MCP Streamable HTTP transport (spec 2025-03-26). Any MCP-compatible client can connect using a Bearer token.

Get an API token

All MCP methods require a Bearer token. Session cookies are not supported for MCP — you must use an API token.

1. 1
   Sign in — Go to Dashboard.
2. 2
   Create a token — Navigate to Tokens and click New Token. Give it a descriptive name like claude-desktop.
3. 3
   Copy the value — The full token is shown once only. Copy it now — you will paste it into your client config below.

Claude Desktop

Requires Claude Desktop 0.9+ and Node.js 18+ (for npx).

Edit your Claude Desktop config file and add the mailtobot server entry. Replace YOUR_API_TOKEN with the token you created above.

// ~/Library/Application Support/Claude/claude_desktop_config.json  (macOS)
// %APPDATA%\Claude\claude_desktop_config.json                        (Windows)
{
  "mcpServers": {
    "mailtobot": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mailto.bot/mcp"],
      "env": {
        "MAILTOBOT_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

After saving, restart Claude Desktop. You should see mailtobot listed in the MCP servers panel (Settings → Developer).

Cursor

Requires Cursor 0.43+.

Create or edit .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global access). Cursor sends the Authorization header directly on every MCP request.

// .cursor/mcp.json  (project root, or ~/.cursor/mcp.json for global)
{
  "mcpServers": {
    "mailtobot": {
      "url": "https://mailto.bot/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Reload the window (Cmd+Shift+P → Reload Window). Cursor will show a green dot next to Mailto.Bot in the MCP panel.

Windsurf

Requires Windsurf 1.6+.

Edit ~/.codeium/windsurf/mcp_config.json (created automatically when you first open MCP settings).

// ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mailtobot": {
      "serverUrl": "https://mailto.bot/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Open Windsurf Settings → MCP and click Refresh to pick up the new server.

Available tools

Once connected, your AI assistant has access to the following Mailto.Bot tools:

Example workflows

# Example prompt to Claude Desktop / Cursor / Windsurf:

"Create a mailbox called staging-alerts and register a webhook
 pointing to https://my-server.com/alerts. Then send a test message
 with subject 'Alert system online' to that mailbox."

# Claude will call:
#   mailtobot_create_mailbox({ name: "staging-alerts" })
#   mailtobot_create_webhook({ mailboxName: "staging-alerts",
#                              url: "https://my-server.com/alerts" })
#   mailtobot_send_message({ ... })