MCP server endpoint
ALL /projects/:projectid/workflows/:workflowid/mcp
Expose a workflow to an AI agent as a tool server.
Speaks the Model Context Protocol over streamable HTTP. Point an MCP-capable agent at this URL with a project API key. The workflow declares its own tools — see the Workflows as MCP tools guide.
Authentication
- Project API key: The credential for everything external. Created in Project Settings, bound to one project, and limited to the scopes it was granted. Format:
proj.<keyId>.<secret>. - Required permission:
workflows.runon :workflowid.
Path parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
projectid | string | Yes | - | The project id. |
workflowid | string | Yes | - | The workflow acting as the server. |
Responses
200
An MCP protocol response.
403
The key lacks run permission on this workflow.
500
The workflow did not return a usable server config.