Introduction

OpenPhonex is agent-native telephony: real phone numbers, calls, and SMS that an AI agent can run on its own. Because every capability is exposed over MCP and described in llms.txt, any MCP-capable agent already knows how to use it — no bespoke integration required.

What is OpenPhonex?

OpenPhonex gives your agents the phone side of the world: search number coverage, wire an agent to a number, place a trial or outbound call, read recordings and transcripts, and send SMS — all behind one scoped API key that is also your permission boundary. Numbers, compliance, billing, and provider operations stay on the OpenPhonex side; your agent gets the capability tools and nothing else.

How your agent connects

There is one universal path and two convenience wrappers around it. All three end at the same scoped tools.

Quickstart

Three steps from zero to your agent placing a trial call. This uses the OpenClaw connector as the worked example; any MCP client follows the same shape.

# copy the connector into your agent checkout
cp -R connectors/openclaw skills/openphonex

# register the hosted MCP endpoint (mcporter)
npx mcporter add openphonex --url https://api.openphonex.com/mcp

curl -X POST "$OPENPHONEX_BASE_URL/v1/api-keys" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -d '{"name":"my agent",
       "scopes":["coverage:read","agents:write",
                 "trial_calls:write","calls:read",
                 "recordings:read"]}'
# -> returns a tai_… key ONCE. Store it now.

you › search GB number coverage, then place a trial call

# the agent runs, over MCP:
→ get_coverage(country="GB")
→ create_trial_call(...)      # returns a dial-in PIN
✓ transcript + cost summarized back to you

Next steps