@sendinel/mcp-server

Sendinel's published MCP server package for local stdio clients such as Claude Desktop, Claude Code, Cursor, and Codex CLI.

AI-controlled email operations control plane for campaigns, contacts, segments, templates, analytics, deliverability, and multi-provider sending across the Sendinel portfolio.

• Categories: email, marketing, crm, automation, analytics
• Official registry name: io.github.kmdesle/sendinel
• Hosted remote endpoint: https://sendinel.ai/mcp
• npm package: @sendinel/mcp-server
• Source: https://github.com/kmdesle/sendinel-ai/tree/main/packages/mcp-server

Tool groups

Sendinel currently exposes 21 tool groups and about 155 tools. The full reference lives in docs/mcp-tools.md.

| Group | Count | Purpose | |-------|-------|---------| | campaigns | 26 | Full campaign lifecycle | | contacts | 22 | Subscriber CRUD, tags, suppression, merges, timelines | | analytics | 9 | Stats, engagement, deliverability, portfolio reporting | | data | 15 | Export, scoring, hygiene, migrations, import history | | org | 15 | Team members, API keys, platform connections, plan, onboarding | | templates | 7 | Template CRUD, AI brief generation, translation | | sms | 7 | SMS send, consent, inbound, logs | | segments | 6 | Audience builder and preview | | content | 5 | Content blocks, sources, send-time optimization | | ab_testing | 5 | A/B setup and significance checks | | drafts | 4 | Draft create and approval flow | | delivery | 9 | Domain and deliverability operations | | warmup | 4 | Warmup schedule controls | | social | 4 | Social campaigns and scheduling | | forms | 3 | Forms and stats | | webhooks | 4 | Webhook subscription management | | approvals | 3 | Approval workflow and advisor hooks | | automations | 4 | Automation triggers and previews | | sites | 3 | Site and sender management | | gdpr | 2 | Contact deletion and log | | history | 3 | Chat thread history and search |

Install / run

npx -y @sendinel/mcp-server@latest

The package also exposes the legacy bin alias:

npx -y sendinel-mcp

Required environment

• SENDINEL_API_KEY

Optional server-side env when you run the package outside the main Sendinel app environment:

• SUPABASE_URL or NEXT_PUBLIC_SUPABASE_URL
• SUPABASE_SERVICE_ROLE_KEY
• MCP_TRANSPORT (stdio by default, http for HTTP/SSE mode)
• MCP_SERVER_PORT (HTTP mode only)

Stdio mode fails closed if SENDINEL_API_KEY is missing or invalid.

MCP client examples

Claude Desktop / Cursor

{
  "mcpServers": {
    "sendinel": {
      "command": "npx",
      "args": ["-y", "@sendinel/mcp-server@latest"],
      "env": {
        "SENDINEL_API_KEY": "snk_your_api_key"
      }
    }
  }
}

Codex CLI

[mcp_servers.sendinel]
command = "npx"
args = ["-y", "@sendinel/mcp-server@latest"]

[mcp_servers.sendinel.env]
SENDINEL_API_KEY = "snk_your_api_key"

Or add it automatically:

codex mcp add sendinel --env SENDINEL_API_KEY=snk_your_api_key -- npx "-y" "@sendinel/mcp-server@latest"

Transport

• stdio by default
• http when MCP_TRANSPORT=http

Publishing

This package is intended to be published publicly to npm and listed in MCP directories:

• package name: @sendinel/mcp-server
• default launcher: npx -y @sendinel/mcp-server@latest
• official registry manifest: server.json
• Smithery config: ../../smithery.yaml