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 Use Online Version

Available at mcp.vistaan.com — no installation required

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/v1
workflow://freelancing/v1
workflow://products/v1
workflow://content/v1
workflow://execution/v1
workflow://investing/v1
workflow://utility/v1
workflow://execute-referencing/v1
workflow://design-reference/v1
workflow://pentest-web/v1
workflow://pentest-mobile/v1
workflow://pentest-api/v1
workflow://pentest-infra/v1
ℹ️
DESIGN.md Reference — The workflow://design-reference/v1 resource contains the full Google DESIGN.md specification for standardizing design systems across AI agents and tools.
🛡️
Penetration Testing Workflows — Four dedicated resources for web, mobile, API, and infrastructure security assessments following OWASP, PTES, CIS, and MITRE ATT&CK standards.
ℹ️
DESIGN.md Reference — The workflow://design-reference/v1 resource contains the full Google DESIGN.md specification for standardizing design systems across AI agents and tools.

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.

Online Version

Skip installation and connect directly to the hosted MCP server at mcp.vistaan.com.

🚀

No Installation

Connect instantly via HTTP without building or running anything locally.

🔌

Same Capabilities

All tools, prompts, and resources work identically to the local version.

📡

Interactive Docs

Explore the API live at mcp.vistaan.com/docs.

# HTTP MCP configuration
{
"mcpServers": {
"workflow-os": {
"transport": "http",
"url": "https://mcp.vistaan.com/mcp"
}
}
}

See the online usage guide for full details.

Quick Start (Local)

# 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