MCP tools

The MCP server exposes tools grouped by product area. The list below is the reading reference; the authoritative list is the one the server returns to your client (tools/list) — it varies according to your profile and the features enabled in the company.

A tool outside your profile simply doesn't appear: there is no call that bypasses the permission.

Conversations

Tool	What it does
list_open_conversations	Conversations awaiting response / open, with filters by tag, unread, and date
list_archived_conversations	Archived conversations
list_finished_conversations	Finished conversations
search_inbox	Search across conversations, contacts, and messages
get_conversation_details	Conversation data: channel, queue, agent, tags, state
get_conversation_history	Message history of the conversation
take_conversation	Takes the conversation for the user
transfer_conversation	Transfers to another queue or agent, with a note
finish_conversation	Finishes the service; ad conversations require classification
reopen_conversation	Reopens a finished conversation
update_conversation	Marks read/unread, archives, mutes, pins
update_conversation_tags	Applies and removes tags
list_transfer_targets	Queues and agents to transfer to
recalculate_cx_score	Recalculates the CX Score of a finished conversation

Messages and media

Tool	What it does
send_message	Sends text in the conversation
send_template	Sends an approved template (with variables)
send_media	Sends media (base64, up to 2 MB)
get_message_media	Retrieves the media of a message
list_conversation_media	Lists the conversation's media
update_message	Edits the content of a message
react_to_message	Reacts to a message
cancel_scheduled_message	Cancels a scheduled template
list_starred_messages	Messages marked with a star
list_templates	Approved templates of the conversation's channel
start_conversation	Starts a new conversation (channel + identifier)

Contacts and notes

Tool	What it does
search_contacts	Searches contacts
get_contact	Contact record
create_contact / update_contact / delete_contact	Contact CRUD
import_contacts	Imports contacts in bulk from CSV
find_contact_matches	Looks for duplicate contacts before creating
list_contact_owners / transfer_contact_owner	Owners and owner transfer
convert_conversation_to_contact	Converts the conversation into a CRM contact
unlink_conversation_contact	Unlinks the conversation from the contact
rename_conversation_contact	Renames the contact from the conversation
add_contact_note / list_contact_notes	Internal notes about the contact

CRM (accounts and opportunities)

Tool	What it does
search_accounts, get_account, create_account, update_account, delete_account	Account CRUD
list_account_owners, transfer_account_owner	Owners and transfer
search_opportunities, get_opportunity, create_opportunity, update_opportunity, delete_opportunity	Opportunity CRUD
transfer_opportunity_owner	Owner transfer
list_opportunity_stages, create_opportunity_stage, update_opportunity_stage, delete_opportunity_stage, reorder_opportunity_stages	Funnel cycle and stages

Campaigns

Tool	What it does
list_campaigns / get_campaign	List and detail
create_campaign / update_campaign / update_campaign_details	Assembly and editing
delete_campaign	Deletes (respecting the state)
dispatch_campaign	Dispatches a draft
cancel_campaign	Cancels a scheduled campaign
mark_campaign_winner	Marks the winning A/B variant
get_campaign_dashboard	Campaign metrics
list_campaign_channels / list_campaign_templates	Available channels and templates
list_campaign_audience_reports / preview_campaign_audience_report	Reports eligible as audience
upload_campaign_audience_csv	Uploads the audience by CSV

Reports and views

Tool	What it does
list_reports, run_report	Lists and runs reports
describe_report_type	Available types and fields
create_report, update_report, delete_report	Report CRUD
get_report_config, save_report_config	Reading and writing the configuration (columns, groups, filters)
get_report_shares, share_report	Sharing
describe_view_fields	Valid fields, operators, and columns per screen
list_views, create_view, update_view, delete_view	Views
run_view	Runs a view

Settings and platform

Tool	What it does
whoami	User, company, role, and enabled features
list_users, create_user, list_roles	Users and roles
create_role, update_role	Access roles
list_channels	Connected channels
list_custom_fields, create_custom_field, update_custom_field, delete_custom_field	Custom fields
list_agent_workspaces, update_agent_workspace	AI agents per channel
get_company_features, update_company_features	Company features
get_entity_labels, update_entity_labels	Entity names

Errors and what to do

Rejections come with a fix hint in text, in addition to the code. Some examples:

Code	Hint
session_assigned_to_other	The conversation belongs to someone else — call take_conversation first
session_expired_template_required	24-hour window closed — use list_templates and send_template
session_closed	Finished conversation — use reopen_conversation
unknown_tag	The tag doesn't exist — check with the tag listing
too_many_rows	Split into batches of up to 5,000 contacts
validation_error	The fields with problems come in the error detail

The code catalog is the same one used by the internal API — the assistant receives the instruction, not just the failure.