MCP overview
Native Model Context Protocol server for OpenPhn.
OpenPhn ships a first-party MCP server so any MCP-aware client (Claude Desktop, Cursor, Warp, Zed, your own agent) can place real phone calls as a tool.
Transport
- Hosted SSE —
https://mcp.openphn.com. Multi-tenant; each connection must sendAuthorization: Bearer sk_live_*. This is what you want. - Local stdio — run
mcp/server.pyfrom the repo withOPENPHN_API_KEYin env. Single-tenant; useful for local development or air-gapped agents.
Tools exposed
| Tool | Purpose |
|---|---|
make_call | Create an outbound call (same shape as POST /v1/calls). Returns {call_id, status}. |
get_call | Fetch a call by ID — status, outcome, transcript, cost. |
list_calls | Paginated recent calls, optionally filtered by status. |
list_numbers | Your inbound numbers, respecting any number_ids scoping on the API key. |
Managing flows and webhooks via MCP is not in today's tool set — use the REST API for those.
Auth model
The MCP server proxies to the same REST API you'd hit directly. Your
sk_live_* key's scopes and number_ids restriction apply verbatim. If
your key can't create calls via REST, it can't via MCP either.
Get started
- Claude Desktop quickstart — 2-minute setup.
- Tool reference — full parameter schemas.