AgentLine

AgentLineHQ56stars

Open-source AI phone API for voice agents. Give Claude, Cursor, OpenClaw, or any LLM a real phone number — outbound/inbound calls, SMS, transcripts, MCP, DTMF/IVR. FastAPI + SignalWire + Deepgram. Sel

Telephony Voice Agents

Install Run on PlugMCP

GitHub Website

Run on PlugMCP

1# AgentLine

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-10-27

Stars: 56
Tools: —
Uptime: —

Overview

About AgentLine

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install AgentLine?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does AgentLine need an API key?

No required environment variable is listed on this record.

What transport does AgentLine use?

AgentLine runs locally over stdio.

When was AgentLine last checked?

Last checked 2026-10-27. Open-source AI phone API for voice agents. Give Claude, Cursor, OpenClaw, or any LLM a real phone number — outbound/inbound calls, SMS, transcripts, MCP, DTMF/IVR. FastAPI + SignalWire + Deepgram. Self-hostable alternative to Twilio, Vapi, and Retell.

From the publisher

Documentation

Website · 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_KEY environment 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

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

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

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

Variable

Required

Description

DATABASE_URL

Yes

PostgreSQL connection string. Docker Compose fills this in

TELEPHONY_PROVIDER

signalwire (default), twilio, plivo, telnyx, or module:Class

TELEPHONY_PROVIDERS

Extra carriers to run at the same time, comma separated. Empty enables every built-in with credentials

TELEPHONY_ROUTES

Carrier per country / number type for new numbers, e.g. US=twilio|signalwire,GB=plivo,*=signalwire

TELEPHONY_FAILOVER

true (default) tries the next carrier when buying a number fails

VOICE_RUNTIME

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

Defaults to https://api.openai.com/v1

TURN_TAKING_MODEL

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

When set, the carrier dials LiveKit SIP. Supports {room} and {call_id}

PIPECAT_FACTORY

module:function that replaces the default Pipecat bot

REDIS_URL

Redis URL (defaults to localhost:6379)

SECRET_KEY

Yes

App secret key

BASE_URL

Yes

Public URL of your deployment

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

{ "mcpServers": { "agentline": { "command": "npx", "args": [ "-y", "mcp-remote@latest", "http://localhost:8000/mcp", "--header", "Authorization: Bearer al_live_YOUR_KEY" ] } } }

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

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