Capabilities

The tools Builder MCP exposes, grouped by what they do.

Builder MCP exposes PolyAI’s platform as MCP tools, grouped into the families below. Your client discovers them automatically on connection — you don’t configure tools by hand. Each tool carries its own input schema, which the client reads directly from the server.

US, UK, and EU workspaces expose 97 tools; self-serve Studio workspaces expose 91 (the Alerts family is enterprise-only). Tool names appear exactly as your client sees them in tools/list.

To see exactly what your client discovered, ask it to list its available tools, or query the endpoint’s tools/list method (see Quickstart → Verify).

Build & manage agents

Create agents and manage everything they contain. Workspace- and agent-scoped, backed by the Agents API.

Agents

Tool	What it does
create-agent	Create agent
list-agents	List agents
duplicate-agent	Duplicate agent
delete-agent	Delete agent

Behavior

Tool	What it does
get-agent-behavior-rules	Get agent behavior rules
update-agent-behavior-rules	Update agent behavior rules

Branches

Tool	What it does
create-branch	Create branch
list-branches	List branches
delete-branch	Delete branch
merge-branch	Merge branch
sync-branch-with-parent	Sync branch with parent

Deployments

Tool	What it does
publish-the-current-draft-to-an-environment	Publish the current draft to an environment
promote-a-deployment-to-the-next-environment	Promote a deployment to the next environment
rollback-to-a-previous-deployment	Rollback to a previous deployment
list-deployments-for-an-environment	List deployments for an environment
get-active-deployment-per-environment	Get active deployment per environment

Knowledge base

Tool	What it does
create-knowledge-base-topic	Create knowledge base topic
get-knowledge-base-topic	Get knowledge base topic
list-knowledge-base-topics	List knowledge base topics
update-knowledge-base-topic	Update knowledge base topic
delete-knowledge-base-topic	Delete knowledge base topic

Variants

Tool	What it does
create-variant	Create variant
list-variants	List variants
update-variant	Update variant
delete-variant	Delete variant

Attributes

Tool	What it does
create-attribute	Create attribute
list-attributes	List attributes
update-attribute	Update attribute
delete-attribute	Delete attribute

Connectors

Tool	What it does
get-a-connector-by-id	Get a connector by ID
batch-get-connectors-by-id	Batch get connectors by ID
list-all-connectors-for-a-project	List all connectors for a project
update-a-connector	Update a connector
batch-update-connectors	Batch update connectors
delete-a-connector-and-its-phone-numbers	Delete a connector and its phone numbers
look-up-connector-by-phone-number	Look up connector by phone number

Phone numbers

Tool	What it does
get-a-specific-phone-number	Get a specific phone number
batch-get-phone-numbers	Batch get phone numbers
list-all-phone-numbers-for-a-project	List all phone numbers for a project
import-a-single-phone-number	Import a single phone number
import-phone-numbers-into-a-project	Import phone numbers into a project
delete-a-single-phone-number	Delete a single phone number
delete-phone-numbers-from-a-project	Delete phone numbers from a project
reassign-a-phone-number-to-a-different-connector	Reassign a phone number to a different connector

Config pages (real-time config)

Tool	What it does
get-a-config-page-by-environment	Get a config page by environment
list-all-config-pages	List all config pages
update-config-variables-for-an-environment	Update config variables for an environment
upsert-the-json-schema-for-a-config-page	Upsert the JSON Schema for a config page

Voice & audio

Manage the voices an agent uses and the audio it caches.

Voice library

Tool	What it does
register-a-new-voice-in-the-voice-library	Register a new voice in the voice library
update-a-voice-in-the-voice-library	Update a voice in the voice library
get-a-single-voice-from-the-voice-library	Get a single voice from the voice library
list-all-voices-in-the-account-s-voice-library	List all voices in the account’s voice library
synthesize-a-short-audio-sample-of-a-voice	Synthesize a short audio sample of a voice
set-the-project-s-active-voice	Set the project’s active voice

Deployed voice configs

Tool	What it does
create-or-update-a-deployed-voice-configuration	Create or update a deployed voice configuration
list-deployed-voice-configurations	List deployed voice configurations
delete-a-deployed-voice-configuration	Delete a deployed voice configuration

Voice & disclaimer tuning

Tool	What it does
get-voice-tuning-settings	Get voice tuning settings
update-voice-tuning-settings	Update voice tuning settings
get-disclaimer-voice-tuning-settings	Get disclaimer voice tuning settings
update-disclaimer-voice-tuning-settings	Update disclaimer voice tuning settings

Audio cache

Tool	What it does
list-audio-cache-entries	List audio cache entries
delete-audio-cache-entry	Delete audio cache entry
bulk-delete-audio-cache-entries	Bulk delete audio cache entries
download-cached-audio-file	Download cached audio file
replace-audio-file-for-a-cache-entry	Replace audio file for a cache entry
update-cache-entry-file-and-settings	Update cache entry file and settings
generate-a-tts-audio-preview	Generate a TTS audio preview
preview-tts-audio-for-a-cache-entry	Preview TTS audio for a cache entry

Run, test & inspect

Exercise agents, place calls, and pull back the data they produce. Backed by the Debug Chat and Conversations APIs.

Debug chat

Tool	What it does
create-a-new-debug-chat-session	Create a new debug chat session
send-a-message-to-a-debug-chat-session	Send a message to a debug chat session

Conversations

Tool	What it does
get-a-conversation-by-id	Get a conversation by ID
list-conversations-for-a-project	List conversations for a project
get-audio-recording-for-a-conversation	Get audio recording for a conversation
add-annotations-to-a-conversation	Add annotations to a conversation
upsert-a-note-on-a-conversation	Upsert a note on a conversation

Test suites

Tool	What it does
trigger-a-test-run	Trigger a test run
get-a-test-run-by-id	Get a test run by ID
list-test-runs-for-a-project	List test runs for a project
list-test-cases	List test cases
get-test-case	Get test case
get-test-execution-history-for-a-project	Get test execution history for a project

Outbound calling

Tool	What it does
trigger-an-outbound-call	Trigger an outbound call
get-the-status-of-an-outbound-call	Get the status of an outbound call

Monitor deployed agents

Watch live agents and react to issues. Backed by the Alerts API.

Alerts

Tool	What it does
create-alert-rule	Create a new alert rule. The account_id is derived from the X-API-KEY header.
get-alert-rule	Get a specific alert rule by ID.
list-alert-rules	List alert rules with optional filters. Query params: enabled (filter by enabled status), metric (filter by metric type), project_id (filter by project ID), state (filter by current alert state — OK, ALERT, NO_DATA, or UNKNOWN).
update-alert-rule	Update an alert rule. Supports partial updates of alert rule attributes.
delete-alert-rule	Delete an alert rule and its associated state, including the Datadog monitor.
get-active-alerts	Get active alerts (rules currently in ALERT state). Optional query params: project_id (filter by project ID), metric (filter by metric type).

Manage agent infrastructure

Configure the plumbing behind an agent.

MCP servers on an agent

Tool	What it does
add-mcp-server	Add MCP server
list-mcp-servers	List MCP servers
connect-mcp-server	Connect MCP server
update-mcp-server	Update MCP server
delete-mcp-server	Delete MCP server

Secrets

Tool	What it does
create-a-secret	Create a secret
delete-a-secret	Delete a secret

Limiting what a client can do

To narrow what a client can reach, scope the API key itself. Create a least-privilege key limited to the agents and permissions that client needs — for example, a read-only key for a monitoring assistant. The key’s scope governs which calls succeed, so a narrowly scoped key can’t create, delete, or deploy even though the tools are still discovered.