# OpenPhonex

> Agent-native telephony: real phone numbers, calls, and SMS an AI agent runs on its own over MCP, described in llms.txt so any AI already knows how to use it.

## Docs

- [Authentication & keys](https://openphonex.com/docs/authentication): Scoped tai_ keys, Bearer auth, scope clamping and fail-closed semantics, org isolation, and rotate/revoke.
- [Deployment modes](https://openphonex.com/docs/deployment-modes): Fully managed cloud vs managed numbers with a self-hosted gateway — who provides the brain, and where the media runs.
- [Introduction](https://openphonex.com/docs): OpenPhonex is agent-native telephony — real phone numbers, calls, and SMS an AI agent runs on its own over MCP.
- [Install the connector](https://openphonex.com/docs/install-connector): The OpenClaw connector in detail — skill, stdio bridge, mcporter registration, the remote-MCP shortcut, and the offline smoke test.
- [llms-full.txt](https://openphonex.com/docs/llms-full): The whole docs + blog corpus as one plain-text file, cross-linked to the API surface.
- [llms.txt](https://openphonex.com/docs/llms): The site's llms.txt index — a titled map of every doc and blog page plus the API surface.
- [MCP overview](https://openphonex.com/docs/mcp): The hosted MCP endpoint — POST /mcp, tools/list schemas with required_scopes, and prefix scopes.
- [OpenAPI](https://openphonex.com/docs/openapi): The live, machine-readable OpenAPI spec for the OpenPhonex API.
- [Policy & outbound](https://openphonex.com/docs/policy-and-outbound): How policy-gated outbound works — evaluate first, authorize, then place. Blocked categories and the broker example.
- [Quickstart](https://openphonex.com/docs/quickstart): The five-minute path — install the OpenClaw connector, mint a scoped key, and have your agent place a trial call.
- [Read call evidence](https://openphonex.com/docs/read-call-evidence): Recordings, waveform peaks, transcript turns, summaries, and retention/disclosure state for every call.
- [REST endpoints](https://openphonex.com/docs/rest-endpoints): The key REST endpoints — agents, web/trial calls, numbers, calls, messages, and wallet/usage.
- [Scopes & permissions](https://openphonex.com/docs/scopes): The scope catalog, prefix scopes, and fail-closed semantics that make a key a permission boundary.
- [Send SMS](https://openphonex.com/docs/send-sms): Read SMS conversations and send policy-gated messages from your numbers.
- [Tool reference](https://openphonex.com/docs/tool-reference): Every OpenPhonex MCP tool with its required scope, generated from the server's TOOL_SCOPES.
- [Trial calls](https://openphonex.com/docs/trial-calls): Place a shared-number trial call to hear a connected agent end to end, with no number provisioning.
- [Webhooks](https://openphonex.com/docs/webhooks): Call-lifecycle and DIDWW SMS delivery callbacks — where your call and SMS events land.
- [Wire an agent to a number](https://openphonex.com/docs/wire-an-agent): Connect an external or hosted agent, set its voice stack, and answer real calls.

## Blog

- [OpenPhonex: agent-native telephony is live](https://openphonex.com/blog/launch): Real phone numbers, calls, and SMS an AI agent can run on its own — over MCP, described in llms.txt. Here is what shipped and how it deploys.
- [Your agent already knows how to use OpenPhonex](https://openphonex.com/blog/works-with-any-ai): The MCP + llms-full.txt thesis — why an agent-native telephony API needs no bespoke integration.

## API surface

- [OpenAPI spec](https://openphonex.com/control-plane/openapi.json): machine-readable API document.
- [API llms.txt](https://openphonex.com/control-plane/llms.txt): the API's own agent index.
- [MCP endpoint](https://openphonex.com/control-plane/mcp): POST /mcp — hosted Model Context Protocol.

## Full corpus

- [llms-full.txt](https://openphonex.com/llms-full.txt): every doc and blog page in one file.