workflows-mcp

Create a new workflow with specified steps and configuration.

WORKFLOW STRUCTURE:

• name: Descriptive workflow name

• description: What the workflow accomplishes

• goal: The end result or outcome

• version: Semantic version (default: "1.0.0")

• tags: Array of categorization tags

• inputs: Object defining input parameters with type, description, required, and optional default

• outputs: Array of expected output variable names

• required_tools: Array of MCP tools this workflow needs

• steps: Array of workflow steps (see below)

• strict_dependencies: Boolean to enable strict dependency mode (default: false)

  • false: Steps without dependencies see all variables (backward compatible)

  • true: Steps without dependencies see NO variables (must explicitly declare dependencies)

AVAILABLE ACTIONS:

• tool_call: Execute an MCP tool (requires tool_name and parameters)

• analyze: Analyze data and extract insights

• consider: Evaluate options or possibilities

• research: Gather information on a topic

• validate: Check data quality or correctness

• summarize: Create a summary of information

• decide: Make a decision based on criteria

• wait_for_input: Request user input (requires prompt)

• transform: Transform data (requires transformation description)

• extract: Extract specific information

• compose: Create new content

• branch: Conditional branching (requires conditions array)

• checkpoint: Save progress checkpoint

• notify: Send a notification (requires message)

• assert: Verify a condition (requires condition)

• retry: Retry a previous step (requires step_id)

STEP STRUCTURE: { "id": 1, // Sequential number starting from 1 "action": "action_type", "description": "What this step does", "save_result_as": "variable_name", // Optional: save result "error_handling": "stop|continue|retry", // Default: "stop" "dependencies": [1, 3], // Optional: only show outputs from these step IDs "show_all_variables": true, // Optional: override to show all variables

// For tool_call: "tool_name": "mcp_tool_name", "parameters": { "param": "value" },

// For cognitive actions (analyze, consider, research, etc): "input_from": ["variable1", "variable2"], // Input variables "criteria": "Specific criteria or focus", // Optional

// For branch: "conditions": [ { "if": "variable.property > value", "goto_step": 5 } ],

// For wait_for_input: "prompt": "Question for the user", "input_type": "text|number|boolean|json",

// For transform: "transformation": "Description of transformation" }

TEMPLATE VARIABLES: Use {{variable_name}} in any string field to reference:

• Input parameters from workflow inputs

• Results saved from previous steps via save_result_as

• Any variables in the workflow state

EXAMPLES:

• "path": "output_{{format}}.txt"

• "prompt": "Process {{count}} items?"

• "description": "Analyzing {{filename}}"

DEPENDENCY MANAGEMENT:

• Use "dependencies" array to specify which previous steps' outputs are needed

• In strict_dependencies mode, steps without dependencies see NO variables

• Steps with dependencies only see outputs from those specific steps + workflow inputs

• Use "show_all_variables": true to override and see all variables for a specific step

PERFORMANCE FEATURES:

• Only relevant variables are shown based on dependencies (reduces token usage)

• Variable changes are highlighted (+ for new, ~ for modified)

• Only next 3 steps are previewed (progressive loading)

BEST PRACTICES:

1. Each step should have a single, clear responsibility

2. Use descriptive variable names for save_result_as

3. Consider error handling for each step (stop, continue, or retry)

4. Branch conditions should cover all cases

5. Order steps logically with proper dependencies

6. Use strict_dependencies for workflows with large/verbose outputs

7. Explicitly declare dependencies to minimize context and improve performance

List all workflows with optional filtering and sorting

Get a specific workflow by ID

Update an existing workflow with optional version increment

Soft delete a workflow (can be recovered)

Start a workflow execution session with step-by-step control

Execute the next step in an active workflow session.

IMPORTANT: When executing workflow steps, follow these rules:

1. DO NOT provide commentary between workflow steps unless explicitly requested

2. Simply execute each step according to the workflow instructions

3. Move immediately to the next step after completing the current one

4. Only provide output when the workflow specifically requires it (e.g., notify actions, final results)

5. Focus solely on executing the workflow actions as defined

The tool will provide step-by-step instructions that should be followed exactly.

List all available versions of a workflow

Rollback a workflow to a previous version