@sendbyte/mcp

@sendbyte/mcp

The official SendByte MCP server. It lets AI agents and coding tools (Claude Desktop, Claude Code, Cursor, Continue, and any Model Context Protocol client) send email and manage sending domains, templates, analytics, and content checks through your SendByte account.

It speaks MCP over stdio and authenticates with your own SendByte API key.

Quick start

You need a SendByte API key. Create one in the dashboard under API keys (use a sk_test_ key while you experiment; it sandboxes every send).

No global install is needed. Point your MCP client at npx @sendbyte/mcp and set SENDBYTE_API_KEY in its environment.

Claude Desktop

Edit claude_desktop_config.json (Settings, Developer, Edit Config):

{
  "mcpServers": {
    "sendbyte": {
      "command": "npx",
      "args": ["-y", "@sendbyte/mcp"],
      "env": { "SENDBYTE_API_KEY": "sk_test_your_key_here" }
    }
  }
}

Claude Code

claude mcp add sendbyte --env SENDBYTE_API_KEY=sk_test_your_key_here -- npx -y @sendbyte/mcp

Cursor

Add to ~/.cursor/mcp.json (or a project .cursor/mcp.json):

{
  "mcpServers": {
    "sendbyte": {
      "command": "npx",
      "args": ["-y", "@sendbyte/mcp"],
      "env": { "SENDBYTE_API_KEY": "sk_test_your_key_here" }
    }
  }
}

Continue

In ~/.continue/config.json:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "@sendbyte/mcp"],
          "env": { "SENDBYTE_API_KEY": "sk_test_your_key_here" }
        }
      }
    ]
  }
}

Configuration

| Variable | Required | Description | | --- | --- | --- | | SENDBYTE_API_KEY | yes | An sk_live_ or sk_test_ key from the dashboard. A test key sandboxes every send. | | SENDBYTE_BASE_URL | no | Override the API host for self-hosted, staging, or local development. Defaults to https://api.sendbyte.africa. |

Tools

| Tool | What it does | | --- | --- | | send_email | Send a transactional email (inline html/text, or a saved template with variables). | | get_email | Fetch one email by id with its delivery status and event timeline. | | list_emails | List recent emails, newest first, with optional status filter and cursor paging. | | list_domains | List sending domains with verification and deliverability state. | | get_domain | Get one domain with the DNS records to publish and their current state. | | verify_domain | Re-check a domain's DNS and SES status now. | | list_templates | List saved templates. | | get_template | Get one template's subject and body. | | preview_template | Render a saved template with sample variables, without sending. | | get_analytics | Daily send counts by status and deliverability rates over the last N days. | | scan_content | Pre-send spam-risk check returning a score, level, and the signals found. |

Notes

• A sk_test_ key sandboxes sends, so an agent can exercise send_email safely. Switch to sk_live_ only when you want real delivery.
• The sender domain on send_email must be a verified sending domain on your account (or the shared test domain when using a test key).
• The server writes only to stderr; stdout is reserved for the MCP protocol.

License

MIT