Skip to content

mcp_pipeline

Category: meta

Execute a sequence of MCP tool calls in one request. Variables from earlier steps interpolate into later steps via \{\{step_id.path\}\}.

when a workflow needs ≥2 sequential calls (e.g., list channels → find by name → send message). Reduces N round-trips to 1.

parallel-safe independent calls — issue them as separate tools/call requests. Long-running batch ops — use the dedicated bulk tool (Plan 7+) so each operation can fail independently.

FieldTypeRequiredDescription
stepsarrayyesOrdered steps. Max 20 per pipeline.

\{steps:[\{id, tool, status, result?, error?, duration_ms\}], variables, total_duration_ms, aborted\}. Each step status is success | error | skipped.

FieldTypeRequiredDescription
stepsarrayyes
variablesobjectyes
total_duration_msnumberyes
abortedbooleanyes
PropertyValue
Read-onlyno
Destructiveno
Idempotentno
Open-worldyes
Confirmation requiredno

packages/mcp-core/src/tools/meta/pipeline.ts