Loading repository data…
AgentLineHQ / repository
Give your AI agent a real phone number. Open-source telephony API with voice calls, SMS, MCP server, and skill file. Built with FastAPI + SignalWire + Deepgram.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
Website · Docs · Skill File · Discord
AgentLine is an open-source AI-native telephony platform that gives AI agents real phone numbers and human-like voices. It provides a simple REST API and MCP server so AI agents (Claude, Cursor, custom LLM agents) can make and receive phone calls, handle SMS, and retrieve transcripts — without any telecom knowledge.
Your AI Agent → AgentLine API → Real Phone Calls
→ SMS Messages
→ Call Transcripts
| AgentLine | Twilio/Vonage | Build It Yourself | |
|---|---|---|---|
| Built for AI agents | ✅ Purpose-built | ❌ Built for call centers | ❌ You stitch it together |
| Setup time | 5 minutes | Hours | Weeks |
| MCP server | ✅ Native | ❌ None | ❌ Build your own |
| Skill file install | ✅ One file | ❌ Complex SDK | ❌ Hundreds of lines |
| Voice pipeline | ✅ Included (STT + TTS + LLM) | ❌ BYO | ❌ BYO |
| Open source | ✅ MIT | ❌ Proprietary | ✅ Your code |
graph LR
A["🤖 AI Agent"] -->|REST API / MCP| B["⚡ AgentLine API"]
B -->|Provision Numbers| C["📱 SignalWire"]
B -->|Speech-to-Text| D["🎤 Deepgram"]
B -->|Text-to-Speech| E["🔊 Cartesia"]
B -->|LLM Reasoning| F["🧠 OpenAI"]
C -->|Voice & SMS| G["📞 PSTN Network"]
B -->|Events & Transcripts| A
AgentLine uses an asynchronous Hybrid Relay architecture instead of fragile real-time WebSocket streams:
Caller dials your agent's number
→ SignalWire answers the call
→ Plays TTS greeting to caller
→ Records caller's speech
→ Deepgram transcribes (fast, accurate)
→ LLM generates agent response
→ Cartesia speaks the response
→ Loop continues until call ends
→ Full transcript stored for retrieval
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:
http://localhost:8000localhost:5432 (schema auto-applied)localhost:6379git 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
Skip self-hosting — sign up at agentline.cloud and get an API key instantly.
Copy .env.example to .env and fill in your credentials:
| Variable | Required | Description |
|---|---|---|
SUPABASE_URL | Yes | Your Supabase project URL |
SUPABASE_ANON_KEY | Yes | Supabase anonymous key |
SUPABASE_SERVICE_ROLE_KEY | Yes | Supabase service role key (server-side) |
DATABASE_URL | Yes | PostgreSQL connection string |
SIGNALWIRE_PROJECT_ID | Yes | SignalWire project ID |
SIGNALWIRE_TOKEN | Yes | SignalWire API token |
SIGNALWIRE_SPACE_URL | Yes | Your SignalWire space URL |
DEEPGRAM_API_KEY | Yes | Deepgram API key (STT) |
CARTESIA_API_KEY | Yes | Cartesia API key (TTS) |
OPENAI_API_KEY | Yes | OpenAI API key (LLM) |
REDIS_URL | No | Redis URL (defaults to localhost:6379) |
SECRET_KEY | Yes | App secret key |
BASE_URL | Yes | Public URL of your deployment |
Once running, visit http://localhost:8000/docs for the interactive Swagger UI.
| 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 |
GET | /v1/events | Poll event mailbox (consume) |
GET | /v1/events/peek | Peek at events (non-destructive) |
GET | /v1/messages | List SMS messages |
GET | /v1/billing/balance | Check account balance |
GET | /v1/billing/expenditure | Spending breakdown |
All requests require an API key:
curl -H "Authorization: Bearer sk_live_YOUR_KEY" \
-H "Content-Type: application/json" \
https://api.agentline.cloud/v1/agents
AgentLine includes a built-in MCP (Model Context Protocol) server, so AI agents like Claude Desktop and Cursor can use telephony tools natively.
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 sk_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 |
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 |
get_account_balance | Check account balance |
list_available_voices | List voice presets |
npx @modelcontextprotocol/inspector http://localhost:8000/mcp
AgentLine ships with a skill file that lets any AI agent gain telephony powers instantly:
https://agentline.cloud/skill.md
How to use:
AGENTLINE_API_KEY environment variableThe skill file is also included in this repo at skills/agentline/SKILL.md.
| Component | Technology |
|---|---|
| API Framework | FastAPI (async Python) |
| Database | PostgreSQL (Supabase) |
| Cache | Redis |
| Phone Numbers & Calls | SignalWire |
| Speech-to-Text | Deepgram Nova-2 |
| Text-to-Speech | Cartesia Sonic |
| LLM | OpenAI GPT-4o / GPT-4o-mini |
| MCP Server | FastAPI-MCP |
| Deployment | Docker, Railway |
docker build -t agentline .
docker run -p 8000:8000 --env-file .env agentline
AgentLine runs anywhere that supports Python 3.12+ and Docker: AWS, GCP, Azure, Fly.io, Render, Railway, etc.
The database schema is in schema.sql. It creates tables for:
Migrations are in the migrations/ directory.
If using the hosted version at agentline.cloud:
| Item | Cost |
|---|---|
| Voice calls (inbound/outbound) | $0.10/min (billed per second) |
| Phone number | $2.00 (one-time) |
| SMS (inbound) | Free |
Self-hosted: you pay only your provider costs (SignalWire, Deepgram, Cartesia, OpenAI).
We welcome contributions! See CONTRIBUTING.md for guidelines.
MIT — use it for anything. Commercial use welcome.
Selected from shared topics, language and repository description—not editorial ratings.
pensados /
Give AI agents controlled access to your server — not unrestricted shell. Command allowlist, structured editing, service management, file upload. Pairs with sentinelx-core-mcp for Claude and ChatGPT via MCP/OAuth. MIT license.
21/100 health