Enables initiating VoIP phone calls, playing TTS messages, capturing DTMF input, and recording voice responses via an Asterisk PBX.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@asterisk-voice-mcp Call the office line and ask for feedback"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A self-hosted Model Context Protocol (MCP) server that lets an AI agent place VoIP phone calls via Asterisk, play TTS messages, capture DTMF input, and optionally record voice responses to be transcribed.
graph TD
Agent[AI Agent (Claude/Hermes)] -->|MCP over stdio| MCPServer[MCP Server (Python)]
MCPServer -->|ARI HTTP/WebSocket| Asterisk[Asterisk PBX (Docker)]
Asterisk -->|SIP/RTP| Softphone[Linphone Softphone]
MCPServer -->|TTS API / STT API| Speechmatics[Speechmatics API]Related MCP server: AgentPhone MCP Server
Place Calls: Initiate calls to a SIP endpoint.
TTS: Play dynamically generated speech.
DTMF Capture: Prompt the user for keypad input.
Voice Capture & STT: Record user audio and transcribe it via Speechmatics.
Tool integration: Fully compliant MCP server that exposes tools place_call, send_dtmf, hangup_call, health_check.
Docker & Docker Compose
Python 3.11+
Linphone app
Speechmatics API Key (optional, defaults to mock if absent)
Clone the repository (or navigate to directory).
Configure environment variables:
cp .env.example .env
# Edit .env and provide your SPEECHMATICS_API_KEY if desired.Start Asterisk:
docker compose up -dRegister Linphone:
SIP Server: your host IP or domain
Port: 5060 (UDP/TCP)
Username: linphone-user
Password: the value of SIP_PASSWORD from your .env (generated at deploy time; see setup.sh)
Start the MCP server to expose tools:
python src/mcp_server.pySee config/mcp.json for an example of how to configure an MCP client (like Claude Desktop) to use this server.
Run the self-test script, which spins up a mock PJSIP endpoint and runs an end-to-end call test using a local bot.
python scripts/self_test.pyNever expose ARI/SIP to the public internet without proper authentication, firewalls, and Fail2Ban.
Secrets should remain in .env.
Use strong endpoint secrets for SIP registrations.
Lock down RTP ports.
MIT License
This server cannot be deployed
Give AI agents a phone: outbound AI calls that return a summary, transcript, and extracted fields.
Give your AI a real phone: place calls, send SMS, fetch recordings and transcripts. Local or hosted.
Give your AI agent a phone: place calls, navigate IVRs, wait on hold, get structured answers.
Let AI agents place real phone calls from your verified number, with transcripts and recordings.
