AgentLine
Telephony Services for AI agents
Documentation
AgentLine
AgentLinev1.12
Back to website
Introduction
Welcome to AgentLine — the voice and messaging infrastructure purpose-built for AI agents.
Traditional telephony APIs make you wire up call routing, manage audio streams, and stitch together speech-to-text and text-to-text services yourself. AgentLine runs the entire voice conversation for you and hands you back a clean transcript over plain HTTP — no servers or audio handling on your side (a webhook is optional, purely for event delivery).
Fully hosted conversations: You never run a server or decode audio. Create an agent, attach a real US phone number, trigger a call (or receive one), then get the transcript via a webhook or the Events Mailbox. Agents and humans use the exact same REST API.
Base URL: All API requests go tohttps://api.agentline.cloud
Two ways to use AgentLine
| Interface | Best for | How |
|---|---|---|
| REST API | Scripts, backends, humans, any HTTP client | curl / fetch with Authorization: Bearer $AGENTLINE_API_KEY |
| MCP Server | AI agents (Claude Desktop, Cursor, OpenClaw) | Connect to /mcp — 23 telephony tools exposed natively |
| Skill File | Claude Code, Hermes, any agent with a system prompt | Paste the SKILL.md URL — the agent learns the whole API |
Quickstart Flow
1
Get an API key
Email-OTP flow (POST /v1/auth/otp → /v1/auth/verify). New accounts get a $2.50 bonus. Key starts with sk_live_.
2
Create an agent
POST /v1/agents — set name, system_prompt, initial_greeting, voice, and optional voicemail_message / owner_phone.
3
Buy a US number
POST /v1/numbers — $2.00 one-time, attach to the agent. One active number per agent.
4
Call / receive
POST /v1/calls to dial out, or let callers ring the number. Poll GET /v1/events for transcripts.
Before you call: Calls require a minimum balance of $0.50 (≈5 minutes). Check with GET /v1/billing/balance. Inbound calls are rejected if balance drops below $0.10.
Next How Calls Work
ON THIS PAGE
Two ways to use AgentLineQuickstart Flow