> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentline.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Phone Numbers, Voice & SMS API for AI Agents

> AgentLine is the AI-native telephony API — give any AI agent a real US phone number for outbound calls, inbound voice, and inbound SMS. Guides, SDKs (Python & Node), pricing, and interactive API reference.

# AgentLine

AgentLine is an AI-native telephony platform. Give your agent a real US phone
number and a human-like voice so it can make and receive calls and receive SMS.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get a number and make your first call in five minutes.
  </Card>

  <Card title="API Reference" icon="square-terminal" href="/api-reference">
    Every endpoint, with an interactive playground.
  </Card>

  <Card title="Python SDK" icon="https://mintcdn.com/agentline/GOqxI9WwS9tyC2CC/images/python.svg?fit=max&auto=format&n=GOqxI9WwS9tyC2CC&q=85&s=0d59971e91dda6b2f1c1420dbb680d5c" href="/sdk/python" width="24" height="24" data-path="images/python.svg">
    `pip install agentline-ai`
  </Card>

  <Card title="Node SDK" icon="https://mintcdn.com/agentline/GOqxI9WwS9tyC2CC/images/node.svg?fit=max&auto=format&n=GOqxI9WwS9tyC2CC&q=85&s=72eb75b74c7d46af9ce939b712b83858" href="/sdk/node" width="24" height="24" data-path="images/node.svg">
    Not on npm yet. Use REST.
  </Card>
</CardGroup>

## What you can build

* **AI phone agents** that answer and place real calls.
* **Outbound dialers** for sales, follow-ups, and reminders.
* **AI receptionists** that answer calls and can transfer the caller to the owner's phone.
* **Inbound SMS** that your agent can read from its number.

## How it works

```
1. Create an agent        POST /v1/agents
2. Buy a phone number     POST /v1/numbers
3. Make / receive calls   POST /v1/calls      (real-time transcription + TTS)
4. Get results            GET  /v1/calls/{id}/transcript  or  webhooks/events
```

Every request is authenticated with `Authorization: Bearer al_live_***`

## FAQ

**How do I get a phone number for my AI agent?**
Sign up at agentline.cloud, provision a US number, and install the AgentLine skill on your agent (OpenClaw, Hermes Agent, or any LLM) — usually under 5 minutes.

**Can my AI agent use one number for calls and SMS?**
The same US number handles outbound calls, inbound voice, and inbound SMS.

**Do I need Twilio or WebSockets?**
No. AgentLine's relay architecture handles call control, real-time transcription, and text-to-speech for you — your agent just responds with text.

**How much does AgentLine cost?**
US numbers are \$2.00/month per number. Voice calls are \$0.10/minute in both directions. A 0-second call is free. A connected call has a one-minute minimum, then the actual duration, rounded up to the cent. No monthly platform fees.

**How do agents connect over MCP?**
Point an MCP client at `https://api.agentline.cloud/mcp` with [`mcp-remote`](/guides/mcp) and a Bearer key.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.