Execute MCP tool
POST
Execute MCP tool

Authorizations

Authorization
string
header
required

Voiceflow bearer token

Path Parameters

toolID
string
required

Query Parameters

projectID
string
required

The ID of the project to operate on.

environmentAlias
string
required

The alias of the environment to operate on (e.g. main).

Body

inputs
object

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

200 - application/json

Returns what the MCP server answered, with success, latencyMs, and error fields. Secret values read [secret] wherever they appear.

success
boolean
required

Whether the tool ran and reported no error.

latencyMs
number
required

How long the run took, in milliseconds, measured by this API around the call.

error
string
required

Why the run failed when success is false, otherwise null. Secret values read [secret].

truncated
boolean
required

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.

output
any
required

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].

Use the up and down arrow keys to select a result, Enter to open it, and Escape to close the search.