cyanheads/workflows-mcp-server

Store, query, and create YAML workflow playbooks for LLM agents via MCP. STDIO or Streamable HTTP.

31 ★6 forksTypeScriptUpdated 1mo ago

What you need to know

MCP server to store, query, and create YAML workflow playbooks for LLM agents, with 5 tools and STDIO or Streamable HTTP transports.

Install

bunx @cyanheads/workflows-mcp-server@latest (or npx -y)
Docker: ghcr.io/cyanheads/workflows-mcp-server:latest
Set WORKFLOWS_DIR and optionally GLOBAL_INSTRUCTIONS_PATH
Or clone, bun install, cp .env.example .env

Usage

•List permanent workflows with workflow_list (keyword/category/tag filters)
•Retrieve a workflow with workflow_get (semver-aware, includes global instructions)
•Create workflows with workflow_create / workflow_create_temp, delete with workflow_delete

Key features

✓5 tools: workflow_list, workflow_get, workflow_create, workflow_create_temp, workflow_delete
✓YAML workflow library with in-memory index, semver lookup, filesystem watcher
✓STDIO and Streamable HTTP transports
✓Pluggable auth (none/jwt/oauth) and storage backends
✓OpenTelemetry tracing optional
✓No API keys required
✓Apache 2.0 license

Best for

Managing reusable YAML workflow playbooks for LLM agents.

Clients: Claude Desktop · Cursor · VS Code

Reviewed 2026-08-11

Topics

agent-automationai-agentscyanheadsmcpmcp-servermodel-context-protocolworkflow workflow-automation

Stars: 31★
Forks: 6
Language: TypeScript
License: Apache-2.0
Created: 2025-06-13
Last push: 2026-07-30