> For a complete page index, fetch https://docs.synthflow.ai/llms.txt. For full documentation content, fetch https://docs.synthflow.ai/llms-full.txt.

# MCP Server

> Connect Claude, ChatGPT, Codex, and other MCP-capable clients to Synthflow so you can manage agents, calls, and knowledge bases from your preferred tool.

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](/anthropic) guide. For ChatGPT and Codex, see the [OpenAI](/openai) guide.

## Server URLs

The MCP server runs in three regions. Point your client at the URL that matches your workspace [region](/customer-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](/customer-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](/create-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](/version-control) 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](/voice-configuration) with language and accent details. |

### Calls

| Tool                 | Description                                            |
| :------------------- | :----------------------------------------------------- |
| `list_calls`         | List recent or matching [calls](/logs).                |
| `get_call_details`   | Retrieve the details for a specific call.              |
| `get_call_analytics` | Retrieve [analytics](/collect-analytics) across calls. |
| `start_test_call`    | Start a test call with an agent.                       |

### Actions

| Tool                       | Description                                                       |
| :------------------------- | :---------------------------------------------------------------- |
| `list_actions`             | List the [actions](/actions-overview) 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](/knowledge-base) 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](/simulations) 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](/phone-numbers) in the workspace.                             |
| `attach_phone_numbers_to_agent_pooling`  | Add numbers to an outbound agent's [number pool](/outbound-number-pooling).            |
| `detach_phone_number_from_agent_pooling` | Remove a number from an outbound agent's number pool.                                  |
| `list_phone_books`                       | List [phone books](/call-transfers#phonebook-transfers) 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](/create-a-subaccount) under the current account.   |
| `list_integrations`      | List connected [integrations](/about-integrations).                       |
| `list_webhook_logs`      | List [webhook](/webhooks) 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](/aurora#learnings) 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](#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](/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](/aurora#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](/mcp-actions) 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**.