addai-sms-mcp

MCP server for AddAi SMS — set up SMS for a workspace, craft templates with live segment math, and send real test texts through the workspace's Twilio number.

The SMS sibling of addai-emails-mcp. Same API keys (em_live_*): the sms-api edge function validates with the same email_api_key_validate RPC, so one key powers both channels.

Quick start

npx addai-sms-mcp --setup

Or manually in .mcp.json:

{
  "mcpServers": {
    "addai-sms": {
      "command": "npx",
      "args": ["-y", "addai-sms-mcp"],
      "env": { "ADDAI_SMS_API_KEY": "em_live_xxxx" }
    }
  }
}

ADDAI_EMAILS_API_KEY also works as a fallback env var — genuinely the same keys.

Tools

| Area | Tools | |---|---| | Setup | get_sms_setup, connect_twilio (verifies against Twilio before saving), preview_segments | | Sending | send_test_sms ([TEST]-prefixed), send_sms (REAL send, requires confirm: true, logged), send_template_test | | Templates | list_templates, get_template, create_template, update_template, delete_template, duplicate_template, move_to_folder, send_template_test | | Organization | list_folders, create_folder, update_folder, delete_folder, list_categories, create_category, update_category, delete_category |

What "elite" means here

• Segment math is server-side truth. Every create/update/preview returns encoding (GSM-7 vs UCS-2), character count, segment count, and — crucially — which characters forced UCS-2 (smart quotes, em-dashes, emoji). One bad apostrophe halves your character budget; this MCP catches it.
• {{variables}} are extracted automatically from content; test sends substitute provided values and surface any tokens you forgot.
• Twilio credentials are verified before they're stored — a bad SID/token pair is rejected with Twilio's own error, never saved.
• Test sends are honest tests: [TEST]-prefixed, capped at 5 recipients. Campaigns belong in the AddAi app.
• UK-first phone normalisation (07700... → +447700...), E.164 preferred.

Backend

supabase/functions/sms-api — a workspace-scoped REST API mirroring emails-api, backed by the existing sms_templates / sms_folders / sms_categories tables and the workspace integrations row (type: 'twilio') that the AddAi SMS app already uses.

Build

npm install
npm run build