workflows-mcp-server

---

Tools

Four tools covering the full workflow library lifecycle — discovery, retrieval, and creation for both permanent and temporary workflows:

Tool	Description
workflow_list	List all permanent workflows in the index, with optional category and tag filters.
workflow_get	Retrieve a complete workflow definition by name, with global instructions prepended.
workflow_create	Write a new permanent workflow YAML to the library.
workflow_create_temp	Write a temporary one-shot workflow, indexed but excluded from list results.

workflow_list

List permanent workflows from the in-memory index.

• Optional category filter (case-insensitive substring match)
• Optional tag filter (AND match — all listed tags must be present)
• Set includeTools: true to surface the unique server/tool pairs used across each workflow's steps
• Temporary workflows are excluded; results sorted by name then version descending

---

workflow_get

Retrieve a complete workflow by name, including the global instructions document.

• Semver-aware: omit version to get the highest available match; specify a version for an exact lookup
• Returns the full workflow YAML structure with all steps and metadata
• Injects the global_instructions.md content as globalInstructions — apply these when executing the workflow; null when the file is absent
• Temporary workflows are accessible here even though excluded from workflow_list
• Template placeholders ({{input.foo}}, {{steps.X.output.Y}}) are returned verbatim — the server never interpolates them

---

workflow_create

Write a new permanent workflow to the library.

• Workflow stored at categories/<slugified-category>/<slugified-name>-workflow.yaml
• Rejects if name@version already exists — bump the version to create a new revision
• Server stamps created_date and last_updated_date automatically
• Index and snapshot rebuilt after write; filesystem watcher also fires (idempotent, debounced)

---

workflow_create_temp

Write a throwaway workflow to the temp/ directory.

• No conflict check — temp workflows are intentionally ephemeral and overwriteable
• Indexed and accessible via workflow_get but excluded from workflow_list results
• Useful for one-shot plans, short-lived scaffolding, or session-specific orchestration steps

---

Features

Built on @cyanheads/mcp-ts-core: