MCP (AI agents) | Revox API

Revox exposes a generic MCP server that mirrors the full REST API as MCP tools. Use it to place calls, manage assistants, run campaigns, and more.

MCP server URL

Use the /mcp endpoint (streamable HTTP) with your favorite tools — e.g. OpenClaw, Cursor, Postman, or any MCP client.

MCP endpoint

Production (streamable HTTP): https://www.getrevox.com/api/mcp-servers/generic/mcp

Authentication

Use your Revox API key (same as the REST API). Send it as a Bearer token on every MCP request.

Header: Authorization: Bearer YOUR_API_KEY
Get your API key: Dashboard → API Keys

Keep your API key secure. Do not expose it in client-side code or public repos.

Tools (overview)

The server exposes the same capabilities as the REST API, as MCP tools. Main tools for voice workflows:

Tool	Description
`revox_make_call`	Place a call (phone number, optional assistant or custom prompt, optional schedule).
`revox_get_call`	Get call by ID. Use to poll once, or see `revox_wait_for_call` for periodic updates.
`revox_wait_for_call`	Poll a call by ID every few seconds; receive status via notifications/message until complete.
`revox_get_call_history`	List calls (paginated).
`revox_list_assistants`	List assistants.
`revox_get_assistant`	Get assistant by ID.
`revox_create_assistant`	Create an assistant (name, prompt, optional voice for accent/language).
`revox_auth_status`	Check if the API key is valid.

Additional tools cover campaigns, phone numbers, voices, users, billing, and Nango integrations.

Creating assistants and voice (language/accent)

When you create an assistant with revox_create_assistant, set voice_provider and voice_id so the voice matches the language of your prompt (e.g. French prompt → French voice). If you omit them, the default is an American English voice.

Call revox_list_voices to get available voices; filter by language (e.g. "fr" for French).
In revox_create_assistant, pass voice_provider (e.g. "cartesia") and voice_id (the ID from the list). Example for French: Cartesia voice ID a249eaff-1e96-4d2c-b23b-12efa4f66f41.
Use revox_update_assistant with voice_provider and voice_id to change an existing assistant’s voice. Tool names follow the pattern revox_<action>_<resource> (e.g. revox_create_campaign, revox_list_phone_numbers).

Call status (no webhooks in MCP)

MCP does not support server-initiated webhooks. After revox_make_call you get a call.id; to know when the call is done:

Poll: Call revox_get_call with that ID repeatedly until the call status indicates completion.
Periodic updates: Call revox_wait_for_call with the call ID. The server polls every few seconds (default 5), sends each status to the client via notifications/message, and returns the final call when the call completes (or on timeout/abort).
Revox webhooks: When placing a call with a custom assistant, you can set webhook_url on the assistant. Revox will HTTP POST to that URL when the call ends. Your own server can then notify the agent or user.

Example: place a call and get completion

Call revox_make_call with phone_number, and either assistant_id or prompt (and optional scheduled_at). When using a custom prompt in a non-English language (e.g. French), also pass voice_provider and voice_id so the voice matches (use revox_list_voices and pick a voice with the right language, e.g. "fr").
From the response, read call.id.
Either call revox_get_call with that id repeatedly until completed, or call revox_wait_for_call once to receive periodic status updates and the final result.
Use the call result (e.g. transcript, recording) as needed.

REST API reference

For request/response shapes and optional parameters, see the API Reference (Calls and other resources). The MCP tool inputs map to the same request bodies and query parameters.