CloudTalk MCP Tool Reference - CloudTalk Help Center

Every tool in the CloudTalk MCP catalogue, grouped by area. You don’t call these by name (the assistant picks them), but this reference tells you what’s possible and what each tool needs. The campaign tools need the Sales Dialer add-on; the rest are available on any MCP-enabled account.

Required parameters are shown in bold; everything else is optional. Defaults are noted in the description.
Rate limit: 60 requests per minute per company across all tools. A large job runs in batches; a 429 means wait a minute and continue.
A ⚠️ marks a write you cannot undo through the MCP (a deleted campaign, or a created contact / voice agent / knowledge base / AIVA tool that has no delete tool here).
Tools marked Asks for confirmation return a preview of what would happen instead of acting, and execute only when the call carries explicit confirmation. Your assistant is what decides to show you that preview and ask. CloudTalk does not remember that a preview was returned, so an assistant that confirms on its own behalf executes in one step — treat this as a review step your assistant honours, not a lock CloudTalk enforces.
The Campaigns tools require the new Sales Dialer add-on.
Call tags and contact tags are separate catalogs; an id from one is rejected by the other.
Every profile includes the connection check and the four account lookups.

Calls & analytics

cloudtalk_search_calls

Find calls, newest first. Returns compact summaries (with tags as {id, name}); use cloudtalk_get_call for detail. Covers external calls only: internal agent-to-agent calls are not in this call log, so totals can read lower than the Dashboard, which counts them. Each row’s total_time is a composite duration, not the connected time: ring plus talking plus wrap-up on an inbound call, talking plus wrap-up on an outbound one. The public API’s billsec for the same call counts only the connected part, so the two do not match — compare talking_time, the closest counterpart. The first page also returns the total match count (items_count, page_count); later pages return rows only. You can page through up to 10,000 matching calls per search; to reach more, narrow the date range or add a filter.

Parameter	Type	Description
`date_from`	string	ISO datetime (UTC). Defaults so the search covers the last 3 months, the maximum window per search. Move the window back for older calls.
`date_to`	string	ISO datetime (UTC), inclusive upper bound.
`contact_id`	integer	Filter by contact. Matches the contact id frozen onto the call when it was logged. CloudTalk back-fills its own call records when a number is later attached to a contact; this index is not back-filled, so a per-contact total here can sit well below the same contact’s figure in the Dashboard or the public API, and paging further will not close the gap. To cover every call on a number regardless of attribution, filter by `public_external` instead.
`user_id`	integer	Filter by agent.
`group_id`	integer	Filter by agent group.
`voice_agent_id`	integer	Filter by AI Voice Agent.
`tag_id`	integer	Filter by call tag.
`country_code`	string	Filter by the contact’s country as an ISO-2 code, e.g. `US`, not the dialled number’s country.
`direction`	string	`incoming` or `outgoing`. Internal agent-to-agent calls are not part of this call log, so there is no internal option.
`status`	string	`answered` or `missed`.
`sentiment`	string	Filter by the call’s overall AI sentiment: `positive`, `negative`, or `neutral`. Only analysed calls carry a verdict, so a filtered total can read lower than the same window without it.
`public_external`	string	Customer phone number. Matched as a substring, so a fragment such as the last six digits is enough; a full E.164 number is not required.
`without_tags`	boolean	Only calls that have no tags.
`call_id`	integer	Exact call; no date range needed.
`limit`	integer	Results per page, up to 200. Default `50`.
`page`	integer	Page number. Default `1`.

cloudtalk_get_call_insights

AI summary, sentiment, topics, smart notes and talk-listen ratio for one call.

Parameter	Type	Description
`call_id`	integer	CloudTalk call ID.
`include`	array	Any subset of `summary`, `sentiment`, `topics`, `smart_notes`, `talk_listen`. Default: all five.

cloudtalk_get_call

Full detail for one call: contact, agent, tags, timings, call flow, topics, sentiment.

Parameter	Type	Description
`call_id`	integer	CloudTalk call ID.

cloudtalk_get_call_transcript

The verbatim, speaker-tagged transcript as time-coded segments. A call with no transcript answers transcription: null with reason: "no_transcript" — an answer, not a transport failure, so there is nothing to retry.

Parameter	Type	Description
`call_id`	integer	CloudTalk call ID.
`limit`	integer	Segments per page, up to 1000. Default `200`.
`offset`	integer	Segment offset for the next page. Default `0`.

cloudtalk_get_call_recording

A signed link to the call audio, valid for up to 12 hours and sometimes much less. Fetch it again rather than storing it. A call with no recording returns a clear “no recording” answer. Every access is audit-logged.

Parameter	Type	Description
`call_id`	integer	CloudTalk call ID.
`action`	string	`play` or `download`. Default `play`.

cloudtalk_list_call_tags

List the call tags your company can attach to a call. Every id returned is one cloudtalk_add_call_tags accepts. Call tags are a separate catalog from contact tags (cloudtalk_list_contact_tags); the ids are not interchangeable.

Parameter	Type	Description
`limit`	integer	Results per page, up to 1000. Default `200`.
`cursor`	string	Pagination cursor from a previous response. Omit for the first page.
`call_type`	string	Keep only tags usable on `incoming` or `outgoing` calls (direction-agnostic tags are always included). Omit for the whole catalog.

cloudtalk_add_call_tags

Attach one or more call tags to a call. Idempotent: tags already on the call are ignored, so re-running is safe. Returns the call’s full tag set after the change.

Parameter	Type	Description
`call_id`	string	The call to tag. Prefer the numeric call id from `cloudtalk_search_calls`; the call uuid from `cloudtalk_get_call` also works.
`tag_ids`	integer or array	One call-tag id or a list of them, up to 100 per call. Get ids from `cloudtalk_list_call_tags`; contact-tag ids are rejected.

cloudtalk_remove_call_tags

Detach one or more tags from a call. Idempotent: tags not on the call are ignored, and only the ids you name are removed. Reversible with cloudtalk_add_call_tags. Returns the call’s full tag set after the change.

Parameter	Type	Description
`call_id`	string	The call to untag (numeric call id or uuid).
`tag_ids`	integer or array	One call-tag id or a list of them, up to 100 per call.

cloudtalk_get_agent_performance

One agent’s activity aggregated over a period: call counts, talk time, top contacts and tags. Counts are reliable; the talk-time figures presently often come back null, which means no answered call in the window reported a duration — unknown, never zero. Read talk_reported_count against answered for the coverage, and cloudtalk_get_call for one call’s exact duration.

Parameter	Type	Description
`date_from`	string	ISO datetime (UTC). The window may not exceed one year.
`user_id`	integer	Agent ID. Provide one of `user_id`, `email`, `extension`.
`email`	string	Agent email.
`extension`	string	Agent extension.
`date_to`	string	ISO datetime (UTC), upper bound.
`max_calls`	integer	Calls to aggregate, up to 1000. Default `200`.
`include_intelligence`	boolean	Also sample recent calls for a sentiment breakdown. Default `false`.
`intelligence_sample`	integer	Calls to sample, up to 25. Default `25`.

cloudtalk_realtime_group_stats

Live queue stats per group: agents online, waiting calls, abandon rate, wait times. Counts are today-so-far (UTC). No parameters.

Contacts

cloudtalk_get_contact_interactions_summary

Compact digest of one contact’s history: counts, last contact, top tags, plus AI summaries and a sentiment trend over recent calls.

Parameter	Type	Description
`contact_id`	integer	Provide this or `phone`.
`phone`	string	E.164 number to resolve to a contact.
`date_from`	string	ISO datetime (UTC). Window up to 1 year (the default).
`date_to`	string	ISO datetime (UTC), upper bound.
`max_calls`	integer	Calls to aggregate, up to 500. Default `50`.
`sample_size`	integer	Recent calls to sample for AI signals, up to 8. Default `5`.

cloudtalk_list_contacts

List contacts, search them by free text, or look up an exact address with email. Tag filtering differs by lane: listing matches all the given tags by default; a keyword query always matches any one.

Parameter	Type	Description
`query`	string	Free-text search, 2 to 200 characters. Matches text anywhere on the record, so a result is not proof that a contact holds that exact address or number — use `email` for that. Omit to list.
`email`	string	Exact email lookup: returns every contact holding this address, or none. Each row’s `email` is the address that matched, which need not be the contact’s first. `pagination.truncated` is `true` when more matches exist, `false` when the list is complete, and `null` when that could not be determined — so only `false` makes `totalCount` trustworthy. Cannot be combined with `query`, `tags`, `country`, or a page past the first.
`tags`	array	Filter by tag name. Only natively applied tags match; a tag applied by a CRM or integration sync matches nothing. When listing, `tag_match` decides all vs any; with `query` it always matches at least one. Under `all`, a name that matches no tag empties the result, so zero results can mean one name was wrong.
`tag_match`	string	`all` (default) or `any`. Applies only when listing; ignored with `query`.
`country`	string	ISO-2 country code, e.g. `GB`.
`limit`	integer	Results per page, up to 100. Default `20`.
`page`	integer	Page number. Default `1`.

cloudtalk_get_contact

Full detail for one contact: profile, address, all numbers and emails, tags, CRM links.

Parameter	Type	Description
`contact_id`	integer	CloudTalk contact ID.

cloudtalk_get_contact_journey

360° timeline for one contact: every call in the window, notes and activities, merged newest-first. Includes the 100 most recent notes and 100 most recent activities.

Parameter	Type	Description
`contact_id`	integer	Provide this or `phone`.
`phone`	string	E.164 number to resolve to a contact.
`date_from`	string	ISO datetime (UTC). Window up to 1 year (the default).
`date_to`	string	ISO datetime (UTC), upper bound.
`max_calls`	integer	Calls to include, up to 500. Default `100`.
`include_intelligence`	boolean	Also sample recent calls for sentiment. Default `false`.
`intelligence_sample`	integer	Calls to sample, up to 25. Default `20`.

cloudtalk_create_contact

Create a contact. ⚠️ No duplicate check: creating the same person twice makes two contacts, and there is no tool to delete a contact through the MCP. Search with cloudtalk_list_contacts first, then create only the ones that are missing.

Parameter	Type	Description
`name`	string	Contact display name, up to 150 characters.
`company`	string	Up to 100 characters.
`title`	string	Job title, up to 255 characters.
`industry`	string	Up to 100 characters.
`website`	string	Up to 100 characters.
`address`	string	Street address, up to 255 characters.
`city`	string	Up to 255 characters.
`state`	string	Up to 255 characters.
`zip`	string	Up to 15 characters.
`source`	string	Contact source label, up to 64 characters.
`phone_numbers`	array	Phone numbers in E.164 form.
`emails`	array	Email addresses.
`tags`	array	Tag names to attach.
`favorite_agent_id`	integer	User ID of the favourite agent.
`custom_fields`	object	Custom field values keyed by field name.

cloudtalk_update_contact

Update fields on a contact. Only the fields you pass change, but tags, phone_numbers, emails and custom_fields are replaced in full, so send the complete list. Asks for confirmation.

Parameter	Type	Description
`contact_id`	integer	CloudTalk contact ID.

Optional fields: the same set as cloudtalk_create_contact.

cloudtalk_add_contact_note

Add a note to a contact. Notes are additive; existing ones are never touched.

Parameter	Type	Description
`contact_id`	integer	CloudTalk contact ID.
`note`	string	Note body, up to 25,000 characters.

cloudtalk_log_contact_activity

Log a CRM-style activity: an order, an email, a custom event from another system.

Parameter	Type	Description
`contact_id`	integer	CloudTalk contact ID.
`type`	string	Activity type, e.g. `order`; free-form.
`name`	string	Short activity title.
`activity_date`	string	ISO datetime the activity occurred at.
`description`	string	Longer free-text description.
`external_url`	string	Link to the activity in the source system.
`external_id`	string	Identifier in the source system.
`external_service`	string	Name of the source system.
`cdr_id`	integer	Related call ID, if any.
`activity_author`	string	Who performed the activity.

cloudtalk_bulk_tag_contacts

Tag many contacts in one call. Returns per-contact success and error counts. Asks for confirmation.

Parameter	Type	Description
`contact_ids`	array	Contact IDs, 1 to 500 per call.
`tags`	array	Tag names to assign.
`mode`	string	`append` adds the tags alongside existing ones; `replace` overwrites each contact’s tag set. Default `append`.

Messaging & calling

cloudtalk_send_sms

Send an SMS to a customer from one of your numbers. Sends to one recipient per call; to message several people, send them one at a time. Asks for confirmation.

Parameter	Type	Description
`recipient`	string	Customer number, E.164.
`sender`	string	A number your company owns (E.164) that has SMS enabled. Use `cloudtalk_list_numbers` and pick one whose `sms_supported` is true, or the send is rejected.
`message`	string	SMS body text.

cloudtalk_initiate_call

Click-to-call: rings the chosen agent first, then dials the customer once they pick up. The agent must be online in CloudTalk and not already on a call, or the call fails. Asks for confirmation.

Parameter	Type	Description
`agent_id`	integer	The agent to ring first; must be online and free.
`callee_number`	string	Customer number, E.164.

cloudtalk_trigger_aiva_call

Place an outbound AI Voice Agent call. The call is queued; a session ID comes back for tracking. Asks for confirmation.

Parameter	Type	Description
`voice_agent_id`	string	From `cloudtalk_list_voice_agents`.
`call_number`	string	Customer number, E.164.

cloudtalk_list_sms_conversations

An agent’s SMS threads: customer number, unread count, last-message preview.

Parameter	Type	Description
`user_id`	integer	SMS is scoped to an agent’s numbers, so say whose view you want.
`contact_number`	string	Only threads with this customer number (E.164).
`unread`	boolean	Only unread threads.
`limit`	integer	Results per page, up to 100. Default `20`.
`cursor`	integer	Pagination cursor from a previous response.

cloudtalk_list_sms_messages

The messages in one SMS thread, newest first.

Parameter	Type	Description
`conversation_id`	integer	From `cloudtalk_list_sms_conversations`.
`user_id`	integer	The acting agent.
`limit`	integer	Results per page, up to 100. Default `20`.
`cursor`	integer	Pagination cursor from a previous response.

AI Voice Agents

cloudtalk_create_voice_agent

Create an AI Voice Agent. Invalid configurations are rejected with specific errors and nothing is saved. ⚠️ There is no tool to delete a voice agent through the MCP; a created agent is managed or removed in the Dashboard. Asks for confirmation.

Parameter	Type	Description
`agentName`	string	Display name.
`direction`	string	`inbound` or `outbound`.
`defaultOutboundNumberId`	integer	Outbound number ID; `1` = automatic.
`language`	string	Primary language code, e.g. `en`.
`maxCallDuration`	integer	Maximum call duration in minutes; the server rejects values above 120.
`temperature`	number	0 to 1.
`voice`	string	Voice ID.
`stability`	number	Voice stability, 0 to 1.
`similarity`	number	Voice similarity boost, 0 to 1.
`optimizeStreamingLatency`	integer	Streaming latency optimisation, 0 to 4.
`startSpeakingFirst`	boolean	Whether the agent speaks first.
`goalPrompt`	string	The agent’s goal / system prompt.
`greeting`	string	Opening line.
`secondaryLanguages`	array	Additional language codes.
`knowledgeBaseIds`	array	Knowledge bases to link.
`tone`	array	Identity tone presets shaping how the agent speaks: `professional`, `friendly`, `casual`, `calm`, `empathetic`, `direct`. Presets only — free text is rejected, repeats are dropped, and an empty list is saved as `friendly`, `direct`.
`verbosity`	string	How much the agent says per turn: `concise`, `standard` or `thorough`. `""` means unset and is saved as `standard`.
`skills`	object	Skill toggles: transfer to human, take a message, extract data, answer questions, book appointments.
`scenarios`	array	Scenario rules.
`guardrails`	array	Guardrail rules.
`dialTime`	integer	Ring timeout in seconds, 5 to 120. `0` means use the provider’s own default instead.
`failoverOutboundNumberId`	integer	Fallback outbound number. Required when `defaultOutboundNumberId` is `1` (automatic), and it must be the id of a real number from `cloudtalk_list_numbers` — `1` is not accepted here.
`provider`	string	Speech provider: `elevenlabs` or `deepgram`. Omitted means the optimized one for the agent’s setup.
`llm`	string	Model the agent runs on, by canonical id, e.g. `openai - gpt-4o-mini`. Omitted means the optimized one. A model the provider does not offer is rejected.
`providerOverride`	string	Deprecated alias of `provider`, still accepted. If you send both, the alias wins.
`llmOverride`	string	Deprecated alias of `llm`, still accepted. If you send both, the alias wins.
`elevenLabsSettings`	object	Advanced voice-provider settings.

A Deepgram agent with secondary languages is saved as long as Deepgram serves every language. The create response then lists ElevenLabs under optimized_settings, and cloudtalk_get_voice_agent under optimizedSettings. A language, primary or secondary, that the agent’s provider does not serve is rejected with LANGUAGE_NOT_SUPPORTED and nothing is saved.

cloudtalk_list_voice_agents

Your AI Voice Agents: ID, name, direction.

Parameter	Type	Description
`limit`	integer	Results per page, up to 200. `pagination.items_count` carries the unpaged total. Default `50`.
`page`	integer	Page number. Default `1`.

cloudtalk_get_voice_agent

One agent’s full configuration as CloudTalk stores it, with camelCase keys, including its provider, llm and optimizedSettings. The create and update tools return a shorter summary with snake_case keys, where the same object is optimized_settings. optimizedSettings compares the agent with the values CloudTalk recommends for its current setup. available (the Public API names this field isAvailable) is true when they differ, and each entry of changes names a setting by its path with its current value (from) and the recommended one (to). effects lists what applying them brings that no setting holds, such as backup models. CloudTalk never applies these values on its own: to adopt them, pass apply_optimized_settings to cloudtalk_update_voice_agent.

Parameter	Type	Description
`voice_agent_id`	string	From `cloudtalk_list_voice_agents`.

cloudtalk_update_voice_agent

Change an agent’s configuration. Pass only the fields you want to change: the tool reads the stored agent and merges your fields onto it, so anything you leave out, provider and llm included, keeps its stored value. A field you pass replaces the stored value whole, so to change one entry of skills, scenarios, guardrails, secondaryLanguages, knowledgeBaseIds or elevenLabsSettings, read it with cloudtalk_get_voice_agent and pass the complete value back. Asks for confirmation.

Parameter	Type	Description
`voice_agent_id`	string	The agent to update.
`apply_optimized_settings`	boolean	Apply the agent’s optimized settings in this save, the latest `minorVersion` included. See below.

Plus any parameter of cloudtalk_create_voice_agent; none of them is required here. An update never changes a value you did not pass. minorVersion keeps its stored value: passing a different one is refused, so an agent moves to the latest version only through apply_optimized_settings. To adopt the agent’s optimized settings, pass "apply_optimized_settings": true. The tool sets every change’s path to its to value in one save: provider, llm, the latest minorVersion and any elevenLabsSettings keys. A nested path such as elevenLabsSettings.vad replaces that one key and keeps the rest of elevenLabsSettings. Don’t adopt the changes by passing each to under its path yourself: minorVersion is refused, and a dotted path is not a parameter. You can change other fields in the same save, except the inputs the optimized settings depend on. The tool refuses the call and saves nothing when:

the agent has no optimized settings to apply (available is false);
you also pass a different value for one of the paths it would set; send either the optimized value or your own. A value equal to the stored one (the change’s from) is not a conflict, so you can resend the full stored configuration;
you pass providerOverride or llmOverride, which would override the applied value;
you also change an input the optimized settings depend on: language, secondaryLanguages, knowledgeBaseIds, custom skills or tools, transfer-to-human rules, scenarios or goalPrompt. Save that change first, then apply the optimized settings in a separate call, so they are worked out for the saved setup.

The preview reports the optimized settings in snake_case: optimized_settings_available is the available flag, optimized_settings holds the changes and effects, and applies_optimized_settings says whether this save applies them. The update response, like the create response, returns the whole object as optimized_settings.

cloudtalk_list_knowledge_bases

Knowledge bases with type, status, and which agents use them.

Parameter	Type	Description
`limit`	integer	Results per page, up to 200. `pagination.items_count` carries the unpaged total. Default `50`.
`page`	integer	Page number. Default `1`.

cloudtalk_create_knowledge_base

Give voice agents material to answer from: inline text, or a public web page ingested in the background. ⚠️ There is no tool to delete a knowledge base through the MCP; manage it in the Dashboard. Asks for confirmation.

Parameter	Type	Description
`name`	string	Display name, up to 50 characters.
`type`	string	`custom` (inline text) or `url` (ingest a web page). Default `custom`.
`text`	string	Content; required when `type` is `custom`.
`url`	string	Public http(s) URL; required when `type` is `url`.

cloudtalk_list_voice_agent_tools

HTTP actions a voice agent can perform mid-conversation, with their current assignments.

Parameter	Type	Description
`voice_agent_id`	string	Only the tools assigned to this agent.
`limit`	integer	Results per page, up to 200. Default `50`.
`page`	integer	Page number. Default `1`.

cloudtalk_assign_tool_to_voice_agent

Give an agent an action. Assigning one it already has is a safe no-op. Asks for confirmation.

Parameter	Type	Description
`tool_id`	string	From `cloudtalk_list_voice_agent_tools`.
`voice_agent_id`	string	The agent to assign to.

cloudtalk_unassign_tool_from_voice_agent

Take an action away from one agent; other agents keep it. Asks for confirmation.

Parameter	Type	Description
`tool_id`	string	From `cloudtalk_list_voice_agent_tools`.
`voice_agent_id`	string	The agent to unassign from.

cloudtalk_create_voice_agent_tool

Create an AIVA tool: an HTTP action a voice agent can call mid-conversation. If the server rejects the tool, it returns the validator’s specific errors and nothing is saved. ⚠️ There is no tool to delete an AIVA tool through the MCP; manage it in the Dashboard. Asks for confirmation. Header and parameter values may hold credentials for your endpoint. They are sent to CloudTalk but never shown back in previews or responses.

Parameter	Type	Description
`name`	string	Up to 64 characters; letters, numbers, hyphen and underscore only.
`method`	string	`GET`, `POST`, `PUT`, `DELETE`, or `PATCH`.
`url`	string	The endpoint to call. May embed `{{param}}` placeholders resolved at call time.
`awaiting_response_message`	string	What the agent says while waiting for the response, up to 4096 characters.
`description`	string	What the tool does, for the agent’s benefit.
`voice_agent_config_ids`	array	Agents to assign the tool to. Empty means assigned to none.
`headers`	array	HTTP headers: `key` plus a `CONST` value or a `SECRET` reference (`secret_id`).
`query_params`	array	Query parameters: `param_name`, `data_type` (STRING, INTEGER, NUMBER, BOOLEAN) and a value that is `CONST` (fixed), `PARAM` (taken from the call), or `LLM` (filled in by the agent mid-conversation).
`body_params`	array	Request-body parameters; same shape as `query_params`.

cloudtalk_update_voice_agent_tool

Update an AIVA tool. Only the fields you pass change; omitted fields, including stored header and parameter values, are preserved. Passing an empty list explicitly clears that list. Asks for confirmation.

Parameter	Type	Description
`tool_id`	string	From `cloudtalk_list_voice_agent_tools`.

Optional fields: the same set as cloudtalk_create_voice_agent_tool.

Campaigns

The campaign tools require the new Sales Dialer add-on. Without it, these tools have nothing to operate on.

cloudtalk_launch_campaign_from_source

Create a campaign, attach its sources, and start it in one step. Not atomic: if a later step fails, the campaign is left in initializing and dials nothing, and the response says how far it got. Asks for confirmation.

Parameter	Type	Description
`name`	string	Campaign name.
`mode`	string	`sequential` or `parallel` (`predictive` is accepted but deprecated).
`target_tag`	array	At least one of `target_tag`, `queue_group`, `agent` is required.
`queue_group`	array	Agent-group IDs.
`agent`	array	Agent IDs.
`activate`	boolean	Pass `false` to stage the campaign without dialing. Default `true`.

Also accepts the same optional config bundles as cloudtalk_create_campaign (the policy objects, agent_permissions, waterfall_order, call_script_id, survey_id).

cloudtalk_list_campaigns

List outbound campaigns with status, mode and contact sources.

Parameter	Type	Description
`status`	string	Filter by campaign status: `initializing`, `active`, `inactive`, `archived`, or `deleted`.
`mode`	string	Filter by dialing mode: `sequential`, `parallel`, or `predictive`.
`limit`	integer	Results per page, up to 100. Default `100`.
`cursor`	string	Pagination cursor from a previous response.

cloudtalk_get_campaign

One campaign in detail: sources, status, policies, linked script and survey.

Parameter	Type	Description
`campaign_id`	string	Campaign ID.

cloudtalk_get_campaign_statistics

How a campaign is performing: the contact funnel by state, dialed and answered counts with the answer rate, conversions and conversion rate, how many calls reached a person, a voicemail or another machine, the disposition breakdown, and call durations. Figures are aggregates for the whole campaign; no contact, agent or call is identified. Without a window the figures are all-time. With date_from and date_to the dialing outcomes, dispositions and durations cover that window only, and range in the response echoes it. The contact funnel always shows the campaign’s current state; a window does not narrow it. Rates are fractions from 0 to 1: the answer rate is answered calls divided by calls dialed, and the conversion rate is conversions divided by dispositioned calls, not by calls dialed. All-time figures come from a running total the dialer keeps, and updated_at says when it last changed; a windowed read is counted when you ask and has no updated_at. Results can be up to 60 seconds old. Also in the Analytics profile, together with cloudtalk_list_campaigns for finding the id. The same figures are available from the API as Get a campaign’s statistics.

Parameter	Type	Description
`campaign_id`	string	Campaign ID. An id that doesn’t exist or belongs to another account returns `statistics: null` with `reason: "not_found"`.
`date_from`	string	ISO 8601 date or datetime, inclusive; a date on its own is a UTC day. Not older than 13 months. Give it together with `date_to`, or leave both out for all-time figures.
`date_to`	string	ISO 8601 date or datetime, exclusive. A date on its own, e.g. `2026-08-31`, includes that whole UTC day.
`include_durations`	boolean	All-time figures only: also return `call_durations`. It makes the all-time read slower, so it is off by default. A windowed read always includes them. On an all-time read without this flag, `call_durations` is `null` because it was not requested. When durations were requested, `null` means they could not be read: unknown, not zero.

A windowed read is the expensive kind; ask for one campaign at a time rather than many at once.

cloudtalk_create_campaign

Create a campaign. It starts in initializing and dials nothing until you add sources and set it active. Asks for confirmation.

Parameter	Type	Description
`name`	string	Campaign name.
`mode`	string	`sequential` or `parallel` (`predictive` is accepted but deprecated).
`calling_policy`	object	Calling-policy bundle.
`queue_policy`	object	Queue-policy bundle.
`retry_policy`	object	Retry-policy bundle.
`schedule_policy`	object	Schedule-policy bundle.
`ttl_policy`	object	Contact time-to-live policy.
`agent_permissions`	object	Agent-permissions bundle.
`waterfall_order`	array	Ordered contact-source tiers.
`call_script_id`	string	Call script to link.
`survey_id`	string	Survey to link.

cloudtalk_update_campaign

Update a campaign’s configuration. Scalar fields merge, but a policy bundle you pass is replaced in full: send the complete bundle from cloudtalk_get_campaign, because any key you leave out is dropped from the stored bundle. It is not reset to some default value — cloudtalk_get_campaign simply stops returning it, and the campaign runs as though that setting had never been configured. Asks for confirmation.

Parameter	Type	Description
`campaign_id`	string	Campaign ID.

Plus at least one field from the cloudtalk_create_campaign set. Pass null for call_script_id or survey_id to clear that link.

cloudtalk_set_campaign_status

Start, pause or archive a campaign. Pausing never interrupts calls already in progress. Asks for confirmation.

Parameter	Type	Description
`campaign_id`	string	Campaign ID.
`status`	string	`active`, `inactive`, or `archived`.

cloudtalk_delete_campaign

⚠️ Delete a campaign. This is terminal and irreversible: the status becomes deleted, with no undo and no way to reactivate it. This is not archiving; to retire a campaign reversibly, use cloudtalk_set_campaign_status with archived (which exits back to inactive). Asks for confirmation.

Parameter	Type	Description
`campaign_id`	string	Campaign ID.

cloudtalk_get_campaign_associations

A campaign’s contact sources (tags) and assignees (groups, agents). Read this before replacing them.

Parameter	Type	Description
`campaign_id`	string	Campaign ID.

cloudtalk_replace_campaign_associations

Set a campaign’s sources and assignees. One write covers all three kinds and always sends all three: a kind you pass replaces its current set in full (an empty array clears it), and a kind you omit is preserved. Asks for confirmation.

Parameter	Type	Description
`campaign_id`	string	Campaign ID.
`target_tag`	array	Contact-source tags. Replaces the set in full; an empty array clears it; omit to preserve. Tags owned by a CRM connection are ignored and reported back in `crm_owned_ignored`.
`queue_group`	array	Agent-group IDs. Replaces the set in full; an empty array clears it; omit to preserve.
`agent`	array	Agent IDs. Replaces the set in full; an empty array clears it; omit to preserve.
`expected_digest`	string	Optional. A token the tool computes from the associations it read for the preview; CloudTalk does not store it. Pass it back with your confirmation and the tool re-reads, compares, and refuses the write if the associations changed in between. The check lives in this tool alone — campaign resources carry no version or ETag — so it guards the gap between preview and confirmation, and nothing after that.

Connection

cloudtalk_health_check

Check that CloudTalk is reachable and see which company and user your API key resolved to. Run this first when something is failing: it separates an authentication or wrong-account problem from a data problem. No parameters.

Account lookups

The reference data other tools need: agent, group, number and tag ids. Included in every profile.

cloudtalk_list_agents

Agents: names, emails, extensions, availability, default number.

Parameter	Type	Description
`id`	integer	One specific agent.
`limit`	integer	Results per page, up to 1000. Default `200`.
`page`	integer	Page number. Default `1`.

cloudtalk_list_groups

Agent groups (queues and teams).

Parameter	Type	Description
`limit`	integer	Results per page, up to 1000. Default `200`.
`page`	integer	Page number. Default `1`.

cloudtalk_list_numbers

Your phone numbers with friendly names and caller IDs.

Parameter	Type	Description
`id`	integer	One specific number.
`country_code`	string	Numeric calling code, e.g. `44`.
`area_code`	string	Area code prefix.
`is_free`	boolean	Only numbers not yet assigned to a destination.
`limit`	integer	Results per page, up to 1000. Default `200`.
`page`	integer	Page number. Default `1`.

cloudtalk_list_contact_tags

Your contact tag catalog: the tags used on contacts and by cloudtalk_bulk_tag_contacts. Call tags live in a separate catalog; for those use cloudtalk_list_call_tags.

Parameter	Type	Description
`limit`	integer	Results per page, up to 1000. Default `200`.
`page`	integer	Page number. Default `1`.

​Calls & analytics

​cloudtalk_search_calls

​cloudtalk_get_call_insights

​cloudtalk_get_call

​cloudtalk_get_call_transcript

​cloudtalk_get_call_recording

​cloudtalk_list_call_tags

​cloudtalk_add_call_tags

​cloudtalk_remove_call_tags

​cloudtalk_get_agent_performance

​cloudtalk_realtime_group_stats

​Contacts

​cloudtalk_get_contact_interactions_summary

​cloudtalk_list_contacts

​cloudtalk_get_contact

​cloudtalk_get_contact_journey

​cloudtalk_create_contact

​cloudtalk_update_contact

​cloudtalk_add_contact_note

​cloudtalk_log_contact_activity

​cloudtalk_bulk_tag_contacts

​Messaging & calling

​cloudtalk_send_sms

​cloudtalk_initiate_call

​cloudtalk_trigger_aiva_call

​cloudtalk_list_sms_conversations

​cloudtalk_list_sms_messages

​AI Voice Agents

​cloudtalk_create_voice_agent

​cloudtalk_list_voice_agents

​cloudtalk_get_voice_agent

​cloudtalk_update_voice_agent

​cloudtalk_list_knowledge_bases

​cloudtalk_create_knowledge_base

​cloudtalk_list_voice_agent_tools

​cloudtalk_assign_tool_to_voice_agent

​cloudtalk_unassign_tool_from_voice_agent

​cloudtalk_create_voice_agent_tool

​cloudtalk_update_voice_agent_tool

​Campaigns

​cloudtalk_launch_campaign_from_source

​cloudtalk_list_campaigns

​cloudtalk_get_campaign

​cloudtalk_get_campaign_statistics

​cloudtalk_create_campaign

​cloudtalk_update_campaign

​cloudtalk_set_campaign_status

​cloudtalk_delete_campaign

​cloudtalk_get_campaign_associations

​cloudtalk_replace_campaign_associations

​Connection

​cloudtalk_health_check

​Account lookups

​cloudtalk_list_agents

​cloudtalk_list_groups

​cloudtalk_list_numbers

​cloudtalk_list_contact_tags

Calls & analytics

cloudtalk_search_calls

cloudtalk_get_call_insights

cloudtalk_get_call

cloudtalk_get_call_transcript

cloudtalk_get_call_recording

cloudtalk_list_call_tags

cloudtalk_add_call_tags

cloudtalk_remove_call_tags

cloudtalk_get_agent_performance

cloudtalk_realtime_group_stats

Contacts

cloudtalk_get_contact_interactions_summary

cloudtalk_list_contacts

cloudtalk_get_contact

cloudtalk_get_contact_journey

cloudtalk_create_contact

cloudtalk_update_contact

cloudtalk_add_contact_note

cloudtalk_log_contact_activity

cloudtalk_bulk_tag_contacts

Messaging & calling

cloudtalk_send_sms

cloudtalk_initiate_call

cloudtalk_trigger_aiva_call

cloudtalk_list_sms_conversations

cloudtalk_list_sms_messages

AI Voice Agents

cloudtalk_create_voice_agent

cloudtalk_list_voice_agents

cloudtalk_get_voice_agent

cloudtalk_update_voice_agent

cloudtalk_list_knowledge_bases

cloudtalk_create_knowledge_base

cloudtalk_list_voice_agent_tools

cloudtalk_assign_tool_to_voice_agent

cloudtalk_unassign_tool_from_voice_agent

cloudtalk_create_voice_agent_tool

cloudtalk_update_voice_agent_tool

Campaigns

cloudtalk_launch_campaign_from_source

cloudtalk_list_campaigns

cloudtalk_get_campaign

cloudtalk_get_campaign_statistics

cloudtalk_create_campaign

cloudtalk_update_campaign

cloudtalk_set_campaign_status

cloudtalk_delete_campaign

cloudtalk_get_campaign_associations

cloudtalk_replace_campaign_associations

Connection

cloudtalk_health_check

Account lookups

cloudtalk_list_agents

cloudtalk_list_groups

cloudtalk_list_numbers

cloudtalk_list_contact_tags