MailerBot MCP Server

MCP (Model Context Protocol) server for the MailerBot direct mail API. Enables AI tools like Claude, Cursor, and others to manage contacts, mailings, campaigns, and more.

Remote server (recommended)

URL: https://mcp.mailerbot.com/mcp. OAuth is handled automatically — no API key to manage.

In Claude: Settings > Connectors > Add custom connector, then paste the URL above.

Quick Start (Local / STDIO)

# Set your API key
export MAILERBOT_API_KEY="mb_live_..."

# Run via uvx
uvx mailerbot-mcp

# Or run from source
cd mcp
uv run mailerbot-mcp

Claude Desktop Configuration

{
  "mcpServers": {
    "mailerbot": {
      "command": "uvx",
      "args": ["mailerbot-mcp"],
      "env": {
        "MAILERBOT_API_KEY": "mb_live_..."
      }
    }
  }
}

Self-Hosted (SSE)

docker build -t mailerbot-mcp -f mcp/Dockerfile .
docker run -p 8080:8080 \
  -e MAILERBOT_MCP_TRANSPORT=sse \
  -e MAILERBOT_BEARER_TOKEN="..." \
  mailerbot-mcp

Environment Variables

Available Tools

Contacts — list, get, create, update, delete, validate addresses Contact Lists — list, get, create, update, delete, add/remove contacts Documents — list, get, create, update, delete Postcards — list templates, list, get, create, delete Mailings — list, get, create, update, delete, validate addresses, estimate cost, calculate cost, send Campaigns — list, get, create, update, delete, add/remove mailings Dashboard — stats, reporting Pricing — catalog, countries, postage zones, postage rates Coupons — list, get, create, update, delete, list/import codes, check availability QR Tracking — list, create, delete links, analytics Merge Tags — list available tags