Getting Started
Authentication
Authentication
  • V2 Authentication (Deprecated)
  • V3 Authentication
V2 API Documentation (Deprecated)V3 API DocumentationDialer SDKMCP
Getting Started
Authentication
Authentication
  • V2 Authentication (Deprecated)
  • V3 Authentication
V2 API Documentation (Deprecated)V3 API DocumentationDialer SDKMCP
  1. MCP
  • Convirza MCP Server
  • Quickstart
  • Authentication & Access
  • Tools Reference
  • Example Prompts
  • Troubleshooting
  1. MCP

Tools Reference

The server has 115 tools (October 2026). You never call them by name: describe what you want and your assistant picks the tool. This page shows what's available so you know what to ask for.
Some tools read: get_*, list_*, search and fetch. Others change something: create_*, update_*, replace_*, delete_* and a few named actions such as upload_call. Which ones your role can run is described in Authentication & Access.

Start here: search and fetch#

ToolWhat it does
searchSearch the whole account in one call (users, groups, campaigns, tracking numbers, AI voice agents and calls) by name, email or phone number
fetchRetrieve one search result in full by its ID

Calls and analytics#

ToolWhat it does
get_callsList calls with filters such as date, group, campaign, number, caller or outcome
get_callOne call in full: recording, transcript, summary and Conversation Analytics® scorecard
upload_callUpload an mp3 or wav recording so it is stored, transcribed and scored like a live call. See Example Prompts
get_sms_conversationsSMS conversation history
get_agent_performanceAgent performance analytics
get_attribution_engineWhich campaigns and sources drove calls and conversions
get_opportunity_recoveryMissed and recoverable opportunities

Campaigns#

ToolWhat it does
list_campaigns, get_campaignBrowse and inspect campaigns
create_campaign, update_campaign, replace_campaign, delete_campaignManage campaigns
move_campaignMove a campaign to another group

Users and groups#

ToolWhat it does
get_my_profileYour own user, role and group
list_users, get_userBrowse and inspect users
create_user, update_user, replace_user, delete_userManage users
send_password_reset_emailSend a user a password reset email
list_groups, get_group, get_group_tree, get_group_org_listBrowse the organization structure
create_group, update_group, replace_group, delete_groupManage groups

Phone numbers and routing#

ToolWhat it does
search_phone_numbersFind available numbers to order
add_tracking_numberAdd a number from search_phone_numbers to your account. Route it with create_provisioned_route so it takes calls
get_provisioned_numbers, get_assigned_numbersNumbers you own and where they are assigned
delete_phone_numberRelease a number
list_provisioned_routes, get_provisioned_routeCall routing
create_provisioned_route, patch_provisioned_route, replace_provisioned_route, delete_provisioned_routeManage routing
move_provisioned_routeMove a tracking number to another campaign
list_geo_locations, get_geo_location, create_geo_location, update_geo_location, replace_geo_location, delete_geo_locationGeo-location routing targets
list_location_routes, get_location_route, create_location_route, update_location_route, replace_location_route, delete_location_routeLocation-based routes
list_dni_settings, create_dni_setting, update_dni_setting, delete_dni_settingDynamic number insertion for websites
get_dni_snippetThe script to add to your website for dynamic number insertion

Scoring and insights#

ToolWhat it does
list_scorecards, create_scorecard, duplicate_scorecard, archive_scorecardConversation Analytics® scorecards
get_scorecard_summaryAverage scores by group or agent, and by scorecard criterion
add_call_titleTitle a call
list_insights, get_insight, create_insight, delete_insightInsights
list_custom_insights, get_custom_insight, create_custom_insight, update_custom_insight, replace_custom_insight, delete_custom_insightCustom insights
create_call_action_template, update_call_action_templateCall action templates

AI voice agents and SMS broadcasts#

ToolWhat it does
list_ai_agents, get_ai_agent, delete_ai_agentReview and retire AI voice agents. Create and edit agents in the Convirza app
list_broadcasts, get_broadcast, create_broadcast, update_broadcast, replace_broadcast, cancel_broadcast_scheduleSMS broadcasts

Integrations#

ToolWhat it does
list_webhooks, get_webhook, create_webhook, update_webhook, replace_webhook, delete_webhookWebhooks
list_subscriptions, create_subscription, delete_subscriptionEvent subscriptions
list_oauth_credentials, get_oauth_credential, create_oauth_credentials, rotate_oauth_secret, delete_oauth_credentialAPI keys for your own integrations. The secret is shown through a one-time link

Account utilities#

ToolWhat it does
list_tags, create_tag, update_tag, delete_tagTags
list_blacklist, add_to_blacklist, delete_from_blacklist, bulk_delete_blacklistBlocked numbers. bulk_delete_blacklist clears a group's whole list in one call, so check before you approve it
list_media_prompts, get_media_prompt, delete_media_promptAudio prompts, whispers and voicemail greetings
list_ad_sources, list_industriesReference lists

Starter prompts#

The server also ships 22 ready-made workflows as MCP prompts. Clients that support MCP prompts list them, often as slash commands. See Example Prompts.

Tool names are exactly as the server exposes them. If your assistant can list a server's tools, you'll see these names there.
Modified at 2026-10-29 13:43:09
Previous
Authentication & Access
Next
Example Prompts
Built with