@sendinel/mcp-server

@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