cyanheads avatar

Workflows Mcp Server

cyanheads/workflows-mcp-server

Gives Claude four operations to manage YAML workflow playbooks: list permanent workflows by category or tag, retrieve a specific workflow with global instructions prepended, create new permanent workflows in the library, and write temporary one-shot workflows. Built on the mcp-ts-core framework with a filesystem-backed in-memory index, semver-aware versioning, and automatic rebuilds when workflow files change. Includes tools enumeration so you can see which MCP servers a workflow depends on before running it. Useful when you're orchestrating multi-step agent tasks and want structured, reusable playbooks instead of freeform prompting. Runs over stdio or streamable HTTP with no API keys required.

GitHub stars
32
tools
5
transport
STDIO, HTTP
env vars
9
last updated
Oct 29, 2026

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

workflow_listList all permanent workflows in the index, with optional keyword, category, and tag filters.

List all permanent workflows in the index, with optional keyword, category, and tag filters.

No parameter schema in public metadata yet.

workflow_getRetrieve a complete workflow definition by name, with the library's global instructions included.

Retrieve a complete workflow definition by name, with the library's global instructions included.

No parameter schema in public metadata yet.

workflow_createWrite a new permanent workflow YAML to the library.

Write a new permanent workflow YAML to the library.

No parameter schema in public metadata yet.

workflow_create_tempWrite a temporary workflow draft, indexed but excluded from list results, kept until deleted.

Write a temporary workflow draft, indexed but excluded from list results, kept until deleted.

No parameter schema in public metadata yet.

workflow_deleteRemove a permanent workflow or a temporary draft by name and optional version, after the user confirms the resolved target.

Remove a permanent workflow or a temporary draft by name and optional version, after the user confirms the resolved target.

No parameter schema in public metadata yet.

Sponsors

Configuration

WORKFLOWS_DIRdefault: ./workflows-yaml

Absolute or relative path to the workflows root directory.

GLOBAL_INSTRUCTIONS_PATH

Path to the global instructions markdown file. Derives from WORKFLOWS_DIR when not set.

WATCHER_DEBOUNCE_MSdefault: 500

Milliseconds to debounce filesystem change events before rebuilding the index.

MCP_LOG_LEVELdefault: info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

MCP_TRANSPORT_TYPEdefault: http

Selects the HTTP transport.

MCP_HTTP_HOSTdefault: 127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORTdefault: 3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATHdefault: /mcp

The endpoint path for the MCP server.

MCP_AUTH_MODEdefault: none

Authentication mode to use: 'none', 'jwt', or 'oauth'.

Readme

@cyanheads/workflows-mcp-server

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

5 Tools

Version License Docker MCP SDK npm TypeScript Bun

Details

Repository
github.com/cyanheads/workflows-mcp-server
Categories
AI & LLM Tools, Automation & Workflows
Package
@cyanheads/workflows-mcp-server
Transport
STDIO, HTTP
Registry
MCP registry, active

More from cyanheads

Related AI & LLM Tools MCP servers

View all
1igorganapolsky avatarThumbGate — PreToolUse Agent Firewalligorganapolsky/thumbgateSub-ms PreToolUse firewall, feedback memory, and single-use permits for AI coding agents.31stars
2leandropg19 avatarCuba Memorysleandropg19/cuba-memorysPersistent memory MCP server. 28 tools, BM25+MMR+OOD retrieval, tamper-evident audit, code graph.30stars
3vishisht16 avatarHumane Proxyvishisht16/humane-proxyAI safety middleware — detects self-harm and criminal intent in LLM prompts.28stars
4mkxultra avatarAi Cli Mcpmkxultra/ai-cli-mcpRun Claude, Codex, Gemini, Forge, and OpenCode CLIs through MCP with background jobs27stars
5youdotcom-oss avatarYou.com Web Access & AIyoudotcom-oss/mcpWeb search, AI agent, and content extraction via You.com APIs0stars
6olostep avatarOlostep MCP Serverolostep/olostep-mcp-serverLive web search, scraping and crawling API for AI. Get structured, LLM-ready data from any site.25stars