Workflow Library

​

get_workflow

• action:“get” — the full JSON of one saved workflow FILE named from the library. Defaults to converted API format; pass format:‘ui’ for the raw on-disk UI JSON. Use action:“analyze” instead if you just need to UNDERSTAND the workflow — it returns a structured summary without flooding context with JSON. Use action:“get” only when you need the actual JSON for enqueue_workflow, create_workflow (action:“modify”), or save_workflow.
• action:“list” — the workflows saved in the connected ComfyUI server’s user library (the same ones visible in the ComfyUI web UI), INCLUDING the ones filed in subfolders. Requires a running ComfyUI server. Takes no other parameters. Returns a numbered list of library names, each relative to the library root — a workflow in a folder appears as ‘VIDEO/MiniMaxH3/clip.json’, and that whole string is what filename takes. It never reports an absence it did not establish: a listing it could not read says so, and an EMPTY listing says the library could not be CONFIRMED empty (an answer with no names in it cannot show whether it covered subfolders) and tells you to check the ComfyUI sidebar rather than recreate anything.
• action:“strip” — strip a workflow to a clean, flat API graph, resolving Get/Set buses, Reroutes, subgraph definitions, and bypassed/muted nodes into real connections (the ‘de-getter-setter’ pass). Unlike action:“get” this reads from ANY server-side file path on disk (not just the workflow library), so it loads ad-hoc / expert workflow files that action:“list” and panel_open_workflow can’t resolve. Provide exactly one of: path, filename, or graph. Returns conversion warnings, a node-type summary, and the stripped graph (much smaller than the raw UI JSON).
• action:“slice” — slice ONE pipeline out of a toggle-template workflow, the kind built with rgthree ‘Fast Groups Bypasser/Muter’ where one graph holds many pipelines and only one is active at a time. Seeds from the output/SaveImage nodes in the named groups, takes their backward dependency closure (through real links AND virtual Set/Get buses), un-bypasses the kept nodes (and the internals of any subgraph defs they use), and returns a STANDALONE, activated UI graph carrying only the subgraph defs it uses. Pair with action:“strip” afterward to flatten the Set/Get buses into real connections.
• action:“from_image” — extract embedded ComfyUI workflow metadata from a PNG file. ComfyUI stores the full workflow (API format) and prompt data in PNG tEXt chunks. Use this to reverse-engineer how any ComfyUI image was generated.
• action:“analyze” — SUMMARIZE a saved workflow file named from the library: sections, node settings, connections, and data flow. Returns a concise text summary (not raw JSON) optimized for AI reasoning. Prefer this over action:“get” unless you need the raw JSON for enqueue_workflow or create_workflow (action:“modify”).
• action:“query” — filter, traverse, project, and aggregate over a saved workflow’s nodes WITHOUT dumping the whole JSON (the missing middle between action:“analyze“‘s fixed summary and action:“get“‘s full dump; on 100+-node graphs this is the ONLY context-safe way to answer questions like ‘which KSamplers run cfg>7’, ‘what feeds node 42’, ‘count nodes by type’). Provide exactly one of path/filename/graph, then combine: types, title, where widget predicates ANDed (‘cfg>7’, ‘steps<=20’, ‘sampler_name=euler’, ‘text~sunset’ — ops = != >= <= > < ~contains), ids, upstream_of/downstream_of + depth, fields, group_by, limit, max_chars. Output is TOKEN-BOUNDED and, when it truncates, the tail names WHICH of the two caps fired and the exact parameter to raise — read it and retry rather than concluding the graph can’t be read. For the LIVE canvas this is panel_query_graph instead.
• action:“prompt_director” — read Prompt Director’s latest sanitized RUNTIME state after its nodes execute: each node id, node kind, resolved Model Explorer model/LoRA context, structured edit plan, source analysis, exact final prompt, warnings, or Result Critic verdict. Secrets and image tensors are redacted. Pair it with a live panel graph audit: graph inspection explains wiring and widget state, while this explains what the nodes actually resolved and compiled. Pass node_id to inspect one executed Prompt Director node.

​

Parameters

​

Examples

{
  "tool": "get_workflow",
  "arguments": {
    "action": "list"
  }
}

{
  "tool": "get_workflow",
  "arguments": {
    "action": "get",
    "filename": "portrait-flux.json"
  }
}

{
  "tool": "get_workflow",
  "arguments": {
    "action": "get",
    "filename": "portrait-flux.json",
    "format": "ui"
  }
}

{
  "tool": "get_workflow",
  "arguments": {
    "action": "analyze",
    "filename": "portrait-flux.json"
  }
}

{
  "tool": "get_workflow",
  "arguments": {
    "action": "analyze",
    "filename": "portrait-flux.json",
    "view": "health"
  }
}

{
  "tool": "get_workflow",
  "arguments": {
    "action": "query",
    "filename": "portrait-flux.json",
    "types": [
      "KSampler"
    ],
    "where": [
      "cfg>7"
    ]
  }
}

{
  "tool": "get_workflow",
  "arguments": {
    "action": "from_image",
    "image_path": "C:/ComfyUI/output/ComfyUI_00042_.png"
  }
}

{
  "tool": "get_workflow",
  "arguments": {
    "action": "strip",
    "path": "C:/ComfyUI/user/default/workflows/expert.json"
  }
}

​

save_workflow

• action:“save” — Save a workflow JSON to the connected ComfyUI server’s user library so it appears in the ComfyUI web UI. Requires a running ComfyUI server; this writes to that server’s userdata and OVERWRITES any existing file with the same filename without confirmation. Web-UI-format JSON ({ nodes: [], links: [] }) is saved as-is and is the preferred input — when re-saving an existing workflow, load it with get_workflow (action:“get”, format=‘ui’) and modify THAT. API-format graphs ({ ‘1’: { class_type, inputs } }) are AUTO-CONVERTED to Web UI format with a generated layout so the saved file always opens in the ComfyUI canvas (the canvas cannot open raw API format). Returns a confirmation message (noting the conversion and any warnings), or the HTTP status and error text on failure.
• action:“lock” — Capture a provenance lock for a saved workflow so it can be exactly reproduced later. Walks the workflow’s model loaders (CheckpointLoaderSimple, UNETLoader, VAELoader, LoraLoader, ControlNetLoader, etc.), SHA-256s every referenced model file, records the git commit currently checked out for every custom node pack the workflow’s class_types come from, and captures ComfyUI’s reported version. WRITES <filename>.lock.json next to the workflow in ComfyUI’s user library. Requires a local install (COMFYUI_PATH) — SHA-256 needs raw file bytes and pack commits come from custom_nodes/*/.git/HEAD. Pair with action:“verify_lock” later to detect drift.
• action:“verify_lock” — Compare a saved workflow’s lock file against the current state of the local install and report drift. Loads <filename>.lock.json, re-computes a current lock from the same workflow, and diffs: which models have a different SHA-256, which custom node packs are on a different commit, whether ComfyUI’s version changed. Use before re-running an important workflow days or weeks later to confirm it’ll behave the same. Requires a local install (COMFYUI_PATH). Read-only; returns a structured drift report (empty arrays everywhere mean perfect parity).

​

Parameters

​

Examples

{
  "tool": "save_workflow",
  "arguments": {
    "action": "save",
    "filename": "portrait-flux-v2.json",
    "workflow": {
      "4": {
        "class_type": "CheckpointLoaderSimple",
        "inputs": {
          "ckpt_name": "sd_xl_base_1.0.safetensors"
        }
      },
      "9": {
        "class_type": "SaveImage",
        "inputs": {
          "filename_prefix": "portrait",
          "images": [
            "8",
            0
          ]
        }
      }
    }
  }
}

{
  "tool": "save_workflow",
  "arguments": {
    "action": "lock",
    "filename": "portrait-flux-v2.json"
  }
}

{
  "tool": "save_workflow",
  "arguments": {
    "action": "verify_lock",
    "filename": "portrait-flux-v2.json"
  }
}