vozo MCP
vozo exposes one organization-scoped MCP endpoint at <API_URL>/mcp. Use it from an operator assistant, a compatible voice-agent platform, or a self-hosted MCP client. The endpoint uses Streamable HTTP and bearer credentials created in Settings → Organization → MCP access.
Configure a client
{
"type": "http",
"url": "https://<your-api-host>/mcp",
"headers": {
"Authorization": "Bearer vozo_mcp_<credential>"
}
}Use the API origin for your vozo deployment. MCP credentials are shown once, expire within 90 days, and can be revoked by organization administrators. The API stores only a token hash and records the last-use time.
Tools
| Tool | Purpose | Inputs |
|---|---|---|
list_voice_agents | List agents in the connected vozo organization. | None |
list_external_voice_agents | List agents in a connected provider account. | provider: elevenlabs, vapi, or retell |
import_external_voice_agent | Create a vozo agent record from a connected provider configuration. | provider, agentId, optional name |
get_call_cost_summary | Summarize customer charges, provider costs, and available margin. | Optional inclusive from and to dates (YYYY-MM-DD) |
get_call_timing_report | Inspect turn timing and latency. | Optional dates and agentId |
get_phone_route_health | Summarize recent phone outcomes and stored number or SIP checks. | days from 1 to 30; defaults to 1 |
list_real_call_checks | List configured monitors and their latest saved status. | None |
list_call_regression_runs | List up to 50 recent run statuses and pass/fail counts. | None |
Date filters for cost and timing default to the last 30 days when omitted. Date ranges are inclusive.
Access and side effects
All results are limited to the organization attached to the credential. Read tools do not return transcripts or agent configurations unless stated. Provider costs are hidden if the credential creator cannot view them. The agent import tool is available only when the creator has agent-creation access.
import_external_voice_agent creates a vozo agent record. It does not publish that agent, modify the provider’s configuration, place calls, or start checks. All other current tools are read-only; in particular, list_real_call_checks reports configured checks and does not execute them.
Common failures
- 401 — credential is missing, malformed, expired, or revoked. Create a new credential and update the client.
- Provider list or import error — connect the provider in vozo settings and verify that the referenced agent is available to that account.
- No cost or call data — connect the relevant provider and ensure call events and usage data have been ingested. Importing a configuration alone does not import call history.
Credentials are limited to ten active tokens per organization. Revoke unused credentials promptly.