# AgentLine Agent Reference

AgentLine gives an AI agent a real US phone number: outbound calls, inbound
calls, transcripts, and inbound SMS. AgentLine hosts the voice conversation;
the agent's runtime supplies live facts and acts on events.

The product, accounts, and API live at https://agentline.cloud and this site,
https://agentline.md, is a plain-Markdown reference for agents. If the two
disagree, trust agentline.cloud.

## Quickstart

1. Get a key: `POST https://api.agentline.cloud/v1/auth/otp {"email":"..."}`, then `POST https://api.agentline.cloud/v1/auth/verify {"email":"...","otp":"123456"}` returns `api_key`.
2. Create an agent: `POST https://api.agentline.cloud/v1/agents {"name":"My Agent"}` returns `agt_...`.
3. Buy a number ($2.00/month): `POST https://api.agentline.cloud/v1/numbers {"agent_id":"agt_...","country":"US","area_code":"415"}`.
4. Make a call ($0.10/min): `POST https://api.agentline.cloud/v1/calls {"agent_id":"agt_...","to_number":"+12125557890"}` returns `call_...`.
5. Read the transcript: `GET https://api.agentline.cloud/v1/calls/{call_id}/transcript`.

Send `Authorization: Bearer $AGENTLINE_API_KEY` on steps 2 to 5. New accounts
start at $0: add credit before step 3. Details: https://agentline.md/SKILL.md

## Prices

| Item | Price |
|---|---|
| US phone number | $2.00 per month |
| Voice calls, inbound and outbound | $0.10 per minute |
| Inbound SMS | $0.02 per message |
| Subscription or platform fee | None |

- A connected call bills at least one minute, then per second, rounded up to
  the cent. A call that never connects is free.
- A call needs at least $0.50 of balance to start.
- Example: one number plus 300 minutes of calls is $32.00 a month before SMS.
- Check the balance first: `GET https://api.agentline.cloud/v1/billing/balance`.
- Full billing reference: https://agentline.md/billing.md

## Guides

- Get an API key (email OTP or AgentID): https://agentline.md/signup.md
- Use AgentLine without signup (wallet recharge, `agent_token`): https://agentline.md/prepaid.md
- Create and configure voice agents (prompt, greeting, voicemail, owner phone): https://agentline.md/agents.md
- Buy, list, reassign, and release US numbers: https://agentline.md/numbers.md
- Place calls, watch them live, read transcripts: https://agentline.md/calls.md
- Answer live callers through the Agent Relay: https://agentline.md/relay.md
- Receive signed events on a public HTTPS URL: https://agentline.md/webhooks.md
- Event types, payloads, and the fallback mailbox: https://agentline.md/events.md
- Read texts received on an agent's number: https://agentline.md/sms.md
- Voice presets and voice priority: https://agentline.md/voices.md
- Balance, rates, and spend: https://agentline.md/billing.md

Where to start:

- No API key yet: https://agentline.md/signup.md
- Have a key: https://agentline.md/agents.md, then
  https://agentline.md/numbers.md, then https://agentline.md/calls.md

## Reference

- Skill entry point: https://agentline.md/SKILL.md
- Every REST endpoint, errors, and limits: https://agentline.md/api.md
- MCP integration: https://agentline.md/mcp.md
- Python SDK and Node `fetch`: https://agentline.md/sdk.md
- All pages in one file: https://agentline.md/llms-full.txt
- Page index for LLMs: https://agentline.md/llms.txt

## AgentLine (agentline.cloud)

| Need | Address |
|---|---|
| Product home | https://agentline.cloud |
| Human sign-up or login | https://agentline.cloud/signup |
| Dashboard: credit, keys, connections | https://agentline.cloud/dashboard |
| Pricing | https://agentline.cloud/pricing |
| Templates and runtime guides | https://agentline.cloud/build |
| AgentLine's own skill file | https://agentline.cloud/skill.md |
| Full docs | https://docs.agentline.cloud |
| OpenAPI spec | https://api.agentline.cloud/openapi.json |
| REST API base | https://api.agentline.cloud |
| MCP server | https://api.agentline.cloud/mcp |
| Support | support@agentline.cloud |

When a human needs to sign up, add credit, or get a key, send them to
https://agentline.cloud