AgentLine MCP server
Commit Oct 21, 2026Provides an open-source telephony API that enables AI agents to make and receive phone calls, send SMS, and navigate IVR menus via MCP or REST.
Also known as AgentLineHQ/AgentLine
- Stars
- 62
- Tools
- 14
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 21, 2026
- License
- MIT
What is AgentLine MCP?
AgentLine provides an open-source telephony API that enables AI agents to make and receive phone calls, send SMS, and navigate IVR menus via MCP or REST. It exposes 14 tools, such as create_agent, list_agents, update_agent.
Summary generated from the project's README
About AgentLine MCP server
Giving AI agents the ability to communicate over the phone is what AgentLine enables for developers building voice-enabled applications. This open-source platform provides a telephony API that allows LLMs to make and receive PSTN calls, send SMS, and navigate complex IVR menus using DTMF touch-tone audio. It functions as a complete voice pipeline by integrating speech-to-text, large language models, and text-to-speech into a single workflow.
Users can deploy the server locally using Docker or connect to a hosted version via an API key. It is designed to work natively with MCP-compatible clients like Claude Desktop, Cursor, and Claude Code, allowing these tools to trigger phone calls or manage agents directly. The system supports multiple telephony providers including SignalWire, Twilio, Plivo, and Telnyx, and offers pluggable voice runtimes such as LiveKit or Pipecat to customize how conversations are handled.
What you can do with it
- 1Automated AI ReceptionistConfigure an agent to answer incoming calls with a specific greeting and system prompt.
- 2Automated IVR NavigationInstruct an AI agent to navigate through automated phone menus by pressing specific keys.
- 3Direct Telephony via MCPUse natural language in coding environments to initiate phone calls.
- 4Voice-Based Task ManagementCall a registered number to provide verbal instructions that the agent executes after the call ends.
Written from the project's README. Every use case is checked against a quote from it.
AgentLine MCP tools 14
Detected from the READMEcreate_agentlist_agentsupdate_agentmake_outbound_calllist_callsget_call_transcripthangup_callpush_call_contextset_webhookbuy_phone_numberlist_phone_numberspoll_events
Show all 14 toolsShow fewer tools
peek_eventslist_available_voices
Automated checks
Ran Nov 13, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableagentlinehq/agentline is public and reachablegithub.com/agentlinehq/agentline ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-21github.com/agentlinehq/agentline ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model14 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubWebsite · Docs · Changelog · Skill File · Discord
What is AgentLine?
AgentLine is an open-source AI phone agent / voice agent telephony API. It gives coding agents and LLM apps a real US phone number, a voice pipeline (STT + LLM + TTS), and the ability to place outbound calls, answer inbound calls, handle SMS, and walk IVR / DTMF menus — over REST or MCP.
Use it as a self-hosted alternative to stitching Twilio Programmable Voice + Deepgram + a voice LLM yourself, or as an open-source counterpart to hosted voice-agent products (Vapi, Retell, Bland).
Your AI Agent (Claude, Cursor, OpenClaw, Hermes, Codex)
→ AgentLine REST / MCP
→ Real PSTN phone calls, SMS, transcripts
Works with Claude Code, Claude Desktop, Cursor, OpenClaw, Hermes, Codex, and any MCP or HTTP client.
Why AgentLine?
| AgentLine | Twilio / Vonage | Vapi / Retell | |
|---|---|---|---|
| Built for AI agents | ✅ Phone number + voice pipeline | ❌ Call-center APIs, BYO AI | ✅ Hosted voice agents |
| MCP + skill file | ✅ Native | ❌ None | ❌ Rare |
| Self-host / MIT | ✅ Your keys, your data | ❌ Proprietary | ❌ Proprietary SaaS |
| Setup | Minutes | Hours of stitching | Minutes, vendor lock-in |
| Outbound + inbound + SMS | ✅ | ✅ | Varies |
Use cases
- AI receptionist — answer inbound calls with a custom greeting and system prompt
- Outbound voice agent — reminders, follow-ups, feedback, and business inquiries
- MCP telephony — “call this number” from Claude Code, Cursor, or OpenClaw
- IVR navigation — press real DTMF keys on phone menus and leave voicemail
- Owner task line — call your agent from a registered number and give it work to run after hangup
Features
- 📞 Voice Calls — Make and receive real phone calls through a simple API
- 🎙️ AI Voice Pipeline — Built-in STT (Deepgram) + LLM (GPT-4o) + TTS (Cartesia) pipeline
- 🎛️ DTMF / IVR — Real touch-tone audio so outbound agents can navigate phone menus and leave voicemail
- ⚡ Semantic turn-taking — Adaptive end-of-turn detection with fast barge-in instead of a fixed pause
- 👤 Owner task mode — Calls from a registered owner number capture instructions for later execution
- 💬 SMS — Receive and read inbound text messages
- 🔌 MCP Server — Native Model Context Protocol tools for Claude Desktop, Claude Code, Cursor, OpenClaw, and Codex
- 📋 Skill File — One-file install for Claude Code, Cursor, OpenClaw, Hermes, and similar runtimes
- 🌍 Pluggable carriers — SignalWire, Twilio, Plivo, Telnyx, or your own class, side by side with per-country routing and failover
- 🎙️ Pluggable voice runtimes — built-in pipeline, LiveKit, Pipecat, or your own
- 📝 Transcripts — Automatic call transcription with full conversation history
- 🔄 Persistent Agent Relay — outbound WebSocket with reconnect, ACK/replay, turn-safe context, and runtime-aware setup
- 🪝 Per-agent webhooks — Signed JSON POSTs as a fallback when a relay cannot run
- 📬 Event Mailbox — durable fallback for agents without a relay or webhook
- 🐳 Docker Ready — One command to run the API, Postgres, and Redis locally
Architecture
graph LR
A["🤖 AI Agent"] -->|REST API / MCP| B["⚡ AgentLine API"]
B -->|Telephony hook| C["📱 SignalWire, Twilio, Plivo, Telnyx, or yours"]
B -->|Voice runtime hook| H["🎙️ Built-in, LiveKit, or Pipecat"]
H -->|Built-in only| D["🎤 STT hook"]
H -->|Built-in only| E["🔊 TTS hook"]
H -->|Built-in only| F["🧠 LLM hook"]
C -->|Voice and SMS| G["📞 PSTN"]
B -->|Events and transcripts| A
Voice runtimes
VOICE_RUNTIME picks who holds the conversation. An agent can override it with voice_runtime.
| Runtime | What it does |
|---|---|
builtin |
This process runs Deepgram, an OpenAI-compatible LLM, and Cartesia on the carrier media websocket |
livekit |
Creates a LiveKit room, dispatches your agent, and either dials LiveKit SIP or bridges the carrier audio |
pipecat |
Runs a Pipecat bot on the carrier websocket. Bring your own with PIPECAT_FACTORY |
module:Class |
Your runtime. Implement prepare and run |
The built-in path is:
Caller audio → Deepgram STT → semantic turn-taking
→ OpenAI-compatible LLM (or live relay context) → Cartesia TTS → caller
Carriers, runtimes, and the registration API are in docs/providers.md. A copy-paste example is in examples/hooks.py.
- Semantic turn-taking waits longer when the caller is mid-thought and answers immediately on a complete question.
- Barge-in flushes playback as soon as the caller starts speaking.
- DTMF turns
[DTMF:1]markers into real touch-tone audio for IVR menus. - Relay mode (optional) pushes each caller turn to a local agent over an outbound WebSocket and speaks the returned context verbatim.
Quick Start
Option 1: Docker Compose (Recommended)
git clone https://github.com/agentlineHQ/AgentLine.git
cd AgentLine
cp .env.example .env
# Fill in your API keys in .env (see Configuration below)
docker-compose up -d
This starts:
- API server at
http://localhost:8000 - PostgreSQL at
localhost:5432(schema auto-applied) - Redis at
localhost:6379
Option 2: Local Development
git clone https://github.com/agentlineHQ/AgentLine.git
cd AgentLine
python -m venv venv
source venv/bin/activate # or venv\Scripts\activate on Windows
pip install -r requirements.txt
cp .env.example .env
# Fill in your API keys
uvicorn agentline.main:app --reload
Option 3: Use the Hosted Version
Skip self-hosting — sign up at agentline.cloud and get an API key instantly.
Configuration
Copy .env.example to .env and fill in your credentials:
| Variable | Required | Description |
|---|---|---|
DATABASE_URL |
Yes | PostgreSQL connection string. Docker Compose fills this in |
TELEPHONY_PROVIDER |
No | signalwire (default), twilio, plivo, telnyx, or module:Class |
TELEPHONY_PROVIDERS |
No | Extra carriers to run at the same time, comma separated. Empty enables every built-in with credentials |
TELEPHONY_ROUTES |
No | Carrier per country / number type for new numbers, e.g. US=twilio|signalwire,GB=plivo,*=signalwire |
TELEPHONY_FAILOVER |
No | true (default) tries the next carrier when buying a number fails |
VOICE_RUNTIME |
No | builtin (default), livekit, pipecat, or module:Class |
SIGNALWIRE_PROJECT_ID |
For SignalWire | SignalWire project ID |
SIGNALWIRE_TOKEN |
For SignalWire | SignalWire API token |
SIGNALWIRE_SPACE_URL |
For SignalWire | Space hostname, such as example.signalwire.com |
TWILIO_ACCOUNT_SID |
For Twilio | Twilio account SID |
TWILIO_AUTH_TOKEN |
For Twilio | Twilio auth token |
PLIVO_AUTH_ID |
For Plivo | Plivo auth id |
PLIVO_AUTH_TOKEN |
For Plivo | Plivo auth token |
TELNYX_API_KEY |
For Telnyx | Telnyx API key |
TELNYX_ACCOUNT_SID |
For Telnyx | TeXML application id |
DEEPGRAM_API_KEY |
For the built-in pipeline | Deepgram API key |
CARTESIA_API_KEY |
For the built-in pipeline | Cartesia API key |
OPENAI_API_KEY |
For the built-in pipeline | OpenAI-compatible API key |
OPENAI_BASE_URL |
No | Defaults to https://api.openai.com/v1 |
TURN_TAKING_MODEL |
No | Fast OpenAI-compatible model for end-of-turn detection |
LIVEKIT_URL |
For LiveKit | LiveKit server URL |
LIVEKIT_API_KEY |
For LiveKit | LiveKit API key |
LIVEKIT_API_SECRET |
For LiveKit | LiveKit API secret |
LIVEKIT_SIP_URI |
No | When set, the carrier dials LiveKit SIP. Supports {room} and {call_id} |
PIPECAT_FACTORY |
No | module:function that replaces the default Pipecat bot |
REDIS_URL |
No | Redis URL (defaults to localhost:6379) |
SECRET_KEY |
Yes | App secret key |
BASE_URL |
Yes | Public URL of your deployment |
LiveKit's in-process audio bridge needs pip install -r requirements-livekit.txt. The default Pipecat bot needs pip install -r requirements-pipecat.txt. SIP mode for LiveKit does not need the LiveKit Python package.
API Reference
Once running, visit http://localhost:8000/docs for the interactive Swagger UI.
Core Endpoints
| Method | Path | Description |
|---|---|---|
POST |
/v1/agents |
Create a new AI voice agent |
GET |
/v1/agents |
List all agents |
PATCH |
/v1/agents/{id} |
Update agent (prompt, voice, greeting) |
POST |
/v1/numbers |
Provision a phone number |
GET |
/v1/numbers |
List phone numbers |
POST |
/v1/calls |
Make an outbound call |
GET |
/v1/calls |
List calls |
GET |
/v1/calls/{id}/transcript |
Get call transcript |
POST |
/v1/calls/{id}/hangup |
End an active call |
POST |
/v1/calls/{id}/context |
Push live relay context for a caller turn |
GET |
/.well-known/agentline.json |
Discover relay, webhook, and runtime setup |
GET |
/v1/events |
Poll event mailbox (fallback) |
WS |
/v1/events/ws |
Persistent outbound agent relay |
GET |
/v1/events/peek |
Peek at events (non-destructive) |
GET/POST/DELETE |
/v1/webhooks |
Configure a per-agent signed webhook |
GET |
/v1/messages |
List SMS messages |
GET |
/debug/urls |
Active carrier, voice runtime, and callback URLs |
Authentication
All requests require an API key (al_live_...; legacy sk_live_... keys are still accepted):
curl -H "Authorization: Bearer al_live_YOUR_KEY" \
-H "Content-Type: application/json" \
http://localhost:8000/v1/agents
MCP Server Integration
AgentLine includes a built-in MCP (Model Context Protocol) server, so AI agents like Claude Desktop and Cursor can use telephony tools natively.
Connect from Claude Desktop
Add to your Claude Desktop config:
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"agentline": {
"command": "npx",
"args": [
"-y", "mcp-remote@latest",
"http://localhost:8000/mcp",
"--header", "Authorization: Bearer al_live_YOUR_KEY"
]
}
}
}
Available MCP Tools
| Tool | Description |
|---|---|
create_agent |
Create a new AI voice agent |
list_agents |
List all agents |
update_agent |
Update agent config/prompt/voice |
make_outbound_call |
Initiate an outbound phone call |
list_calls |
List call history |
get_call_transcript |
Get the full transcript of a call |
hangup_call |
End an active call |
push_call_context |
Push live relay context for a caller turn |
set_webhook |
Create or replace a per-agent webhook |
buy_phone_number |
Provision a new phone number |
list_phone_numbers |
List all phone numbers |
poll_events |
Poll event mailbox |
peek_events |
Peek at pending events |
list_available_voices |
List voice presets |
Test with MCP Inspector
npx @modelcontextprotocol/inspector http://localhost:8000/mcp
Skill File — Install in 30 Seconds
AgentLine ships with a skill file that lets any AI agent gain telephony powers instantly:
https://agentline.cloud/skill.md
How to use:
- Copy the skill URL above
- Add it to your AI agent (Claude Code, Cursor, OpenClaw, etc.)
- Set your
AGENTLINE_API_KEYenvironment variable - Tell your agent: "Call +1234567890" — it just works!
The skill file is also included in this repo at skills/agentline/SKILL.md.
Tech Stack
| Component | Technology |
|---|---|
| API Framework | FastAPI (async Python) |
| Database | PostgreSQL |
| Cache | Redis |
| Phone numbers and calls | SignalWire, Twilio, Plivo, Telnyx, or your class |
| Voice runtime | Built-in pipeline, LiveKit, or Pipecat |
| Default speech-to-text | Deepgram Nova-2, replaceable |
| Default text-to-speech | Cartesia Sonic, replaceable |
| Default LLM | Any OpenAI-compatible API |
| MCP Server | FastAPI-MCP |
| Deployment | Docker, Railway |
Deployment
Docker
docker build -t agentline .
docker run -p 8000:8000 --env-file .env agentline
Any Cloud Provider
AgentLine runs anywhere that supports Python 3.12+ and Docker: AWS, GCP, Azure, Fly.io, Render, Railway, etc.
Database Schema
The database schema is in schema.sql. It creates tables for:
- accounts — API accounts
- api_keys — Hashed API keys for authentication
- agents — AI voice agent configurations, including an optional
voice_runtime - phone_numbers — Provisioned phone numbers and which carrier owns them
- calls — Call records with transcripts
- messages — SMS message records
- event_mailbox — Server-side event queue
Migrations are in the migrations/ directory.
Cost
This repository does not bill anyone. You pay the carrier, speech vendor, model host, LiveKit, or Pipecat deployment you configure.
Contributing
We welcome contributions! See CONTRIBUTING.md for guidelines.
- 🐛 Bug reports — Open an issue
- 💡 Feature requests — Open an issue
- 🔧 Pull requests — Fork, branch, PR
Community
- 💬 Discord — Chat with the team and other builders
- 🐦 Twitter — Updates and announcements
- 📖 Docs — Full API documentation
- 📝 Blog — Guides and tutorials
License
MIT — use it for anything. Commercial use welcome.
AgentLine MCP questions
What tools does AgentLine MCP provide?
It exposes 14 tools, including create_agent, list_agents, update_agent, make_outbound_call, list_calls.
What can AgentLine do with phone calls?
It allows AI agents to make and receive real PSTN calls, navigate phone menus using DTMF, and read call transcripts.