Builder MCP exposes PolyAI’s platform as MCP tools, grouped into three areas. 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.
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). Agents
Create and manage agents and everything they contain. Backed by the Agents API.
| Tool | Description | Key inputs |
|---|
list_agents | List agents in the workspace | — |
create_agent | Create a new agent | name, response settings |
create_branch | Branch an agent for isolated edits | agent_id, name |
merge_branch | Merge a branch back | agent_id, branch_id |
update_behavior | Update agent behavior rules | agent_id, rules |
manage_knowledge_base | Create, update, and delete KB topics | agent_id, topic |
manage_variants | Manage variant attributes and variants | agent_id, variant |
Data
Retrieve conversation data to test and inspect agents. Backed by the Data API.
| Tool | Description | Key inputs |
|---|
list_conversations | List conversations for an agent | agent_id, filters |
get_conversation | Fetch a conversation by ID | conversation_id |
debug_chat | Start a debug chat session to test an agent | agent_id, environment |
Alerts
Monitor deployed agents. Backed by the Alerts API.
| Tool | Description | Key inputs |
|---|
create_alert_rule | Create an alert rule | rule definition |
list_alert_rules | List configured alert rules | — |
list_active_alerts | Read currently firing alerts | — |
tools query parameter on the endpoint URL:
https://api.us.poly.ai/builder-mcp?tools=list_agents,create_branch
Last modified on July 7, 2026
