MCP Server | Synthflow

The Synthflow MCP server lets you use Synthflow directly from the AI tools you already prefer, such as Claude, Claude Desktop, ChatGPT, and Codex. Describe what you want in plain language to build agents, review calls, manage knowledge bases, and more, without leaving that tool.

Setup differs by client. For Claude and Claude Code, see the Anthropic guide. For ChatGPT and Codex, see the OpenAI guide.

Server URLs

The MCP server runs in three regions. Point your client at the URL that matches your workspace region:

Region	MCP URL
Global	`https://mcp.synthflow.ai/mcp`
United States	`https://mcp.us.synthflow.ai/mcp`
European Union	`https://mcp.eu.synthflow.ai/mcp`

The server URL and your workspace must be in the same region. A mismatch, such as the EU URL with a US workspace, stops the connection from working.

Supported tools

Your client discovers the tool list when it connects. The tables below group the tools by what they manage, using the exact tool names your client will show.

Every tool runs against the workspace you connected. Tools that accept a workspace_id can target a subaccount instead, so agency admins can work across the accounts they manage from one connection.

Many of these tools write to your live workspace. delete_agent, delete_action, delete_knowledge_base, batch_update_agents_by_filter, and rollback_agent_version take effect as soon as they run. Keep write and delete tools behind approval in your client and review each call before you allow it.

Agents and voices

Tool	Description
`list_agents`	List agents in scope, with optional filters and pagination.
`get_agent`	Retrieve the full configuration for one agent by `model_id`.
`create_agent`	Create an inbound, outbound, or widget agent from a template.
`update_agent`	Save configuration changes to an agent as a draft.
`publish_agent_draft`	Publish the current draft so the changes go live.
`delete_agent`	Permanently delete an agent.
`search_agents_by_prompt`	Find agents whose prompt contains, or does not contain, given text.
`batch_update_agents_by_filter`	Apply the same field change to every agent matching a filter.
`list_agent_versions`	List an agent’s published versions plus the current draft.
`get_agent_version_diff`	Compare two agent versions field by field.
`rollback_agent_version`	Restore a previously published version.
`list_voices`	List available voices with language and accent details.

Calls

Tool	Description
`list_calls`	List recent or matching calls.
`get_call_details`	Retrieve the details for a specific call.
`get_call_analytics`	Retrieve analytics across calls.
`start_test_call`	Start a test call with an agent.

Actions

Tool	Description
`list_actions`	List the actions in the workspace.
`get_action`	Retrieve one action’s configuration.
`initialize_action`	Scaffold a new action before you configure it.
`create_action`	Create an action.
`update_action`	Update an existing action’s configuration.
`delete_action`	Delete an action.
`attach_action_to_agent`	Attach an action to an agent.
`detach_action_from_agent`	Remove an action from an agent.
`get_agent_actions`	List the actions attached to an agent.
`test_api_call`	Send a test request for a custom action and inspect the response.

Knowledge bases

Tool	Description
`list_knowledge_bases`	List the knowledge bases in the workspace.
`get_knowledge_base`	Retrieve a knowledge base and its items.
`create_knowledge_base`	Create a knowledge base.
`delete_knowledge_base`	Delete a knowledge base.
`add_knowledge_base_item`	Add an item to a knowledge base.
`add_knowledge_base_files`	Upload files into a knowledge base.
`delete_knowledge_base_items`	Remove items from a knowledge base.
`attach_knowledge_base_to_agent`	Attach a knowledge base to an agent.
`detach_knowledge_base_from_agent`	Remove a knowledge base from an agent.
`get_agent_knowledge_base`	Retrieve the knowledge base attached to an agent.

Simulations

Tool	Description
`list_simulation_suites`	List simulation suites.
`create_simulation_suite`	Create a simulation suite.
`delete_simulation_suite`	Delete a simulation suite.
`list_simulation_cases`	List the test cases in a suite.
`create_simulation_case`	Create a simulation test case.
`delete_simulation_case`	Delete a simulation test case.
`execute_simulation_suite`	Run a simulation suite against an agent.
`list_simulations`	List simulation runs.
`get_simulation_session`	Retrieve one simulation session and its results.

Phone numbers and contacts

Tool	Description
`list_phone_numbers`	List the phone numbers in the workspace.
`attach_phone_numbers_to_agent_pooling`	Add numbers to an outbound agent’s number pool.
`detach_phone_number_from_agent_pooling`	Remove a number from an outbound agent’s number pool.
`list_phone_books`	List phone books used as transfer destinations.
`get_phone_book`	Retrieve a phone book and its entries.
`create_phone_book`	Create a phone book.
`update_phone_book`	Update a phone book’s entries or routing conditions.
`delete_phone_book`	Delete a phone book.
`list_contacts`	List contacts.
`create_contact`	Create a contact.

Workspace and diagnostics

Tool	Description
`list_subaccounts`	List the subaccounts under the current account.
`list_integrations`	List connected integrations.
`list_webhook_logs`	List webhook delivery logs.
`get_webhook_log_detail`	Retrieve the request and response for one webhook delivery.
`search_docs`	Search the Synthflow documentation.
`fetch_url`	Fetch the contents of a URL.
`save_learning`	Save a workspace-level learning for future sessions.
`get_more_tools`	Check whether additional tools are available for the current task.

FAQ

Where do I see the tool list for my own connection?

Your client lists the tools it loaded from the server, usually in its MCP or connector settings. Supported tools mirrors that list. If your client caches tool definitions, reconnect the server to pick up newly released tools.

How is this different from Aurora?

Aurora is the in-dashboard agent: one chat thread in the Synthflow UI with Memory, Learnings, and rich UI cards. The Synthflow MCP server runs in your preferred AI client and manages the workspace you connect. Both draw on the same capabilities, though Aurora adds tools that only make sense in the dashboard, such as rendering tables and version diffs.

How is this different from MCP Connectors?

MCP Connectors let a voice agent call tools on an external MCP server during a live call. The Synthflow MCP server is the opposite direction: an AI tool calls Synthflow to manage your workspace.