Structured Workflow

Structured Workflow MCP Server enforces disciplined, phase-driven problem solving for AI assistants. It guides you through defined workflow lanes (setup, audit, analysis, planning, implementation, testing, and more) with mandatory outputs, automatic saving, and progress tracking to prevent skipping steps and ensure verifiable results.

How to use

You integrate the Structured Workflow MCP Server with your MCP client to run AI-driven workflows. Start a workflow using one of the entry tools, let the server provide phase guidance, generate phase-specific outputs, and let the server validate progress before moving to the next phase. The server maintains session state so you cannot skip phases and continually iterates through the defined workflow until all phases are complete.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine.

Quick Start (Zero Installation) — Add to your AI assistant config using npx automatically. Use the latest features to avoid caching older versions.

{
  "mcp": {
    "servers": {
      "structured-workflow": {
        "command": "npx",
        "args": ["structured-workflow-mcp@latest"],
        "env": {}
      }
    }
  }
}

Additional installation options

Claude Desktop and other MCP clients can configure the server similarly by specifying the command and arguments for starting the MCP server.

{
  "mcpServers": {
    "structured-workflow": {
      "command": "npx",
      "args": ["structured-workflow-mcp@latest"],
      "env": {}
    }
  }
}

Global installation (optional)

You can install the MCP server globally with npm and reference it in your AI assistant configuration.

npm install -g structured-workflow-mcp

{
  "mcp": {
    "servers": {
      "structured-workflow": {
        "command": "structured-workflow-mcp",
        "args": [],
        "env": {}
      }
    }
  }
}

Auto-install via Smithery

You can install directly into apps like Claude Desktop using Smithery.

npx -y @smithery/cli install structured-workflow-mcp --client claude

Available tools

refactor_workflow

Start a structured refactoring workflow with required analysis and planning phases.

create_feature_workflow

Develop new features with integrated testing and documentation requirements.

test_workflow

Add test coverage workflows with mandatory analysis of what needs testing.

tdd_workflow

Implement Test-Driven Development with enforced Red-Green-Refactor cycles.

build_custom_workflow

Create workflows with custom phases and validation requirements.

audit_inventory_guidance

Forces thorough code analysis and change cataloging for each phase.

compare_analyze_guidance

Requires evaluating multiple approaches with pros and cons.

question_determine_guidance

Mandates clarification and finalized planning before implementation.

phase_output

Validates and records structured outputs from each phase.

workflow_status

Checks current progress and validation state of the active workflow.