sendry-mcp

Model Context Protocol server for the Sendry email API. Lets AI agents (Claude Desktop, Claude Code, Cursor, Codex, Gemini, Continue, …) manage emails, domains, templates, contacts, audiences, campaigns and the rest of the Sendry surface area on your behalf.

• 100+ tools covering every Sendry resource (send_email, list_emails, create_domain, verify_domain, create_template, send_campaign, …).
• Built on the official sendry-sdk JS SDK.
• Stdio transport — works with every MCP host out of the box.
• Zero config beyond an API key.

Installation

You don't need to install it ahead of time — npx will fetch the latest version on demand:

SENDRY_API_KEY="sn_live_…" npx sendry-mcp

Or install globally if you prefer:

npm i -g sendry-mcp
sendry-mcp

Claude Desktop

Add an entry under mcpServers in claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%/Claude/claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "sendry": {
      "command": "npx",
      "args": ["-y", "sendry-mcp"],
      "env": {
        "SENDRY_API_KEY": "sn_live_replace_me"
      }
    }
  }
}

Restart Claude Desktop. You'll see a hammer icon with the Sendry tools listed.

Cursor / Codex / Gemini / Continue

Any client that follows the MCP stdio spec works the same way. The minimum config is command: "npx", args: ["-y", "sendry-mcp"], and the SENDRY_API_KEY env var set on the spawned process.

Environment variables

| Variable | Required | Default | Description | |---|---|---|---| | SENDRY_API_KEY | yes | — | Your Sendry API key. Get one from https://sendry.online/dashboard/api-keys. The MCP server inherits the API key's scope (full_access, sending_access, or read_only). | | SENDRY_BASE_URL | no | https://api.sendry.online | Override the API host. Useful for self-hosted Sendry deployments. |

Example prompts

Once connected, you can ask your agent things like:

• "Send a welcome email to [email protected] from [email protected]."
• "List all domains and tell me which ones haven't been verified."
• "Create a new audience called 'Pro customers'."
• "How many emails did I send last week, broken down by domain?"
• "Pause campaign cmp_abc123."

Tool reference

Tools are namespaced under sendry_ and grouped by resource:

| Resource | Tools | |---|---| | Emails | send_email, get_email, list_emails, send_batch, send_marketing_email, cancel_email | | Domains | create_domain, list_domains, get_domain, verify_domain, update_domain, remove_domain, configure_bimi | | Templates | create_template, list_templates, get_template, update_template, remove_template, render_template | | Contacts | create_contact, list_contacts, get_contact, get_contact_by_email, update_contact, update_contact_by_email, remove_contact, bulk_import_contacts | | Audiences | create_audience, list_audiences, get_audience, update_audience, remove_audience, add_contacts_to_audience, list_audience_contacts | | Campaigns | create_campaign, list_campaigns, get_campaign, update_campaign, schedule_campaign, send_campaign, cancel_campaign, pause_campaign, resume_campaign, remove_campaign | | Webhooks | create_webhook, list_webhooks, get_webhook, update_webhook, remove_webhook | | Analytics | analytics_stats, analytics_logs, analytics_cohorts, analytics_benchmarks, analytics_breakdowns | | Suppression | list_suppression, add_suppression, remove_suppression | | Unsubscribes | list_unsubscribes, create_unsubscribe, batch_unsubscribe, remove_unsubscribe | | API keys | create_api_key, list_api_keys, remove_api_key | | Team | list_team, invite_team_member, remove_team_member, update_team_member_role | | Billing | get_billing_plan, get_billing_usage | | Segments | create_segment, list_segments, get_segment, update_segment, remove_segment, remove_contact_from_segment | | Topics | create_topic, list_topics, get_topic, remove_topic, subscribe_to_topic, unsubscribe_from_topic | | Contact properties | list_contact_properties, create_contact_property, remove_contact_property, get_contact_property_values | | Other | deliverability_insights, create_email_share_link, download_attachment, get_domain_tracking, create_export, list_exports, get_export, download_export_url, get_postmaster_credentials, postmaster_sync, delete_postmaster_credentials, list_dlq, get_dlq_job, retry_dlq_job, remove_dlq_job |

Notes on output size

The MCP server post-processes Sendry API responses to keep them small:

• Email HTML bodies are truncated to 2000 chars (the full body is still on the server, fetch via the SDK if needed).
• List endpoints are capped at 20 items per call — use the returned cursor for the next page.
• Attachment downloads return metadata only; binary bytes would blow the model context budget. Use the JS SDK for the actual file.

Development

bun install
bun run build
SENDRY_API_KEY=test node dist/index.js

License

Apache-2.0