Appearance
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.
| Mode | Transport | Best for |
|---|---|---|
Hosted (sendapi.co/mcp) | streamable HTTP | One‑click remote connectors with no install (Claude/ChatGPT remote connectors, n8n MCP Client node). |
Local (npx) | stdio | Coding 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 theX-SendAPI-Keyheader)
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_xxxxCall 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_templatesEach 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_…(orX-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.
Related
- Agent Skills — teach Claude how to send well, on top of these tools.
- AI Agents & Automations — connect n8n, Zapier, and custom agents.