Omnidim MCP Server

Create a workflow with a draft. Without `graph`, the draft holds one `trigger` node, ready for `editWorkflow` ops. Pass `graph` only to start from a complete graph. The response carries the `revision` you need to edit. (Tags: Workflows)

Turn the published workflow off, so real events stop running it. The workflow and its draft stay. Use `activateWorkflow` to turn it back on. (Tags: Workflows)

Permanently delete an agent. (Tags: Agents)

Delete a saved version. (Tags: Agents)

Delete a cloned voice and remove it from the provider. A voice that is still `processing` cannot be deleted. (Tags: Voice cloning)

Permanently delete a file. Removes it from any attached agents. Cannot be undone. (Tags: Knowledge base)

Remove one post-call action from the agent. The agent's other actions are not changed. (Tags: Agents)

Delete a workflow. Its published version stops running. This cannot be undone, so confirm with the user first. To stop it without deleting, use `deactivateWorkflow`. (Tags: Workflows)

Detach multiple knowledge-base files from an agent. (Tags: Knowledge base)

Detach a phone number from its agent. (Tags: Phone numbers)

Get a record-level diff for this version. By default it shows what changed in this version compared with the version before it. Use `against=current` to compare with the agent's live config (what restoring this version would change), or `against=<number>` to compare with another version. (Tags: Agents)

Initiate a call to a phone number using a specified agent. The phone number must include a country code with a leading plus. (Tags: Calls)

Change the draft with a list of `ops`: add, update, move or delete nodes, and connect or disconnect them. The ops apply all together or not at all. You must send the `revision` from your last read. If you get `409 revision_conflict`, read the workflow again and retry. Secrets read back as `********`. Send them back unchanged to keep the stored value. This edits the draft only. Use `publishWorkflow` to make it live. (Tags: Workflows)

List bulk-call campaigns with pagination and optional status filter. (Tags: Bulk calls)

Read your organization's wallet: the remaining balance, the minutes it buys at your rates, your plan, your concurrency headroom, and whether auto-recharge will refill it. Use it before a campaign, or on a schedule, so you find out you are low on credit from this endpoint rather than from a call failing with `402 payment_required`. The response always describes the organization the API key belongs to. There is no parameter for reading another account; resellers read a client's figures through the Reseller endpoints. A balance at or below zero does not always mean calls will stop. An organiza…

Get details of a specific agent by ID. The response also includes a `can_publish` boolean showing whether [version history](/docs/api-reference/agents/listAgentVersions) is turned on for the agent's organization. (Tags: Agents)

Get detailed information about a bulk-call campaign. (Tags: Bulk calls)

Real-time status of a running bulk-call campaign. (Tags: Bulk calls)

Detailed information about a specific call (duration, status, transcript, sentiment, extracted variables). (Tags: Calls)

One cloned voice, including its creation `status`. (Tags: Voice cloning)

Stream the generated mp3 sample of a cloned voice. Only the owner can fetch it. `404` (`sample_not_ready`) when no sample exists yet. The request needs your API key in the `Authorization` header. (Tags: Voice cloning)

Detailed metadata for a specific voice. (Tags: Providers)

One workflow with its draft, status and `revision`. Call it before every edit to get the current `revision`. Use `view=structure` to see nodes and edges without config on a large workflow. Secrets read back as `********`. (Tags: Workflows)

One run of a workflow, with the result of each step. Use it to read the outcome of `testWorkflow`. A run is finished when `state` is `completed`, `failed` or `cancelled`. (Tags: Workflows)

The settings one node type reads, with their types, required flags and outputs. Call it before you add or edit a node, because its `fields` are the keys of the node's `config`. Use `detail=full` only when you need help text and examples. (Tags: Workflows)

Import an Exotel number by providing your Exotel credentials. (Tags: Phone numbers)

Import a phone number associated with a SIP trunk. (Tags: Phone numbers)

Import an existing Twilio number by providing your Twilio credentials. (Tags: Phone numbers)

Retrieve all agents for the authenticated user with pagination support. (Tags: Agents)

List an agent's saved versions, newest first. Includes manual (named) versions, automatic versions, and system backups taken before a restore. (Tags: Agents)

Comprehensive response with services and voices in one payload. (Tags: Providers)

Per-contact results for a campaign: what happened on each call, the variables you sent with that contact, and a pointer to the recording. ## Paging There is one rule. Call it with no `cursor`, then keep passing back the `next_cursor` you were handed until it comes back `null`. ``` cursor = None while True: page = GET /lines?pagesize=150&cursor={cursor} handle(page["records"]) cursor = page["next_cursor"] if not cursor: break ``` Each call returns a page of rows, oldest first: `pagesize` goes up to 150 and defaults to 30. Cursors are opaque, so pass back the string you were …

The campaign's number pool, and which number is dialing right now. `calls_this_cycle` is what `fixed_count` rotation compares against, so it is the field to watch for the next rotation. `calls_dispatched` is the number's lifetime total across every cycle. (Tags: Bulk calls)

Retrieve call logs with pagination and optional filtering. (Tags: Calls)

Your cloned voices, oldest first, one cursor page at a time. Call it with no `cursor`, then pass back the `next_cursor` you were handed until it is `null`. Once a voice is `ready`, its `voice_id` is the provider voice id to put in an agent's `voice.voice_id` with `voice.provider: cartesia`. (Tags: Voice cloning)

List the integrations connected to your workspace, with each one's `id` and `integration_type`. Stored credentials (tokens, secrets, passwords, API keys, and the values of a custom API's headers and parameters) are never returned: they read `********`. When you create an integration, send the real values: `********` is refused. Accounts that sign in with OAuth (Google Sheets, Slack, HubSpot, Salesforce, Zoho Bigin) are connected in the dashboard. (Tags: Integrations)

List all knowledge-base files for the authenticated user. (Tags: Knowledge base)

Retrieve all available Large Language Model providers. (Tags: Providers)

Retrieve the phone numbers on your account, whether you bought them from the OmniDimension number shop or imported your own. (Tags: Phone numbers)

List every post-call action on the agent, each with its own `id`. (Tags: Agents)

Retrieve all Speech-to-Text providers. (Tags: Providers)

Retrieve all Text-to-Speech providers. (Tags: Providers)

Retrieve voices with filtering and pagination support. ElevenLabs and Cartesia support advanced filtering by name, language, accent, and gender. Other providers support basic pagination only. (Tags: Providers)

The choices for one `ref` field of a node type, such as the phone numbers, agents or integrations in your account. Call it for every `ref` field and never guess an id. If it returns `400 no_options`, the field is not chosen from a list, so ask the user for the value. (Tags: Workflows)

Search the node types a workflow can use, such as `whatsapp`, `voice_ai` or `conditional`. Call it first when you do not know which node to add. Then call `getWorkflowNodeType` for the settings of one type. (Tags: Workflows)

Your workflows, oldest first, one cursor page at a time. Use it to find a workflow id. Pass back `next_cursor` until it is `null`. (Tags: Workflows)

Make the draft the live version. Real events then run it, unless the workflow is paused. Run `validateWorkflow` first: publish is refused while the draft has errors. Ask the user before you publish. (Tags: Workflows)

Buy a phone number from the OmniDimension number shop. The monthly rental comes out of your wallet and the number is added to your account, ready to attach to an agent. (Tags: Phone numbers)

Regenerate the sample audio for a `ready` voice. (Tags: Voice cloning)

Give up a phone number and stop its rental, so it is not charged at the next renewal. Only a number currently allocated to the account can be released. (Tags: Phone numbers)

Rename a saved version or edit its note. Version history is immutable otherwise; only the name and note can change. (Tags: Agents)

Restore a version onto the live agent. Your current setup is saved first as a backup version, so restoring is undoable. Configuration is brought back; any knowledge files or integrations that were deleted since this version was saved can't be re-linked, and are reported in `skipped`. (Tags: Agents)

Re-queue contacts that did not connect, without creating a new campaign. Use it after a campaign finishes with more no-answers than you expected, or when the reason was on your side (a bad window, a number that was having a bad day). Retried contacts keep their original variables. (Tags: Bulk calls)

Search the OmniDimension number shop for phone numbers available to buy in a region. Price and validity are flat per region, so every result shows the same `monthly_rental_usd` and `validity_days`, and that is the exact amount a purchase will charge. A region can have more than one carrier, each stocking different number series. Pass the `carrier` you want; the response names the carrier its results came from, and that is the carrier a purchase has to pass. (Tags: Phone numbers)

Change how many calls the campaign places at once, including while it is running. Raise it to finish sooner, lower it if your team cannot keep up with transfers or your numbers are being answered less. The ceiling is your account's concurrency limit. (Tags: Bulk calls)

Restrict a campaign to a daily calling window, in the campaign's timezone. Outside the window the campaign holds rather than finishing, and resumes the next day. (Tags: Bulk calls)

Stop or resume dialing from one number in the pool. Pausing is what you want when a number starts going bad mid-campaign: dialing moves to the next number in sequence and the paused number keeps its history and counters. The last active number of a running campaign cannot be paused, since the campaign would have nothing to dial from. Send the state you want rather than a toggle, so retrying the same request is harmless. `assignment_id` is the number's id **within this campaign's pool**, from List rotation pool. It is not the `phone_number_id`. (Tags: Bulk calls)

Start a campaign that was created with `save_as_draft: true`. Drafts let you build a campaign over several requests: create it, add contacts in batches, set the number pool, set concurrency, then start when everything is in place. A campaign that is already running, scheduled, or finished cannot be started. (Tags: Bulk calls)

Runs the draft once with payload as the trigger data. Every node runs for real: WhatsApp messages, SMS, emails and calls go out and CRM records change. Ask the user before calling it, and use their own phone number or email in the payload. It returns an `execution_id` at once. Poll `getWorkflowExecution` for the result. (Tags: Workflows)

Update an existing agent. Send only the fields you want to change. `post_call_actions` replaces the agent's email, webhook, Omni CRM, Cloud WhatsApp and workflow actions as one set, but only when you send at least one of those types. Google Sheets, Slack, Salesforce, HubSpot and Zoho Bigin actions are replaced only when their key is sent, and kept otherwise. If a sent action gives a variable key a new prompt, kept actions that use the same key take the new prompt too. To add, change or remove one action without touching the others, use `/agents/{agent_id}/post-call-actions`. > **Voicemail de…

Change the name, description or gender of a cloned voice. (Tags: Voice cloning)

Change fields of one post-call action. Fields you don't send keep their value. The `type` cannot change. (Tags: Agents)

Upload a PDF file. The file content must be Base64 encoded. (Tags: Knowledge base)

Check the draft and list what blocks publish. It changes nothing. Call it after your edits and fix every error before `publishWorkflow`. (Tags: Workflows)