Workflow Orchestration MCP Server

Multi-step workflow orchestration for AI agents — define workflows with typed steps, run instances, manage approvals, track execution history. 13 tools with seeded demo workflows.

Architecture

Tools (13)

Definitions (3)

| Tool | Purpose | Risk | |------|---------|------| | list_workflows | List all workflow definitions | read_only | | get_workflow | Get workflow with all steps | read_only | | create_workflow | Create a new workflow | internal_write |

Instances (6)

| Tool | Purpose | Risk | |------|---------|------| | start_workflow | Start a new instance | internal_write | | list_instances | List instances (filter by status) | read_only | | get_instance | Get instance details + context | read_only | | advance_step | Advance to next step | internal_write | | cancel_instance | Cancel a running instance | internal_write | | retry_instance | Retry a failed instance | internal_write |

Approvals (2)

| Tool | Purpose | Risk | |------|---------|------| | list_approvals | List pending approvals | read_only | | resolve_approval | Approve or reject | internal_write |

Observability (2)

| Tool | Purpose | Risk | |------|---------|------| | get_history | Get execution history | read_only | | get_stats | Running/waiting/completed counts | read_only |

Step Types

| Type | Behavior | |------|----------| | Action | Execute a task, auto-advance | | Approval | Pause until approved/rejected | | Condition | Branch based on context | | Notification | Send notification, auto-advance | | Wait | Pause for external event |

Installation

cargo install mcp-workflow

Configuration

No configuration needed — starts with 3 demo workflows:

• Employee Onboarding — IT setup → Manager approval → Welcome email
• Production Deployment — Tests → Security scan → Lead approval → Deploy → Notify
• Expense Approval — Submit → Manager review → Finance approval → Reimburse

Client Configuration

Claude Desktop / Kiro / Cursor

{
  "mcpServers": {
    "workflow": {
      "command": "mcp-workflow",
      "args": []
    }
  }
}

Usage Examples

Start an onboarding workflow

"Start the employee onboarding workflow for Frank in Engineering"
→ start_workflow(workflow_id="wf-onboard", context={"employee": "Frank", "department": "Engineering"})

Approve a pending request

"Approve the pending manager approval"
→ list_approvals → resolve_approval(approval_id="apr-1", approved=true)

Create a custom workflow

"Create a bug fix workflow: fix code → code review → deploy"
→ create_workflow(name="Bug Fix", steps=[{name:"Fix code", step_type:"action"}, {name:"Code review", step_type:"approval", assignee:"senior-dev"}, {name:"Deploy", step_type:"action"}])

MCP Server Manifest

server_id = "mcp_workflow"
display_name = "Workflow"
version = "1.0.0"
domain = "platform-core"
risk_level = "medium"
writes_allowed = "gated"

License

Apache-2.0

Part of the ADK-Rust Enterprise MCP server ecosystem.

Built with ❤️ by Zavora AI