Voiceflow bearer token
MCP Servers
Connect your agent to tools on an MCP server.
See Authentication for credentials and permissions.
Legacy - 2026/07
Returns every MCP server in the environment. A MCP server is a registered Model Context Protocol server whose tools an agent can call. The call takes no paging parameters, so one request yields the whole set.
Authentication
Query parameters
The ID of the project to operate on.
The alias of the environment to operate on (e.g. main).
Response
Returns every MCP server connected to the project's environment, each with its URL, description, icon, and the MCP specification version it was registered against.
Legacy - 2026/07
Adds a MCP server to the environment, a registered Model Context Protocol server whose tools an agent can call. The response carries the ID that later calls address it by.
Authentication
Voiceflow bearer token
Query parameters
The ID of the project to operate on.
The alias of the environment to operate on (e.g. main).
Request body
A human-readable description of what the MCP server provides.
Response
Creates the connection to the MCP server and returns it with its generated ID, URL, and specification version. The tools the server exposes are read through the MCP tool endpoints.
Current - 2026/09
Returns every MCP server in the environment. An MCP server is a registered Model Context Protocol server whose tools an agent can call; header values read back as [redacted]. The call takes no paging parameters, so one request yields the whole set.
Authentication
Voiceflow bearer token
Query parameters
The ID of the project to operate on.
The alias of the environment to operate on (e.g. main).
Response
Returns every MCP server connected to the project's environment, each with its URL, description, icon, and the MCP specification version it was registered against.
Current - 2026/09
Adds an MCP server to the environment, a registered Model Context Protocol server whose tools an agent can call. The URL and header values are plain strings that can reference a project secret as {secret_name}, and the response carries the ID that later calls address it by.
Authentication
Voiceflow bearer token
Query parameters
The ID of the project to operate on.
The alias of the environment to operate on (e.g. main).
Request body
A human-readable description of what the MCP server provides.
Plain text resolved at runtime and never shown to a model. {variable_name} inserts a variable or entity, {secret_name} a project secret, {variable_name.path} a field of a variable. Escape a literal { or \ with a backslash. When a name is both a variable and a secret, the secret wins. A name matching none is stored as literal text and reported in unresolvedReferences. Where the field is sent to an upstream system, an unresolved placeholder may be sent as literal text; on an MCP server it is re-resolved by name at connect time, so a literal that matches a real secret binds.
Response
Creates the connection to the MCP server and returns it with its generated ID, URL, and specification version. The tools the server exposes are read through the MCP tool endpoints.
References this write kept as literal text instead of binding, each with the reason. The write still succeeded.
Legacy - 2026/07
Returns a single MCP server by ID, with the fields that define it. A MCP server is a registered Model Context Protocol server whose tools an agent can call.
Authentication
Voiceflow bearer token
Path parameters
The ID of the MCP server to operate on.
Query parameters
The ID of the project to operate on.
The alias of the environment to operate on (e.g. main).
Response
Returns one MCP server's stored configuration: its name, URL, description, icon, and specification version.
Legacy - 2026/07
Changes an existing MCP server in place. The response carries only a confirmation message, so refetch the MCP server to read its new values.
Authentication
Voiceflow bearer token
Path parameters
The ID of the MCP server to operate on.
Query parameters
The ID of the project to operate on.
The alias of the environment to operate on (e.g. main).
Request body
A human-readable description of what the MCP server provides.
Response
Confirms the server's connection details were updated. The body is a message only, so refetch the server to read its current URL, description, and specification version.
A human-readable message confirming the update.
Deletes a single MCP server by ID. A MCP server is a registered Model Context Protocol server whose tools an agent can call. The response carries only a confirmation message, so refetch the MCP servers to see what is left.
Authentication
Voiceflow bearer token
Path parameters
The ID of the MCP server to operate on.
Query parameters
The ID of the project to operate on.
The alias of the environment to operate on (e.g. main).
Response
Confirms the MCP server connection was removed from the project. The body is a message only, so refetch the project's MCP servers and tools to see what is left.
A human-readable message confirming the deletion.
Current - 2026/09
Returns a single MCP server by ID, with the fields that define it. An MCP server is a registered Model Context Protocol server whose tools an agent can call; its header values read back as [redacted].
Authentication
Voiceflow bearer token
Path parameters
The ID of the MCP server to operate on.
Query parameters
The ID of the project to operate on.
The alias of the environment to operate on (e.g. main).
Response
Returns one MCP server's stored configuration: its name, URL, description, icon, and specification version.
Current - 2026/09
Changes an existing MCP server in place, taking URL and header values as plain strings that can reference a project secret as {secret_name}. The response lists any references that did not resolve; read the server again to see its new values.
Authentication
Voiceflow bearer token
Path parameters
The ID of the MCP server to operate on.
Query parameters
The ID of the project to operate on.
The alias of the environment to operate on (e.g. main).
Request body
A human-readable description of what the MCP server provides.
Response
Confirms the server's connection details were updated. The body is a message only, so refetch the server to read its current URL, description, and specification version.
A human-readable message confirming the update.
References this write kept as literal text instead of binding, each with the reason. The write still succeeded.
Refreshes the stored list of tools an MCP server advertises, which is how MCP tools come to exist rather than being created by hand.
Authentication
Voiceflow bearer token
Path parameters
The ID of the MCP server to operate on.
Query parameters
The ID of the project to operate on.
The alias of the environment to operate on (e.g. main).
Response
Confirms the sync ran against the server. The body is a message and does not itemise what changed, so list the project's MCP tools to see the server's current set.
A human-readable message confirming the update.