Butt-Dial MCP

Give your AI agents a phone number. Calls, SMS, email, and WhatsApp — one MCP server, all channels.

Butt-Dial is an open-source MCP server that gives AI agents full communication abilities. Your agent connects via SSE, discovers tools, and starts making calls and sending messages. The server handles all the plumbing — Twilio, Resend, TTS — so your agent just talks.

Key Features

• Phone Calls — Real-time AI voice conversations with ConversationRelay
• SMS — Two-way text messaging
• Email — Transactional and conversational, with HTML and attachments
• WhatsApp — Rich messaging via WhatsApp Business
• LINE — LINE Official Account messaging
• Channel Blocking — Per-channel kill switch without deprovisioning
• Dead Letter Queue — Failed messages stored and dispatched on reconnect
• Pluggable Providers — Swap Twilio for Vonage, ElevenLabs for OpenAI TTS, etc.
• Multi-Tenant — Per-agent billing, rate limiting, and compliance
• Self-Hosted — Your data, your servers. Deploy anywhere.

Quick Start

git clone https://github.com/elrad/butt-dial-mcp.git
cd butt-dial-mcp
npm install
cp .env.example .env
npm run build
node dist/index.js

Then open http://localhost:3100/admin/setup to configure your providers.

Demo Mode

Set DEMO_MODE=true in .env to run with mock providers. No real API calls, no costs. All tools work with simulated responses — perfect for development and testing.

Connect Your AI Agent

GET http://localhost:3100/sse?token=<agent-token>

Any MCP-compatible client works: Claude Desktop, Cursor, or custom orchestrators.