Voiceflow bearer token
MCP Tools
Give your agent access to a tool through MCP.
See Authentication for credentials and permissions.
Returns every MCP tool in its server. A MCP tool is a tool an MCP server advertises, populated by syncing the server rather than by hand. 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).
When provided, only tools belonging to the MCP server with this ID are returned.
Response
Returns every MCP tool available in the project's environment, each with the name, description, and input JSON Schema its server declared, plus the ID of the server it came from. Pass serverID to narrow the list to one server.
Returns a single MCP tool by ID, with the fields that define it. A MCP tool is a tool an MCP server advertises, populated by syncing the server rather than by hand.
Authentication
Voiceflow bearer token
Path parameters
The ID of the tool 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 tool with the name and description its server declared and the JSON Schema for its input arguments. MCP tools are defined on the server itself, so these records are read-only in Voiceflow.
Returns the arguments an MCP tool takes, both as a flat list of its top-level arguments and as its full JSON Schema. Call it before executing so the arguments match the tool's types.
Authentication
Voiceflow bearer token
Path parameters
The ID of the MCP tool whose arguments to read.
Query parameters
The ID of the project to operate on.
The alias of the environment to operate on (e.g. main).
Response
Returns the ID of the MCP server the tool belongs to, its top-level arguments, and its full JSON Schema.
The ID of the MCP server the tool belongs to.
The tool's top-level arguments, read from its JSON Schema.
The tool's full JSON Schema, for nested arguments the flat list cannot show.
Calls one MCP tool on its server with the arguments in the body, using the server's saved URL, headers, and authorization. No conversation is involved.
Authentication
Voiceflow bearer token
Path parameters
The ID of the MCP tool to execute.
Query parameters
The ID of the project to operate on.
The alias of the environment to operate on (e.g. main).
Request body
The tool's arguments, keyed by argument name and typed as its JSON Schema says; see get_schema. A top-level string value follows the ExecuteInputString rules, so {secret_name} inserts a project secret. Secrets work only at the top level: inside a nested object or array, {secret_name} is sent as written and no secret is filled in.
Response
Returns what the MCP server answered, with success, latencyMs, and error fields. Secret values read [secret] wherever they appear.
Whether the tool ran and reported no error.
How long the run took, in milliseconds, measured by this API around the call.
Why the run failed when success is false, otherwise null. Secret values read [secret].
Whether a returned payload was over 64 KB and was cut to its first 64 KB of JSON text, which then arrives as a string.
What the MCP server returned. A result with isError: true fails the run and keeps this output. Null when the call itself failed or did not answer in time. Secret values read [secret].