workflow-os-mcp

An MCP server for intelligent workflow routing and execution across MCP-compatible clients. Route tasks, run workflows, and generate next actions seamlessly in stdio or HTTP mode.

Get Started View Client Config

How It Works

🔀

Route Task

Determine the appropriate workflow domain

→
📋

Select Workflow

Choose or inspect workflow resources

→
⚡

Run Workflow

Execute one main workflow sequence

→
🔧

Apply Utility (Optional)

Apply one utility prompt if needed

→
🎯

Generate Next Action

Produce one immediate next action

Core Tools

route_task

Routes incoming tasks to appropriate workflow domains

Step 1

select_domain_workflow

Selects or inspects workflow resources for a domain

Step 2

run_workflow_sequence

Executes the main workflow sequence

Step 3

apply_utility_prompt

Applies a utility prompt for additional processing

Step 4 (Optional)

generate_next_action

Generates the immediate next action to take

Step 5

Prompts & Resources

Prompts

  • Mode Prompts: Configure execution modes
  • Domain Prompts: Domain-specific guidance
  • Front-door Prompt: route_and_run for complete workflow execution

Resources

Bundled workflow resources include:

workflow://os/v4
workflow://freelancing/v4
workflow://products/v4
workflow://content/v4
workflow://execution/v4
workflow://investing/v4
workflow://utility/v4
workflow://execute-referencing/v4

Client Compatibility

Integrate with any MCP-compatible client using the standard MCP configuration contract.

📱
Codex App
💻
Codex VS Code
🤖
Claude Code
🌐
Claude Web
💬
ChatGPT Web
🔍
Kimi Web
⚙️
Kimi Code
🦾
Kimi Claw
🔓
Open Claw

HTTP API & Documentation

Endpoints

  • GET /health
  • GET /docs - Swagger UI
  • GET /docs-api.json - OpenAPI JSON
  • POST /mcp
  • GET /mcp
  • DELETE /mcp

Interactive Documentation

When running in HTTP mode, explore the full API interactively at /docs. The OpenAPI specification is available at /docs-api.json.

Port is configurable via MCP_PORT environment variable.

Deployment Options

💻

Local Development

Run directly on your machine for development and testing.

🐳

Docker

Containerized deployment for consistent environments.

☸️

Kubernetes

Scalable deployment in container orchestration platforms.

Quick Start

# Install dependencies
pnpm install
# Build the project
pnpm run build
# Run in stdio mode
node dist/index.js
# Run in HTTP mode
MCP_TRANSPORT=http MCP_PORT=3000 node dist/index.js