Skip to content

MCP Server

The SendAPI Model Context Protocol server gives any MCP‑compatible AI agent — Claude Code & Desktop, ChatGPT/Codex, Cursor, Windsurf, Cline, or an n8n AI Agent — a set of typed tools to send WhatsApp, SMS, OTP, and email. The agent calls the tools directly; there is no integration code to write.

How it works

The server is a thin, stateless adapter: every tool call maps to one authenticated SendAPI REST call (https://sendapi.co/v1). Your API key is used only for the lifetime of each request and is never stored server‑side, so one hosted deployment safely serves every account.

There are two ways to run it.

ModeTransportBest for
Hosted (sendapi.co/mcp)streamable HTTPOne‑click remote connectors with no install (Claude/ChatGPT remote connectors, n8n MCP Client node).
Local (npx)stdioCoding agents on your machine (Claude Code, Cursor, Windsurf, Cline, Codex CLI).

Hosted (remote) server

No install. Point your client at the URL and authenticate with your key.

  • URL: https://sendapi.co/mcp
  • Auth: Authorization: Bearer sk_live_xxxx (or the X-SendAPI-Key header)

Claude Code

bash
claude mcp add --transport http sendapi https://sendapi.co/mcp \
  --header "Authorization: Bearer sk_live_xxxx"

Cursor / Windsurf — .cursor/mcp.json

json
{
  "mcpServers": {
    "sendapi": {
      "url": "https://sendapi.co/mcp",
      "headers": { "Authorization": "Bearer sk_live_xxxx" }
    }
  }
}

ChatGPT / Codex

Add a remote MCP connector by URL with Bearer auth:

text
URL:   https://sendapi.co/mcp
Auth:  Bearer sk_live_xxxx

Call it directly

The hosted endpoint speaks JSON‑RPC over HTTP and replies as Server‑Sent Events. Useful for testing or for clients that drive MCP manually:

bash
curl -X POST https://sendapi.co/mcp \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "tools/call",
    "params": {
      "name": "send_email",
      "arguments": {
        "to": "customer@example.com",
        "from": "you@yourdomain.com",
        "subject": "Hello",
        "text": "Sent through the SendAPI MCP server."
      }
    }
  }'

Local (stdio) server

Runs on your machine via npx — nothing to install globally. Add it to your MCP config (.mcp.json in a project, or claude_desktop_config.json):

json
{
  "mcpServers": {
    "sendapi": {
      "command": "npx",
      "args": ["-y", "@sendapi/mcp-server"],
      "env": { "SENDAPI_API_KEY": "sk_live_xxxx" }
    }
  }
}

The server is open source at SendAPI-co/sendapi-mcp. You can self‑host the HTTP transport with the included Docker image and point your client at http://localhost:8080/mcp.

Available tools

text
send_whatsapp        send_sms              send_email
send_otp             check_otp             validate_phone
send_bulk_whatsapp   send_bulk_sms         send_bulk_email
get_usage            get_sms_status        get_email_status
get_whatsapp_message list_whatsapp_sessions get_whatsapp_session_qr
list_sender_ids      list_email_domains    list_email_templates

Each tool maps to the matching REST endpoint — see the API Reference for the full request and response shape of any of them.

Requirements

  • A SendAPI API key — create one free in the dashboard — passed as Authorization: Bearer sk_live_… (or X-SendAPI-Key).
  • An MCP‑capable client (Claude, ChatGPT/Codex, Cursor, Windsurf, Cline, n8n). Local mode also needs Node.js for npx.
  • For WhatsApp tools, a connected session (list_whatsapp_sessions / get_whatsapp_session_qr).
  • For production email, a verified sender domain.

Released under the MIT License.