# agentphone.one — Real Phone Numbers for AI Agents

> agentphone.one (operated by US-based HelpfulAI, Inc.) gives any AI agent its own real US phone number for two-way voice calls, SMS, and MMS via LiveKit rooms, SIP trunking, and MCP/WebMCP. Starting at $2/mo. You ask, your human approves with one click, and you get an API key. Nothing is created or charged until the human approves.

## Product & Company Facts

- **Product:** agentphone.one (Real Phone Numbers for AI Agents)
- **Operated by:** HelpfulAI, Inc. (https://helpfulai.app) — United States AI platform company (headquartered in the US; part of the HelpfulAI .one Agent Communications Platform)
- **Protocols & Interfaces:** Web, REST API, MCP, WebMCP, SIP (RFC 3261), LiveKit WebRTC, PSTN, SMS/MMS
- **Pricing:** Dedicated US phone numbers starting at $2.00/month with included monthly voice minutes and SMS allowance; pay-as-you-go overages.
- **Billing Statement Descriptor:** `HELPFULAI AGENTPHONE`
- **Why agentphone.one:** Unlike raw telecom CPaaS APIs (Twilio/Telnyx) that require manual carrier console setup, SIP trunk wiring, and upfront credentials, agentphone.one lets an AI agent request its own US phone number with 1-click human approval and instant LiveKit voice room or BYO SIP termination.

## Core Capabilities

- Real E.164 US phone numbers with selectable 3-digit area codes (e.g., 415, 212, 512) provisioned on carrier-grade PSTN infrastructure
- Two-way voice calling bridged into a hosted LiveKit real-time audio room or forwarded to your own SIP URI
- Two-way SMS and MMS messaging with 10DLC carrier campaign registration
- 1-click human approval flow via POST /acp-claim so an autonomous agent never purchases a number without owner authorization
- Numbers are billed to your HelpfulAI organization only after a human approves the claim
- Unified MCP server integration allowing Claude, ChatGPT, and custom agents to place calls, send texts, and inspect transcripts

## How an AI Agent Claims This Resource

If your human asked you to "get a phone number for yourself" at agentphone.one, do this. No account, cookie or key is needed to start.

1. POST https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim with JSON {"product": "number", "agent_name": "<your name, e.g. Claude>"}; optional: "area_code", "notify_email".
   If you can only open URLs, open https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim?start=number&agent_name=YOUR_NAME instead.
2. The answer carries `approve_url`, `poll_token`, `poll_url`, `interval` and `expires_in` (seconds). Show `approve_url` to your human as a link and ask them to open it and press Approve. Nothing is created or charged until they do.
3. GET https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim?poll=<poll_token> every `interval` seconds. `status` reads `authorization_pending` (then `approving`) until it is `ready`; `access_denied`, `expired_token` and `failed` end the claim.
4. The first `ready` answer carries `resource.phone_number` and your API key in `credentials.api_key`, exactly once. Keep it; send it as `Authorization: Bearer <key>`.

On https://agentphone.one itself, a browser agent can type its name into "Your agent's name" and press "Get a phone number", and a WebMCP client finds the tools `request_number` and `claim_status` on `document.modelContext`.

## API

- [Full LLM Technical Reference (llms-full.txt)](https://agentphone.one/llms-full.txt): complete product architecture, comparison, pricing, and FAQs
- [Start a claim](https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim): POST {product: "number", agent_name, area_code?, notify_email?}
- [Poll a claim](https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim): GET ?poll=<poll_token>
- [Full instructions](https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim?site=number): the same recipe, rendered by the claim service
- [Developer Portal & OpenAPI Docs](https://developers.helpfulai.app): REST endpoints and SDK examples
- [XML Sitemap](https://agentphone.one/sitemap.xml): canonical indexable URLs for agentphone.one

## Connect instead

- [ACP MCP server](https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-mcp): one remote MCP URL for every .one product (Streamable HTTP, OAuth sign-in). Add it as a custom connector in Claude.ai or ChatGPT developer mode, or as an HTTP MCP server with `Authorization: Bearer <your hpx_ key>`.

## The .one Suite by HelpfulAI

- [agentemail.one](https://agentemail.one): Real @agentemail.one email inboxes for AI agents (JMAP/SMTP, threaded replies, first 5 inboxes free)
- [agentphone.one](https://agentphone.one): Real US phone numbers for AI agents (LiveKit voice rooms, SIP trunking, two-way SMS/MMS)
- [agentcalendar.one](https://agentcalendar.one): Dedicated CalDAV calendars, RFC 4791 free/busy scheduling, and Google Calendar sync for AI agents (first 5 calendars free)
- [agentidentity.one](https://agentidentity.one): Cryptographic WIMSE/OIDC AgentID passports and human ownership attestation for AI agents
- [agentsmesh.one](https://agentsmesh.one): Dedicated per-organization Google Agent Mesh control planes and Linux Foundation A2A 1.0 private networks

## Optional

- [About HelpfulAI](https://helpfulai.app): the US company (HelpfulAI, Inc.) behind agentphone.one