Skip to main content
Glama
SendAPI MCP Server

SendAPI MCP Server

Official
by SendAPI-co

@sendapi/mcp-server

Official Model Context Protocol server for SendAPI.

Give any MCP-compatible AI agent (Claude Code, Claude Desktop, ChatGPT/Codex, Cursor, Windsurf, Cline) the ability to send WhatsApp messages, SMS, OTP codes, and email through one REST API.

Quick start

You need a SendAPI API key. Create one in your dashboard.

The server runs over stdio via npx, so there is nothing to install globally.

Claude Desktop / Claude Code

Add to your MCP config (claude_desktop_config.json, or .mcp.json in a project):

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

Cursor / Windsurf / Cline

Same shape: a stdio server with command: npx, args: ["-y", "@sendapi/mcp-server"], and SENDAPI_API_KEY in env.

Related MCP server: WhatsApp MCP Server

Two ways to run it

Mode

Transport

Best for

Local (npx, above)

stdio

Coding agents on your machine (Claude Code, Cursor, Windsurf, Cline, Codex CLI).

Hosted (sendapi.co/mcp)

streamable HTTP

One-click connectors with no install (Claude/ChatGPT remote connectors, n8n MCP Client node).

Hosted (remote) server

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

  • URL: https://sendapi.co/mcp

  • Auth: Authorization: Bearer sk_live_xxxxxxxxxxxx (or the X-SendAPI-Key header)

The hosted server is multi-tenant and stateless: your key is used only for the lifetime of each request and never stored server-side. Self-host it yourself with the included Dockerfile (docker build -t sendapi-mcp . && docker run -p 8080:8080 sendapi-mcp), then connect to http://localhost:8080/mcp.

Configuration

Env var

Required

Default

Used by

Notes

SENDAPI_API_KEY

stdio only

—

stdio

Your SendAPI API key (Bearer token).

SENDAPI_BASE_URL

no

https://sendapi.co/v1

both

Override for self-hosted or staging.

PORT

no

8080

hosted

Port the HTTP server listens on.

Tools

Messaging

  • send_whatsapp — send a WhatsApp message from a connected session

  • send_bulk_whatsapp — send to many recipients (max 500)

  • send_sms / send_bulk_sms

  • send_email / send_bulk_email

Verification

  • send_otp — send a one-time code (SMS, WhatsApp, or email)

  • check_otp — verify a code

  • validate_phone — validate / look up a number

Status & usage (read-only)

  • get_email_status, get_sms_status, get_whatsapp_message

  • get_usage — remaining quota across channels

Setup helpers (read-only)

  • list_whatsapp_sessions, get_whatsapp_session_qr

  • list_sender_ids, list_email_domains, list_email_templates

Auth, billing, API-key, and team-admin endpoints are intentionally not exposed to agents.

Safety

Every send still flows through SendAPI's normal limits and abuse protection. Bulk tools are annotated as high-impact so clients can prompt for confirmation. Errors surface SendAPI's code/message so the agent can self-correct (for example sending_limited or content_blocked).

Development

npm install
npm run build      # compile TypeScript to dist/
SENDAPI_API_KEY=sk_test_xxx npm start

License

MIT

Available Tools

18 tools
check_otpVerify OTP codeA

Check a one-time password (OTP) the recipient entered against the code that was sent.

Inputs: to (required), code (required).

get_email_statusGet email statusA
Read-only

Get delivery status and details for a previously sent email by its ID.

Inputs: id (required).

get_sms_statusGet SMS statusA
Read-only

Get delivery status and details for a previously sent SMS by its ID.

Inputs: id (required).

get_usageGet account usageA
Read-only

Get current account usage and remaining quota across channels. Useful to check limits before sending in bulk.

Inputs: no named parameters.

get_whatsapp_messageGet WhatsApp messageA
Read-only

Get status and details for a WhatsApp message by its ID.

Inputs: id (required).

get_whatsapp_session_qrGet WhatsApp pairing QRA
Read-only

Get the QR code payload to pair a WhatsApp session by scanning it in the WhatsApp app.

Inputs: id (required).

list_email_domainsList email domainsA
Read-only

List sending domains and their verification status.

Inputs: no named parameters.

list_email_templatesList email templatesA
Read-only

List saved email templates that can be used with send_email via template_id.

Inputs: no named parameters.

list_sender_idsList SMS sender IDsA
Read-only

List configured SMS sender IDs and their approval status.

Inputs: no named parameters.

list_whatsapp_sessionsList WhatsApp sessionsA
Read-only

List connected WhatsApp sessions and their status. Use a session's id with send_whatsapp.

Inputs: no named parameters.

send_bulk_emailSend bulk emailA

Send the same email to many recipients (max 500). High-impact: confirm the list before calling.

Inputs: subject (required), recipients (required), from, html, +3 more.

send_bulk_smsSend bulk SMSA

Send the same SMS to many recipients (max 500). High-impact: confirm the list before calling.

Inputs: content (required), recipients (required), sender_id.

send_bulk_whatsappSend bulk WhatsApp messagesA

Send the same WhatsApp message to many recipients (max 500) from a connected session. High-impact: this contacts many people. Confirm the recipient list before calling.

Inputs: content (required), recipients (required), session_id (required), type.

send_emailSend emailB

Send a single transactional email. Provide html or text (or a template_id with variables).

Inputs: to (required), subject (required), from, html, +4 more.

send_otpSend OTP codeC

Send a one-time password (OTP) to a recipient over SMS, WhatsApp, or email.

Inputs: to (required), ttl, length, channel.

send_smsSend SMSA

Send a single SMS message to a phone number.

Inputs: to (required), content (required), sender_id.

send_whatsappSend WhatsApp messageA

Send a WhatsApp message from a connected session to one recipient. Requires a session_id of an already-paired WhatsApp number (see list_whatsapp_sessions).

Inputs: to (required), content (required), session_id (required), type.

validate_phoneValidate phone numberA
Read-only

Validate and look up details (format, country, carrier) for a phone number.

Inputs: number (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 18 tools

    Disambiguation5/5

    Each tool targets a distinct action on a specific channel (email, SMS, WhatsApp, OTP, phone validation, or usage). There is no ambiguity between single and bulk send tools, and check_otp is clearly separate from send_otp.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case, e.g., send_email, get_sms_status, list_whatsapp_sessions, validate_phone. No mixing of styles or vague verbs.

    Tool Count5/5

    With 18 tools covering email, SMS, WhatsApp, OTP, phone validation, and usage, the count is well-scoped for a messaging API server. Each tool serves a clear purpose without unnecessary duplication.

    Completeness5/5

    The tool surface covers all core messaging operations: sending (single and bulk), status retrieval, OTP lifecycle, listing of resources (domains, templates, sender IDs, sessions), usage monitoring, and phone validation. No obvious gaps for the intended domain.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants and agents to send WhatsApp, SMS, and email messages, verify OTP codes, and run campaigns through an account-based messaging platform.
      4
      17
      59 npm
      1
      MIT