ComfyUI MCP Server

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "manifest": {
      "description": "Inline manifest object. Provide exactly one of `manifest` or `path`.",
      "type": "object",
      "properties": {
        "apt": {
          "default": [],
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          }
        },
        "pip": {
          "default": [],
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          }
        },
        "custom_nodes": {
          "default": [],
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          }
        },
        "models": {
          "default": [],
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "model_type": {
                "type": "string",
                "enum": [
                  "checkpoints",
                  "loras",
                  "vae",
                  "upscale_models",
                  "controlnet",
                  "embeddings",
                  "clip",
                  "diffusers",
                  "diffusion_models",
                  "gligen",
                  "hypernetworks",
                  "photomaker",
                  "style_models",
                  "text_encoders",
                  "unet"
                ]
              },
              "filename": {
                "type": "string",
                "minLength": 1
              },
              "local_path": {
                "type": "string",
                "minLength": 1
              }
            },
            "required": [
              "url"
            ],
            "additionalProperties": false
          }
        }
      },
      "additionalProperties": false
    },
    "path": {
      "description": "Path to a .json, .yaml, or .yml manifest file. Provide exactly one of `manifest`, `path`, or `pack`.",
      "type": "string"
    },
    "pack": {
      "description": "A bundled installer pack by NAME, as reported by list_packs (action:\"list\"). PREFER THIS over `path` for a bundled pack: the name is resolved against the running build at apply time, while a manifest_path captured earlier points into an npx cache directory that a later respawn no longer has (#1568). Provide exactly one of `manifest`, `path`, or `pack`.",
      "type": "string"
    }
  }
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "list",
        "get",
        "run",
        "run_status",
        "import"
      ],
      "description": "Which apps operation to perform. \"list\" takes no other parameters; \"get\"/\"run\" require `app_id`; \"run_status\" requires `app_id` + `prompt_id`; \"import\" requires `registry_url` + `app_id`."
    },
    "app_id": {
      "description": "The app's uuid. REQUIRED for actions \"get\", \"run\", \"run_status\" (from action:\"list\") and \"import\" (the REGISTRY app's uuid, from the explore list).",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "values": {
      "description": "action:\"run\" — input overrides keyed '<nodeId>.<widget>' (e.g. {\"6.text\": \"a cat\", \"3.seed\": 42}). Unknown keys fail loudly (the manifest drifted from the snapshot).",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "prompt_id": {
      "description": "action:\"run_status\" — the prompt_id returned by action:\"run\". Required for that action.",
      "type": "string",
      "pattern": "^[0-9a-zA-Z-]{1,64}$"
    },
    "registry_url": {
      "description": "action:\"import\" — registry worker base URL (required for that action). Must be the default public registry or an origin the operator allowlisted via COMFYUI_MCP_REGISTRY_URLS (the fetch is server-side — open URLs would be SSRF).",
      "type": "string",
      "format": "uri"
    },
    "slug": {
      "description": "action:\"import\" — the app's registry slug (recorded in local metadata).",
      "type": "string"
    },
    "version": {
      "description": "action:\"import\" — the registry version (recorded in local metadata).",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "submit",
        "status",
        "output",
        "wait"
      ],
      "description": "Which batch operation to perform. \"submit\" takes workflows | workflow+sweep; \"status\"/\"output\"/\"wait\" each require `batch_id` (\"wait\" also takes `timeout_s`)."
    },
    "workflows": {
      "description": "action:\"submit\" — array of ComfyUI workflows in API format (node ID -> {class_type, inputs}). Mutually exclusive with workflow+sweep.",
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "workflow": {
      "description": "action:\"submit\" — one base workflow in API format, used with `sweep`.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "sweep": {
      "description": "action:\"submit\" — param sweep: one job per override set, e.g. [{\"cfg\":6},{\"cfg\":8,\"steps\":30}]. Each key is set on every node that already has that input.",
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "disable_random_seed": {
      "description": "action:\"submit\" — if true, do not randomize seed values (default randomizes per job).",
      "type": "boolean"
    },
    "batch_id": {
      "description": "The batch_id returned by action:\"submit\". Required for actions \"status\", \"output\" and \"wait\".",
      "type": "string"
    },
    "timeout_s": {
      "description": "action:\"wait\" — max seconds to wait (default 300, hard cap 600).",
      "type": "number"
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "start",
        "good",
        "bad",
        "reset",
        "status"
      ],
      "description": "Which bisect operation to perform. \"start\" begins a session; \"good\"/\"bad\" narrow it (require a running session); \"reset\" clears it and re-enables everything; \"status\" reports state. No other arguments are needed for any action."
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "spec": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ],
      "description": "Expressions to evaluate, separated by newlines/semicolons (string) or one per array item. `name = expr` assigns; assignments persist across subsequent lines. NOTE: comma is an argument separator (min(a,b)), NOT an expression separator."
    },
    "variables": {
      "description": "Initial variable environment, e.g. {\"w\": 1024, \"ar\": 1.5}.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "number"
      }
    },
    "seed": {
      "description": "Seed for rand()/uniform(a,b)/randint(a,b). Same seed => identical sequence (mulberry32). Omit for a random seed (echoed in the result).",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "spec"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "name": {
      "description": "Exact tool name from list_tools.",
      "type": "string"
    },
    "tool_name": {
      "description": "Alias for name.",
      "type": "string"
    },
    "args": {
      "description": "The tool's parameters as an object matching its describe_tool schema. A JSON-encoded string is also accepted. Omit for tools without parameters."
    },
    "arguments": {
      "description": "Alias for args."
    },
    "parameters": {
      "description": "Alias for args."
    }
  }
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "unload_models": {
      "default": true,
      "description": "Unload all cached models (default: true)",
      "type": "boolean"
    },
    "free_memory": {
      "default": true,
      "description": "Free cached memory/intermediates (default: true)",
      "type": "boolean"
    }
  }
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "status",
        "server_start",
        "server_stop",
        "server_restart",
        "jobs_list",
        "jobs_status",
        "jobs_wait",
        "jobs_watch",
        "jobs_cancel",
        "search_nodes",
        "workflow_validate",
        "workflow_run",
        "transfer_upload",
        "transfer_download",
        "models_list_folders",
        "models_list_folder",
        "models_search",
        "models_show",
        "models_download",
        "models_remove",
        "skills_list",
        "skills_show",
        "skills_validate",
        "skills_install",
        "skills_status",
        "skills_uninstall"
      ],
      "description": "Which comfy-cli operation to perform. Families: status; server_* (lifecycle); jobs_* (list/status/wait/watch/cancel); search_nodes; workflow_* (validate/run); transfer_* (upload/download); models_* (list_folders/list_folder/search/show/download/remove); skills_* (list/show/validate/install/status/uninstall)."
    },
    "detail": {
      "default": "env",
      "description": "action:\"status\" — which inspection to run.",
      "type": "string",
      "enum": [
        "version",
        "which",
        "env",
        "discover"
      ]
    },
    "workspace": {
      "description": "Optional ComfyUI workspace override (the data/base root comfy-cli uses for custom_nodes/models). Otherwise the live --base-directory / COMFYUI_PATH is used; the CLI executable may still come from the COMFYUI_CODE_PATH checkout's .venv.",
      "type": "string"
    },
    "launchArgs": {
      "description": "actions \"server_start\"/\"server_restart\" — extra ComfyUI launch arguments, e.g. ['--listen','0.0.0.0','--port','8188'].",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "promptId": {
      "description": "Single prompt id. Required for \"jobs_status\"/\"jobs_watch\"/\"jobs_cancel\" and \"transfer_download\"; accepted for \"jobs_wait\" (normalized into a one-element promptIds list).",
      "type": "string"
    },
    "promptIds": {
      "description": "action:\"jobs_wait\" — prompt ids to wait on. Use this or promptId or all=true.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "all": {
      "description": "action:\"jobs_wait\" — wait on every known job.",
      "type": "boolean"
    },
    "limit": {
      "description": "Result cap for \"jobs_list\", \"search_nodes\" and the \"models_*\" listing/search actions.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "timeoutSeconds": {
      "description": "actions \"jobs_wait\"/\"jobs_watch\"/\"workflow_run\" — max seconds to wait.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "where": {
      "description": "Target for the jobs/search_nodes/workflow/transfer/models actions: \"local\" (default) or \"cloud\" (Comfy Cloud).",
      "type": "string",
      "enum": [
        "local",
        "cloud"
      ]
    },
    "query": {
      "description": "action:\"search_nodes\" — fuzzy search text. REQUIRED.",
      "type": "string",
      "minLength": 1
    },
    "objectInfoPath": {
      "description": "action:\"search_nodes\" — offline object_info JSON file to search instead of a live target.",
      "type": "string"
    },
    "workflowPath": {
      "description": "actions \"workflow_validate\"/\"workflow_run\" — path to an API/UI workflow JSON file. REQUIRED.",
      "type": "string",
      "minLength": 1
    },
    "wait": {
      "description": "action:\"workflow_run\" — await outputs instead of returning after submission.",
      "type": "boolean"
    },
    "files": {
      "description": "action:\"transfer_upload\" — input files to upload. REQUIRED.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "outDir": {
      "description": "action:\"transfer_download\" — output directory.",
      "type": "string"
    },
    "overwrite": {
      "description": "action:\"transfer_upload\" — set false to pass --no-overwrite.",
      "type": "boolean"
    },
    "urlOnly": {
      "description": "action:\"transfer_download\" — print URLs instead of downloading files.",
      "type": "boolean"
    },
    "folder": {
      "description": "action:\"models_list_folder\" — the model folder to list (REQUIRED). action:\"models_show\" — optional folder to pick among duplicate basenames.",
      "type": "string"
    },
    "text": {
      "description": "action:\"models_search\" — search text.",
      "type": "string"
    },
    "type": {
      "description": "action:\"models_search\" — model type filter (checkpoint, lora, vae, …). action:\"models_show\" — same filter, to pick among duplicate basenames.",
      "type": "string"
    },
    "name": {
      "description": "actions \"models_show\"/\"skills_show\" — the model or skill name. For models_show a relative path (e.g. vae/qwen_image_vae.safetensors) selects among duplicate basenames.",
      "type": "string"
    },
    "url": {
      "description": "action:\"models_download\" — model URL to download. REQUIRED.",
      "type": "string",
      "format": "uri"
    },
    "relativePath": {
      "description": "actions \"models_download\"/\"models_remove\" — workspace-relative model directory (default models/checkpoints).",
      "type": "string"
    },
    "modelNames": {
      "description": "action:\"models_remove\" — model filenames to remove. REQUIRED.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "path": {
      "description": "action:\"skills_validate\" — path to the skill to validate. REQUIRED.",
      "type": "string"
    },
    "scope": {
      "description": "actions \"skills_install\"/\"skills_uninstall\"/\"skills_status\" — install scope.",
      "type": "string",
      "enum": [
        "user",
        "project"
      ]
    },
    "projectDir": {
      "description": "Working directory for project-scoped skill operations. Required when scope='project'.",
      "type": "string"
    },
    "targets": {
      "description": "actions \"skills_install\"/\"skills_uninstall\" — agent targets.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "skills": {
      "description": "actions \"skills_install\"/\"skills_uninstall\" — skill names.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "apply": {
      "default": false,
      "description": "actions \"skills_install\"/\"skills_uninstall\" — actually mutate; default false = dry-run.",
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "create",
        "modify",
        "validate",
        "node_info"
      ],
      "description": "Which authoring operation to perform. \"create\" requires `template` (optional `params`); \"modify\" requires `workflow` + `operations`; \"validate\" requires `workflow` (optional `health`); \"node_info\" takes no required parameters (optional `node_type`, `verbose`, `refresh`)."
    },
    "template": {
      "description": "action:\"create\" (REQUIRED) — Template name, one of: txt2img, img2img, upscale, inpaint, controlnet, ip_adapter, ace_step_15, stable_audio_3, remove_background, ltx_video",
      "type": "string",
      "enum": [
        "txt2img",
        "img2img",
        "upscale",
        "inpaint",
        "controlnet",
        "ip_adapter",
        "ace_step_15",
        "stable_audio_3",
        "remove_background",
        "ltx_video"
      ]
    },
    "params": {
      "default": {},
      "description": "action:\"create\" — Template parameters; recognized keys depend on the template. txt2img: checkpoint, positive_prompt, negative_prompt, width, height, steps, cfg, seed, sampler_name, scheduler. img2img/inpaint add image_path (and mask_path for inpaint) and denoise. upscale adds upscale_model. Unknown keys are ignored; omitted keys use template defaults.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "workflow": {
      "description": "ComfyUI workflow JSON (as a JSON string or object). REQUIRED for action:\"modify\" and action:\"validate\". action:\"validate\" accepts API format or a saved UI export (nodes[]/links[]).",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "operations": {
      "description": "action:\"modify\" (REQUIRED) — Array of operations to apply in order. Each has an 'op' field: set_input, add_node, remove_node, connect, or insert_between",
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "op": {
                "type": "string",
                "const": "set_input"
              },
              "node_id": {
                "type": "string"
              },
              "input_name": {
                "type": "string"
              },
              "value": {}
            },
            "required": [
              "op",
              "node_id",
              "input_name",
              "value"
            ]
          },
          {
            "type": "object",
            "properties": {
              "op": {
                "type": "string",
                "const": "add_node"
              },
              "class_type": {
                "type": "string"
              },
              "inputs": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              },
              "id": {
                "type": "string"
              }
            },
            "required": [
              "op",
              "class_type"
            ]
          },
          {
            "type": "object",
            "properties": {
              "op": {
                "type": "string",
                "const": "remove_node"
              },
              "node_id": {
                "type": "string"
              }
            },
            "required": [
              "op",
              "node_id"
            ]
          },
          {
            "type": "object",
            "properties": {
              "op": {
                "type": "string",
                "const": "connect"
              },
              "source_id": {
                "type": "string"
              },
              "output_index": {
                "type": "number"
              },
              "target_id": {
                "type": "string"
              },
              "input_name": {
                "type": "string"
              }
            },
            "required": [
              "op",
              "source_id",
              "output_index",
              "target_id",
              "input_name"
            ]
          },
          {
            "type": "object",
            "properties": {
              "op": {
                "type": "string",
                "const": "insert_between"
              },
              "source_id": {
                "type": "string"
              },
              "output_index": {
                "type": "number"
              },
              "target_id": {
                "type": "string"
              },
              "input_name": {
                "type": "string"
              },
              "new_class_type": {
                "type": "string"
              },
              "new_inputs": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              }
            },
            "required": [
              "op",
              "source_id",
              "output_index",
              "target_id",
              "input_name",
              "new_class_type"
            ]
          }
        ]
      }
    },
    "health": {
      "default": true,
      "description": "action:\"validate\" — Include graph-health heuristics (disconnected nodes, duplicate model loads, orphaned branches, muted/bypassed nodes, a sampler running denoise below 1.0 on an empty latent, an image-edit graph whose sampled canvas is not derived from the reference) as info/warning issues plus a structured health section. Never affects `valid`.",
      "type": "boolean"
    },
    "node_type": {
      "description": "action:\"node_info\" — Filter by node class_type name (case-insensitive substring match). Omit to list all available nodes.",
      "type": "string"
    },
    "verbose": {
      "default": false,
      "description": "action:\"node_info\" — If true, return the full raw /object_info definitions including enum dropdown values (model lists etc.) — can be hundreds of KB per Loader node, so only use it when you need the actual enum values (e.g. exact model filenames) and the filter matches few nodes. Default false: structural summary with enum value counts.",
      "type": "boolean"
    },
    "refresh": {
      "default": false,
      "description": "action:\"node_info\" — If true, discard the memoized /object_info snapshot and refetch live from the connected server before answering. Use after the ComfyUI server was restarted EXTERNALLY (systemd/service manager) or new model files were added out-of-band — the cache is otherwise only invalidated by MCP-managed restarts, so loader dropdowns (model lists) would remain stale for the rest of the session (#499).",
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "name": {
      "description": "Exact tool name from list_tools.",
      "type": "string"
    },
    "tool_name": {
      "description": "Alias for name.",
      "type": "string"
    }
  }
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "download",
        "status",
        "cancel",
        "search",
        "search_civitai",
        "search_creators",
        "download_civitai",
        "resolve_missing"
      ],
      "description": "Which model operation to perform. \"download\" requires `url` + `target_subfolder`; \"status\" takes an optional `id`/`tray_id`/`url` (omit all three to list everything); \"cancel\" requires `id` (optional `tray_id`); \"search\" requires `query`; \"search_civitai\" requires `query` and/or `creator`; \"search_creators\" takes an optional `query` (omit for the leaderboard `board`); \"download_civitai\" requires `target_subfolder` plus `model_id` and/or `model_version_id`; \"resolve_missing\" requires `workflow`."
    },
    "url": {
      "description": "REQUIRED for action:\"download\" — the direct download URL for the model file. OPTIONAL for action:\"status\" — adopt an in-flight download by its source URL when you don't have the id (e.g. after a reconnect); reports the matching job without starting a duplicate.",
      "type": "string",
      "format": "uri"
    },
    "target_subfolder": {
      "type": "string",
      "minLength": 1,
      "description": "REQUIRED for action:\"download\" and action:\"download_civitai\". Target subfolder under ComfyUI models/. Standard names: checkpoints, loras, vae, upscale_models, controlnet, embeddings, clip, diffusers, diffusion_models, gligen, hypernetworks, photomaker, style_models, text_encoders, unet. Any other relative subfolder (incl. nested like 'loras/<subdir>') is allowed; absolute paths and '..' escapes are rejected."
    },
    "filename": {
      "description": "action:\"download\" — override filename (auto-detected from the URL if omitted). action:\"download_civitai\" — override the saved filename (defaults to the CivitAI file name, or the URL basename).",
      "type": "string"
    },
    "auth": {
      "description": "action:\"download\" / action:\"download_civitai\" — optional per-request authentication for private/gated model URLs. When provided it overrides built-in HuggingFace/CivitAI token handling.",
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "bearer"
            },
            "token": {
              "type": "string",
              "minLength": 1,
              "description": "Bearer token value"
            }
          },
          "required": [
            "type",
            "token"
          ]
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "basic"
            },
            "username": {
              "type": "string",
              "description": "Basic auth username"
            },
            "password": {
              "type": "string",
              "description": "Basic auth password"
            }
          },
          "required": [
            "type",
            "username",
            "password"
          ]
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "header"
            },
            "header_name": {
              "type": "string",
              "minLength": 1,
              "description": "HTTP header name"
            },
            "header_value": {
              "type": "string",
              "description": "HTTP header value"
            }
          },
          "required": [
            "type",
            "header_name",
            "header_value"
          ]
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "query"
            },
            "query_param": {
              "type": "string",
              "minLength": 1,
              "description": "Query parameter name"
            },
            "query_value": {
              "type": "string",
              "description": "Query parameter value"
            }
          },
          "required": [
            "type",
            "query_param",
            "query_value"
          ]
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "s3"
            },
            "access_key_id": {
              "type": "string",
              "minLength": 1,
              "description": "AWS/S3-compatible access key id"
            },
            "secret_access_key": {
              "type": "string",
              "minLength": 1,
              "description": "AWS/S3-compatible secret access key"
            },
            "session_token": {
              "description": "Optional temporary session token",
              "type": "string"
            },
            "region": {
              "description": "Optional AWS region override",
              "type": "string"
            },
            "endpoint": {
              "description": "Optional S3-compatible endpoint for R2-style storage",
              "type": "string",
              "format": "uri"
            }
          },
          "required": [
            "type",
            "access_key_id",
            "secret_access_key"
          ]
        }
      ]
    },
    "id": {
      "description": "The download id. REQUIRED for action:\"cancel\" — this is the handle that says WHICH transfer to stop, so take it from action:\"status\" (or from the reply that started the download) rather than guessing; an id that matches nothing is reported as not found. OPTIONAL for action:\"status\" — omit to list every tracked download (incl. in-flight ones from before a reconnect).",
      "type": "string"
    },
    "tray_id": {
      "description": "action:\"status\" / action:\"cancel\" — use this when two rows come back with the SAME `id`, so the id alone cannot say which one you mean. That happens when two different source URLs are downloading to the same destination file. Every row prints its own tray id as `(tray <tray_id>)` — pass that here, together with `id`, to report on (or stop) exactly one of them.",
      "type": "string"
    },
    "query": {
      "description": "REQUIRED for action:\"search\" — the HuggingFace search query (e.g. 'SDXL', 'flux', 'controlnet'). action:\"search_civitai\" — keyword search (e.g. 'detail enhancer', a character name); optional when `creator` is given (then it narrows that creator's models). action:\"search_creators\" — username search (partial match, e.g. 'alcait'); omit to get the top-creators leaderboard instead.",
      "type": "string"
    },
    "filter": {
      "description": "action:\"search\" — optional HuggingFace pipeline/library tag to narrow results, e.g. 'diffusers' or 'text-to-image'.",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 10, or 8 candidates per missing model for action:\"resolve_missing\"). Per-action ceilings, unchanged from the tools this folds in: \"search\" 50, \"search_civitai\" 25, \"search_creators\" 50, \"resolve_missing\" 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "creator": {
      "description": "action:\"search_civitai\" — only models by this CivitAI creator (EXACT username — find it with action:\"search_creators\"). At least one of query/creator is required.",
      "type": "string",
      "minLength": 1
    },
    "types": {
      "description": "action:\"search_civitai\" — only these model types (e.g. ['LORA']).",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Checkpoint",
          "LORA",
          "LoCon",
          "DoRA",
          "TextualInversion",
          "VAE",
          "Controlnet",
          "Upscaler",
          "MotionModule",
          "Workflows"
        ]
      }
    },
    "base_models": {
      "description": "action:\"search_civitai\" — only these base-model families, CivitAI labels: 'Flux.1 D', 'SDXL 1.0', 'SD 1.5', 'Pony', 'Illustrious', 'Wan Video', …",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "sort": {
      "description": "action:\"search_civitai\" — ranking (default 'Highest Rated').",
      "type": "string",
      "enum": [
        "Highest Rated",
        "Most Downloaded",
        "Newest"
      ]
    },
    "nsfw": {
      "description": "action:\"search_civitai\" — include NSFW results (default false).",
      "type": "boolean"
    },
    "board": {
      "description": "action:\"search_creators\" — leaderboard to rank by when no query is given (default 'overall'). Ignored with a query.",
      "type": "string",
      "enum": [
        "overall",
        "overall_90",
        "overall_nsfw",
        "new_creators"
      ]
    },
    "model_version_id": {
      "description": "action:\"download_civitai\" — CivitAI model-version id (from the URL ?modelVersionId=...). If both model_id and model_version_id are given, this selects the specific version of that model.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "model_id": {
      "description": "action:\"download_civitai\" — CivitAI model id. The latest version is used unless model_version_id is also provided.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "model_root": {
      "description": "action:\"download\" / action:\"download_civitai\" — optional absolute model-root directory already listed by list_local_models action:\"list_paths\" (or the resolver's known extra/primary roots). Use this when the live ComfyUI is unreachable so the file lands in a configured extra-model root instead of <COMFYUI_PATH>/models. Invented paths are refused.",
      "type": "string",
      "minLength": 1
    },
    "workflow": {
      "description": "REQUIRED for action:\"resolve_missing\" — the ComfyUI workflow in API format (JSON string or object).",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    }
  },
  "required": [
    "action"
  ]
}

{
  "destructiveHint": true,
  "openWorldHint": true,
  "idempotentHint": false
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "enqueue",
        "rerun",
        "run_url",
        "template_schema",
        "run_template"
      ],
      "description": "Which enqueue entry point to use. action:\"enqueue\" requires `workflow`; action:\"rerun\" takes an optional `prompt_id` (+ `inputs`); action:\"run_url\" requires `url` (+ `run`/`inputs`); action:\"template_schema\" and action:\"run_template\" require `template`; with action:\"run_template\" you may also pass `overrides`/`wait`/`timeout_s`."
    },
    "workflow": {
      "description": "action:\"enqueue\" — ComfyUI workflow in API format (node ID -> {class_type, inputs}). REQUIRED for that action.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "disable_random_seed": {
      "description": "If true, do not randomize seed values — applies to action:\"rerun\" and action:\"run_template\" (for action:\"rerun\", combine with inputs.seed to reproduce exactly). It is a NO-OP for action:\"enqueue\", whose seeds are always used exactly as supplied (issue #865).",
      "type": "boolean"
    },
    "prompt_id": {
      "description": "action:\"rerun\" — prompt ID of the generation to re-run. If omitted, uses the most recent execution.",
      "type": "string"
    },
    "inputs": {
      "description": "Overrides applied to every node with a matching input name (e.g. cfg, steps, sampler_name, seed, text). Used by action:\"rerun\", and by action:\"run_url\" only when run=true.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "url": {
      "description": "action:\"run_url\" — URL of the workflow JSON. Raw .json links and GitHub blob/raw URLs work directly. REQUIRED for that action.",
      "type": "string"
    },
    "run": {
      "default": false,
      "description": "action:\"run_url\" — if true, enqueue the fetched workflow for execution and return the prompt_id. Default false: only fetch, validate, and summarize (read-only).",
      "type": "boolean"
    },
    "template": {
      "description": "Template name/id: a bundled pack directory name (list_packs action:\"list\") or a custom-node-contributed workflow template name (list_packs action:\"list_templates\"). REQUIRED for action:\"template_schema\" and action:\"run_template\".",
      "type": "string",
      "minLength": 1
    },
    "overrides": {
      "description": "action:\"run_template\" — widget overrides keyed '<nodeId>.<widget_name>' (action:\"template_schema\"'s keys), e.g. {'6.text': 'a red fox', '3.steps': 20}.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "wait": {
      "description": "action:\"run_template\" — block until the job completes and return its outputs. Default false: return {prompt_id} immediately.",
      "type": "boolean"
    },
    "timeout_s": {
      "description": "action:\"run_template\" — max seconds to wait when wait:true (default 300). On timeout the job keeps running; poll queue (action:\"status\").",
      "type": "number",
      "exclusiveMinimum": 0
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "image",
        "audio",
        "video",
        "3d",
        "controlnet",
        "ip_adapter",
        "regenerate",
        "upscale",
        "remove_background"
      ],
      "description": "What to generate. action:\"image\"/action:\"video\" require `prompt`; action:\"audio\" requires `model_family`+`prompt`+`duration`; action:\"3d\" requires `mode` (+ `prompt` or `image`); action:\"controlnet\" requires `prompt`+`control_image`; action:\"ip_adapter\" requires `prompt`+`reference_image`; action:\"regenerate\" requires `asset_id`; action:\"upscale\" and action:\"remove_background\" require `image`."
    },
    "prompt": {
      "description": "Positive text prompt. REQUIRED for actions \"image\", \"audio\", \"video\", \"controlnet\" and \"ip_adapter\"; for action:\"3d\" it is required in mode \"text\" and optional (passed through only if the chosen node accepts it) in mode \"image\". Unused by action:\"regenerate\", action:\"upscale\" and action:\"remove_background\".",
      "type": "string"
    },
    "negative_prompt": {
      "description": "Negative prompt (default: empty / from defaults). Used by actions \"image\", \"video\", \"controlnet\", \"ip_adapter\" and — for the Stable Audio 3 family only — \"audio\".",
      "type": "string"
    },
    "width": {
      "description": "Image width in pixels. Actions \"image\", \"controlnet\", \"ip_adapter\".",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "height": {
      "description": "Image height in pixels. Actions \"image\", \"controlnet\", \"ip_adapter\".",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "steps": {
      "description": "Sampling steps. Actions \"image\", \"audio\", \"video\", \"controlnet\", \"ip_adapter\" (video defaults to 8 for the distilled model).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "cfg": {
      "description": "CFG scale. Actions \"image\", \"audio\", \"video\", \"controlnet\", \"ip_adapter\" (video defaults to 1.0 for the distilled model).",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "sampler": {
      "description": "Sampler name (e.g. euler, dpmpp_2m). Actions \"image\", \"audio\", \"controlnet\", \"ip_adapter\".",
      "type": "string"
    },
    "scheduler": {
      "description": "Scheduler (e.g. normal, karras). Actions \"image\", \"audio\", \"controlnet\", \"ip_adapter\".",
      "type": "string"
    },
    "seed": {
      "description": "Seed (omit to randomize). Actions \"image\", \"audio\", \"video\", \"controlnet\", \"ip_adapter\".",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "checkpoint": {
      "description": "Checkpoint filename; auto-selected from local models if omitted. The relevant checkpoint differs per action: a diffusion checkpoint for \"image\"/\"controlnet\"/\"ip_adapter\", the LTX checkpoint for \"video\", the Stable Audio 3 checkpoint for \"audio\".",
      "type": "string"
    },
    "batch_size": {
      "description": "action:\"image\" — number of images to generate.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "filename_prefix": {
      "description": "Output filename prefix. action:\"audio\" (default audio/ace_step or audio/stable_audio_3), action:\"video\" (default 'video/ltx-2.3') and action:\"remove_background\" (default 'ComfyUI_cutout').",
      "type": "string"
    },
    "image": {
      "description": "Filename of an image in ComfyUI's input dir (upload it first with upload_image (action:\"image\"), or stage a prior output with upload_image (action:\"stage\")). REQUIRED for action:\"upscale\" and action:\"remove_background\"; the start frame for action:\"video\" image-to-video; the input image for action:\"3d\" in mode \"image\".",
      "type": "string"
    },
    "model": {
      "description": "Model file for the post-processing actions: action:\"upscale\" — an upscale model in models/upscale_models/ (auto-selected from local models if omitted); action:\"remove_background\" — the BiRefNet matting model (default 'BiRefNet_toonout'; auto-downloaded by ComfyUI-RMBG).",
      "type": "string"
    },
    "scale": {
      "description": "action:\"upscale\" — net upscale factor: 2 or 4 (default 4).",
      "anyOf": [
        {
          "type": "number",
          "const": 2
        },
        {
          "type": "number",
          "const": 4
        }
      ]
    },
    "control_image": {
      "description": "action:\"controlnet\" — filename of the (already-uploaded, already-preprocessed) control image in ComfyUI's input dir. REQUIRED for that action.",
      "type": "string"
    },
    "controlnet_model": {
      "description": "action:\"controlnet\" — ControlNet model file (in models/controlnet/); auto-selected if omitted.",
      "type": "string"
    },
    "reference_image": {
      "description": "action:\"ip_adapter\" — filename of the (already-uploaded) reference image in ComfyUI's input dir. REQUIRED for that action.",
      "type": "string"
    },
    "weight": {
      "description": "action:\"ip_adapter\" — IP-Adapter influence on the output, typically 0.0-1.0 (default 0.8); higher = closer to the reference.",
      "type": "number"
    },
    "preset": {
      "description": "action:\"ip_adapter\" — IPAdapterUnifiedLoader preset (default 'PLUS (high strength)').",
      "type": "string"
    },
    "weight_type": {
      "description": "action:\"ip_adapter\" — IPAdapter weight mode (default 'standard' — required by current IPAdapter_plus builds).",
      "type": "string",
      "enum": [
        "standard",
        "prompt is more important",
        "style transfer"
      ]
    },
    "strength": {
      "description": "Two DIFFERENT knobs sharing one field, each with its own range, checked when the action runs: action:\"video\" (i2v only) — adherence to the start frame, 0-1 inclusive (default 0.6; higher = LESS motion); action:\"controlnet\" — conditioning strength, must be > 0, typically 0.0-2.0 (default 1.0; higher = stronger adherence to the control image).",
      "type": "number"
    },
    "seconds": {
      "description": "action:\"video\" — clip length in seconds (default 4; ~10s max).",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "resolution": {
      "description": "action:\"video\" — 'WIDTHxHEIGHT' e.g. '768x512' (rounded to multiples of 32; default 768x512).",
      "type": "string"
    },
    "fps": {
      "description": "action:\"video\" — frames per second (default 25).",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "mode": {
      "description": "action:\"3d\" — \"text\" = text-to-3D from `prompt`; \"image\" = image-to-3D from an uploaded input `image`. REQUIRED for that action.",
      "type": "string",
      "enum": [
        "text",
        "image"
      ]
    },
    "node": {
      "description": "action:\"3d\" — explicit 3D API node class_type to use (e.g. \"MeshyTextToModelNode\"); auto-selected if omitted. Use list_api_nodes with filter \"3d\" to see options.",
      "type": "string"
    },
    "inputs": {
      "description": "action:\"3d\" — provider-specific extra inputs passed through to the node (e.g. style, texture, quality). Use list_api_nodes (action:\"schema\") on the chosen node for valid keys.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "model_family": {
      "description": "action:\"audio\" — audio model family; determines which workflow template and model loaders to use. REQUIRED for that action.",
      "type": "string",
      "enum": [
        "ace_step_1.5",
        "stable_audio_3"
      ]
    },
    "duration": {
      "description": "action:\"audio\" — audio duration in seconds. REQUIRED for that action.",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "unet": {
      "description": "action:\"audio\" — ACE UNet model filename (in models/diffusion_models/); auto-selected if omitted.",
      "type": "string"
    },
    "vae": {
      "description": "action:\"audio\" — ACE VAE model filename (in models/vae/); auto-selected if omitted.",
      "type": "string"
    },
    "clip_a": {
      "description": "action:\"audio\" — primary text encoder filename (in models/text_encoders/); auto-selected if omitted.",
      "type": "string"
    },
    "clip_b": {
      "description": "action:\"audio\" — secondary text encoder filename (in models/text_encoders/); auto-selected if omitted.",
      "type": "string"
    },
    "clip": {
      "description": "action:\"audio\" — Stable Audio CLIP encoder filename (in models/text_encoders/); auto-selected if omitted.",
      "type": "string"
    },
    "lyrics": {
      "description": "action:\"audio\" — lyrics or song structure description (ACE only — section-by-section breakdown).",
      "type": "string"
    },
    "language": {
      "description": "action:\"audio\" — language code for prompt (ACE only, default: 'en').",
      "type": "string"
    },
    "musical_key": {
      "description": "action:\"audio\" — target musical key (ACE only, e.g. 'C major', 'E minor'; default: 'C major').",
      "type": "string"
    },
    "shift": {
      "description": "action:\"audio\" — ModelSamplingAuraFlow shift parameter (ACE only, default: 3).",
      "type": "number"
    },
    "guidance_scale": {
      "description": "action:\"audio\" — TextEncodeAceStepAudio1.5 cfg_scale, the text encoder guidance scale (ACE only, default: 2).",
      "type": "number"
    },
    "bpm": {
      "description": "action:\"audio\" — TextEncodeAceStepAudio1.5 tempo in beats per minute (ACE only, 10-300, default: 120).",
      "type": "integer",
      "minimum": 10,
      "maximum": 300
    },
    "timesignature": {
      "description": "action:\"audio\" — TextEncodeAceStepAudio1.5 time signature (ACE only, one of '2'/'3'/'4'/'6', default: '4').",
      "type": "string",
      "enum": [
        "2",
        "3",
        "4",
        "6"
      ]
    },
    "temperature": {
      "description": "action:\"audio\" — TextEncodeAceStepAudio1.5 LLM sampling temperature (ACE only, 0-2, default: 0.85).",
      "type": "number",
      "minimum": 0,
      "maximum": 2
    },
    "top_p": {
      "description": "action:\"audio\" — TextEncodeAceStepAudio1.5 LLM top-p nucleus sampling (ACE only, 0-2000, default: 0.9).",
      "type": "number",
      "minimum": 0,
      "maximum": 2000
    },
    "top_k": {
      "description": "action:\"audio\" — TextEncodeAceStepAudio1.5 LLM top-k sampling (ACE only, 0-100, default: 0 = disabled).",
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    },
    "min_p": {
      "description": "action:\"audio\" — TextEncodeAceStepAudio1.5 LLM min-p sampling (ACE only, 0-1, default: 0).",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "generate_audio_codes": {
      "description": "action:\"audio\" — generate audio codes via the TextEncodeAceStepAudio1.5 LLM (ACE only, default: true).",
      "type": "boolean"
    },
    "audio_quality": {
      "description": "action:\"audio\" — SaveAudioMP3 bitrate/quality (ACE and stable_audio_3, one of 'V0'/'128k'/'320k', default: '320k').",
      "type": "string",
      "enum": [
        "V0",
        "128k",
        "320k"
      ]
    },
    "asset_id": {
      "description": "action:\"regenerate\" — asset id of the source generation. REQUIRED for that action.",
      "type": "string"
    },
    "overrides": {
      "description": "action:\"regenerate\" — map of input-name → new value applied to every node that already has that input. Common keys: cfg, steps, sampler_name, scheduler, seed, denoise, text.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "disable_random_seed": {
      "description": "action:\"regenerate\" and action:\"3d\" — if true, do not randomize seed fields. For action:\"regenerate\", combine with `overrides.seed` to reproduce the exact original image.",
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "get",
        "set",
        "get_ui",
        "set_ui"
      ],
      "description": "Which settings operation to perform, and on WHICH store. \"get\"/\"set\" are the MCP server's own generation defaults (width, steps, cfg, …); \"get_ui\"/\"set_ui\" are ComfyUI's separate frontend UI settings (the Comfy.* ids). \"get\" takes no other parameters; \"set\" requires `values` (optional `persist`); \"get_ui\" takes an optional `id` or `filter`; \"set_ui\" requires `id` + `value`."
    },
    "values": {
      "description": "action:\"set\" — REQUIRED. Key/value map of GENERATION defaults to set. Keys are typically lowercase (e.g. width, steps). Not for Comfy.* UI ids — those go through action:\"set_ui\".",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "persist": {
      "description": "action:\"set\" — if true, write to the config file in addition to runtime.",
      "type": "boolean"
    },
    "id": {
      "description": "ComfyUI UI setting id, e.g. 'Comfy.Validation.Workflows'. REQUIRED for action:\"set_ui\". OPTIONAL for action:\"get_ui\" — omit to list all stored settings.",
      "type": "string"
    },
    "filter": {
      "description": "action:\"get_ui\" — case-insensitive substring filter on setting ids when listing (e.g. 'preview'). Ignored when `id` is given.",
      "type": "string"
    },
    "value": {
      "description": "action:\"set_ui\" — REQUIRED. New value for the ComfyUI UI setting. Stored as-is; booleans/numbers are NOT coerced from strings (pass true, not \"true\").",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        {
          "type": "array",
          "items": {}
        }
      ]
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "list",
        "diagnose",
        "stats",
        "suggest"
      ],
      "description": "Which history view to return. \"list\" and \"diagnose\" read ComfyUI's execution history and take an optional `prompt_id`; \"stats\" and \"suggest\" read this server's own local generation-settings database and take `model_family` (plus `lora_hash`/`search`/`limit` for \"suggest\"). No action requires any other field."
    },
    "prompt_id": {
      "description": "Actions \"list\" and \"diagnose\" — the prompt ID to look up (returned by enqueue_workflow). For action:\"list\", if omitted, returns the most recent COMMITTED execution (chosen by ComfyUI's queue number, not dict order); immediately after a run finishes it can briefly lag by one until ComfyUI commits the new entry, so pass the prompt_id from enqueue_workflow to get that exact run, and prefer the run-finished event for naming a just-produced output. For action:\"diagnose\", omit to diagnose the most recent FAILED run — preferred over a newer successful one — falling back to the most recent run if nothing failed.",
      "type": "string"
    },
    "model_family": {
      "description": "Actions \"stats\" and \"suggest\" — model-family key to scope to, e.g. 'sdxl', 'flux', 'qwen_image', 'illustrious'.",
      "type": "string"
    },
    "lora_hash": {
      "description": "action:\"suggest\" — AutoV2 hash (10 chars) of a specific LoRA to find settings for.",
      "type": "string"
    },
    "search": {
      "description": "action:\"suggest\" — full-text search on model/LoRA filenames (e.g. 'copax', 'lightning').",
      "type": "string"
    },
    "limit": {
      "description": "action:\"suggest\" — max results (default 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "get",
        "view",
        "list_outputs",
        "convert",
        "analyze_color",
        "list_assets",
        "asset_metadata"
      ],
      "description": "Which image/asset operation to perform. \"get\" requires `filename`; \"view\" and \"asset_metadata\" require `asset_id`; \"convert\" requires `format` plus exactly one of `asset_id`/`path`; action:\"analyze_color\" takes one source (`asset_id`, `filename`, or `path`); \"list_outputs\" and action:\"list_assets\" take no required parameters."
    },
    "filename": {
      "description": "Output image filename or a relative `subfolder/filename` reference from get_history, e.g. PulID_Klein_00001_.png or out_F/PulID_Klein_00001_.png. REQUIRED for action:\"get\". Relative prefixes are split automatically; absolute paths, drive prefixes, and `..` segments are refused. OPTIONAL for action:\"analyze_color\", where it is one of the three ways to name a source (pair it with subfolder/type).",
      "type": "string"
    },
    "asset_id": {
      "description": "Asset id returned by action:\"list_assets\" or job completion. REQUIRED for actions \"view\" and \"asset_metadata\". OPTIONAL for \"convert\" (provide exactly one of asset_id or path) and action:\"analyze_color\" (one of asset_id, filename, or path).",
      "type": "string"
    },
    "type": {
      "description": "ComfyUI directory the file lives in: output (default), input, or temp. Used by action:\"get\" and by action:\"analyze_color\" when the source is a `filename`.",
      "type": "string",
      "enum": [
        "output",
        "input",
        "temp"
      ]
    },
    "subfolder": {
      "description": "Subfolder within the directory, if any (default empty). Used by action:\"get\" and by action:\"analyze_color\" when the source is a `filename`. If filename already includes a relative prefix, it is combined with this subfolder.",
      "type": "string"
    },
    "save_dir": {
      "description": "action:\"get\" — absolute local directory to save the file in. Defaults to a 'comfyui-images' folder inside the platform temp directory (os.tmpdir()), which is created if missing. A RELATIVE value is resolved against this MCP process's working directory, which is the client's choice and may not be writable. On Windows a drive-less path like \\out is resolved against this process's CURRENT DRIVE, not a drive you chose. Prefer a fully-qualified path (C:\\... or \\\\server\\share); the returned 'Saved to:' line always names the resolved absolute path.",
      "type": "string"
    },
    "max_preview_bytes": {
      "description": "action:\"get\" — ceiling on the base64 payload returned INLINE (default ~16MB). The file saved to disk is never affected. Lower it when your client rejects or truncates large tool results; the reply says when it downscaled and by how much.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "max_preview_dimension": {
      "description": "action:\"get\" — ceiling on the inline preview's longest side in pixels (default 4096). Applies even when the byte budget is satisfied, since some consumers reject by dimension — but only for an image this server can decode; an undecodable one under the byte budget is passed through as-is. Does not affect the saved file.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "path": {
      "description": "A source image path. action:\"convert\" — a path under COMFYUI_PATH/output (provide exactly one of asset_id or path). action:\"analyze_color\" — an absolute image path, or a path under the ComfyUI output dir (videos: extract a frame to PNG first).",
      "type": "string"
    },
    "limit": {
      "description": "action:\"list_outputs\" — max media files to return, 1..100 (default 20). action:\"list_assets\" — max records to return (default: all, no upper bound).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "pattern": {
      "description": "action:\"list_outputs\" — filter by filename pattern (case-insensitive substring match).",
      "type": "string"
    },
    "format": {
      "description": "Two unrelated meanings, one per action — the enum is the union of both and each action accepts only its own half. action:\"list_outputs\" — RESPONSE SHAPE: \"markdown\" (default, human/agent-readable) or \"json\" ({images:[{filename,subfolder,kind,size,modified,type?}]} — type is \"temp\" for VHS videos written with save_output unchecked, omitted for output/). action:\"convert\" — REQUIRED target encoded image format: \"png\", \"jpeg\" or \"webp\".",
      "type": "string",
      "enum": [
        "markdown",
        "json",
        "png",
        "jpeg",
        "webp"
      ]
    },
    "quality": {
      "description": "action:\"convert\" — encoder quality, 1-100. Applies where supported by the selected format.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "progressive": {
      "description": "action:\"convert\" — JPEG only: write a progressive JPEG.",
      "type": "boolean"
    },
    "lossless": {
      "description": "action:\"convert\" — WebP only: write lossless WebP.",
      "type": "boolean"
    },
    "effort": {
      "description": "action:\"convert\" — WebP only: encoder effort, 0-6.",
      "type": "integer",
      "minimum": 0,
      "maximum": 6
    },
    "out_path": {
      "description": "action:\"convert\" — optional output path under COMFYUI_PATH/output where the converted image should be written.",
      "type": "string"
    },
    "reference_path": {
      "description": "action:\"analyze_color\" — optional reference image to shot-match against; returns target−reference deltas for contrast, black/white points, saturation, and per-channel means.",
      "type": "string"
    },
    "histogram": {
      "description": "action:\"analyze_color\" — also return an overlaid R/G/B/luma histogram PNG for visual confirmation (default false).",
      "type": "boolean"
    },
    "since": {
      "description": "action:\"list_assets\" — ISO timestamp; only return assets created at or after this time.",
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "stats",
        "logs",
        "health"
      ],
      "description": "Which read to perform. \"stats\" takes no other parameters; \"logs\" takes `max_lines`/`keyword`; \"health\" takes `model_categories`/`recent_errors`. None of them is required."
    },
    "max_lines": {
      "description": "action:\"logs\" — maximum number of log lines to return from the end (default: 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 2000
    },
    "keyword": {
      "description": "action:\"logs\" — filter log lines containing this keyword (case-insensitive). Examples: 'error', 'warning', 'VRAM', a node name.",
      "type": "string"
    },
    "model_categories": {
      "description": "action:\"health\" — override the model categories to poll (defaults to checkpoints, diffusion_models, loras, vae, text_encoders, controlnet).",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "recent_errors": {
      "description": "action:\"health\" — how many recent error/traceback lines to include from /internal/logs (default 20, max 200).",
      "type": "integer",
      "minimum": 0,
      "maximum": 200
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "get",
        "list",
        "strip",
        "slice",
        "from_image",
        "analyze",
        "query",
        "prompt_director"
      ],
      "description": "Which read to perform. \"list\" and \"prompt_director\" take no required parameters; \"get\" and \"analyze\" require `filename`; \"strip\", \"slice\" and \"query\" require exactly one of `path`/`filename`/`graph` (and \"slice\" also requires `groups`); \"from_image\" requires `image_path`."
    },
    "filename": {
      "description": "Workflow library name, exactly as action:\"list\" reports it. A workflow filed in a folder keeps its folder in the name ('VIDEO/MiniMaxH3/clip.json') and that whole string goes here. An absolute path under the live ComfyUI workspace (e.g. a JSON in data/_downloads) is read from disk, not the user library. REQUIRED for action:\"get\" and action:\"analyze\"; one of the three sources for \"strip\", \"slice\" and \"query\".",
      "type": "string"
    },
    "format": {
      "default": "api",
      "description": "action:\"get\" — 'api' (default, recommended) converts to compact API format with named inputs, connection references, and _meta.mode flags for muted/bypassed nodes; 'ui' returns the raw UI format with layout positions and links arrays. action:\"strip\" — 'api' (default) strips to the flat resolved graph; 'raw' returns the file/graph unchanged. Each action accepts only its own two values (this field is the union of what the two tools it replaces accepted) and refuses the third rather than guessing at an alias.",
      "type": "string",
      "enum": [
        "ui",
        "api",
        "raw"
      ]
    },
    "path": {
      "description": "action:\"strip\" / \"slice\" / \"query\" — Absolute path to a workflow .json on the connected ComfyUI host (e.g. C:\\\\Users\\\\you\\\\ComfyUI\\\\user\\\\default\\\\workflows\\\\pusa_extend.json). LOCAL ComfyUI: read from this host's disk — no library lookup. If a userdata path is missing the `workflows` segment after `user/default`, it is retried with that segment restored, preserving the filename exactly. REMOTE ComfyUI: not opened on this MCP host (a POSIX path is not Win32-resolved). A path under user/default/workflows, user/workflows, or models/workflows is fetched from that server's userdata library; any other remote absolute path is refused.",
      "type": "string"
    },
    "graph": {
      "description": "action:\"strip\" / \"slice\" / \"query\" — Inline workflow JSON (UI format for \"strip\"/\"slice\"; UI or API for \"query\"), as an alternative to path/filename.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "groups": {
      "description": "action:\"slice\" (REQUIRED) — Group-title substrings (case-insensitive) whose output nodes seed the slice — CSV string or array, e.g. 'TEXT TO IMAGE,TXT' or ['extend','sampler']. Shared post-proc is pulled in via the closure.",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "image_path": {
      "description": "action:\"from_image\" (REQUIRED) — Absolute path to a ComfyUI-generated PNG file",
      "type": "string"
    },
    "view": {
      "default": "summary",
      "description": "action:\"analyze\" — summary (default): structured text with sections, node IDs, key settings, virtual wires, and full connection graph — best for AI understanding. overview: mermaid diagram showing sections as summary nodes with cross-section data flow. detail: mermaid diagram for one section (requires section parameter). list: text listing of all sections with data flow summary. flat: single mermaid flowchart of the entire workflow (best for small workflows). health: graph-health heuristics (disconnected nodes, duplicate model loads, orphaned branches, muted/bypassed, a sampler running denoise below 1.0 on an empty latent, an image-edit graph whose sampled canvas is not derived from the reference).",
      "type": "string",
      "enum": [
        "summary",
        "overview",
        "detail",
        "list",
        "flat",
        "health"
      ]
    },
    "section": {
      "description": "action:\"analyze\" — Section name for detail view. Use view='list' first to see available section names.",
      "type": "string"
    },
    "node_id": {
      "description": "action:\"prompt_director\" — Optional ComfyUI node id; omit to list all recent Prompt Director runtime states.",
      "type": "string"
    },
    "types": {
      "description": "action:\"query\" — Keep nodes whose class_type contains ANY of these (case-insensitive).",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "title": {
      "description": "action:\"query\" — Keep nodes whose title contains this.",
      "type": "string"
    },
    "where": {
      "description": "action:\"query\" — Widget predicates, ANDed: 'cfg>7', 'sampler_name=euler', 'text~sunset'.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "ids": {
      "description": "action:\"query\" — Keep exactly these node ids.",
      "type": "array",
      "items": {
        "type": [
          "string",
          "number"
        ]
      }
    },
    "upstream_of": {
      "description": "action:\"query\" — Scope to the dependency closure FEEDING this node id.",
      "type": [
        "string",
        "number"
      ]
    },
    "downstream_of": {
      "description": "action:\"query\" — Scope to the nodes CONSUMING this node id's outputs.",
      "type": [
        "string",
        "number"
      ]
    },
    "depth": {
      "description": "action:\"query\" — Max hops from the traversal seed (seed=0). Absent = full closure.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "fields": {
      "description": "action:\"query\" — Projection: compact one-liners (default), bare ids, or detail JSON rows.",
      "type": "string",
      "enum": [
        "ids",
        "compact",
        "detail"
      ]
    },
    "group_by": {
      "description": "action:\"query\" — Aggregate: counts per class_type instead of listing.",
      "type": "string",
      "enum": [
        "type"
      ]
    },
    "limit": {
      "description": "action:\"query\" — Max nodes listed (default 40, max 200).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "max_chars": {
      "description": "action:\"query\" — Output character bound (default 12000, max 60000). Raise this — not `limit` — when the truncation tail says the char budget cut the result.",
      "type": "integer",
      "minimum": 500,
      "maximum": 60000
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "install",
        "update",
        "update_all",
        "panel",
        "self_update",
        "environment",
        "configure_manager"
      ],
      "description": "Which install/environment operation to perform. action:\"update\", action:\"update_all\" and action:\"environment\" take no other parameters; action:\"install\" requires `target_path`; action:\"panel\" takes `panel_action` (+ `version`/`reason` for a pin); action:\"self_update\" takes `self_update_action`; action:\"configure_manager\" requires `manager_setting` (+ `value`)."
    },
    "target_path": {
      "description": "action:\"install\" — REQUIRED absolute path to the workspace directory to install ComfyUI into. Must be empty or non-existent.",
      "type": "string",
      "minLength": 1
    },
    "skip_manager": {
      "description": "action:\"install\" — if true, do not clone/install ComfyUI-Manager. Default false (Manager is installed).",
      "type": "boolean"
    },
    "use_uv": {
      "description": "action:\"install\" — if true, prefer `uv pip install` over plain pip when uv is available on PATH. Falls back to pip if uv is missing. Default false.",
      "type": "boolean"
    },
    "version": {
      "description": "action:\"install\" — ComfyUI version to install (comfy-cli semantics): \"nightly\" (default-branch HEAD), \"latest\" (newest release tag), or a semantic version like \"0.3.40\" (checked out as tag v0.3.40). Raw git refs/branches are rejected. Omit to track the default branch HEAD. ALSO used by action:\"panel\" + panel_action:\"pin\", where it is the PANEL version to hold at, e.g. '0.11.20' (take it from the installedVersion that panel_action:\"status\" reports).",
      "type": "string"
    },
    "panel_action": {
      "default": "status",
      "description": "action:\"panel\" — which sidebar-panel operation to run. status: report installed/version/dev-symlink/pin plus a sync assessment (never errors). sync: bring the panel up to what this orchestrator needs — no-ops when already current, WARNS ONLY when pinned, and reports the version re-read from disk afterwards. install: add the panel (nightly). update: pull the latest nightly. Works on either install shape — a git checkout is fast-forwarded, and a Comfy Registry ZIP install (which has no .git) is replaced with a verified fresh clone, keeping the previous copy outside custom_nodes. Success is always re-read from disk. reinstall: uninstall + reinstall (nightly). pin: hold the panel at a version (requires `version`). unpin: clear the pin so a sync can proceed. unlock: recover from a crashed/killed orchestrator's leftover panel operation lock — reclaims it ONLY when it is provably abandoned (older than the stale threshold AND its recorded owner process is dead), and refuses with the observed state otherwise. install/update/reinstall/sync refuse on a dev symlink or an active pin, and require a local workspace (COMFYUI_PATH or the saved default workspace).",
      "type": "string",
      "enum": [
        "status",
        "install",
        "update",
        "reinstall",
        "sync",
        "pin",
        "unpin",
        "unlock"
      ]
    },
    "reason": {
      "description": "action:\"panel\" + panel_action:\"pin\" only: why the user is pinning (stored with the pin).",
      "type": "string"
    },
    "self_update_action": {
      "default": "status",
      "description": "action:\"self_update\" — status: report install mode + current vs latest version + dev-link note (never errors). update: update to the latest published version (refuses on a dev link; no-op when already up to date or for npx).",
      "type": "string",
      "enum": [
        "status",
        "update"
      ]
    },
    "manager_setting": {
      "description": "action:\"configure_manager\" — REQUIRED. Which ComfyUI-Manager setting to change. HTTP API: set_preview_method, set_db_mode, set_component_policy, set_update_policy, set_channel, reset_queue. config.ini fallback: set_network_mode, set_security_level.",
      "type": "string",
      "enum": [
        "set_preview_method",
        "set_db_mode",
        "set_component_policy",
        "set_update_policy",
        "set_channel",
        "reset_queue",
        "set_network_mode",
        "set_security_level"
      ]
    },
    "value": {
      "description": "action:\"configure_manager\" — value for the chosen `manager_setting` (omit only for reset_queue). Allowed values per setting — set_preview_method: auto | latent2rgb | taesd | none; set_db_mode: local | cache | remote; set_component_policy: workflow | higher | mine; set_update_policy: stable-comfyui | nightly-comfyui; set_channel: a channel name (e.g. default); set_network_mode: public | private | offline; set_security_level: strong | normal | normal- | weak. HTTP-API settings take effect live; the config.ini ones (set_network_mode, set_security_level) apply only after a ComfyUI restart.",
      "type": "string"
    }
  },
  "required": [
    "action"
  ]
}

{
  "destructiveHint": true,
  "openWorldHint": true,
  "idempotentHint": false
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "install",
        "update",
        "reinstall",
        "fix",
        "uninstall",
        "enable",
        "disable",
        "list",
        "sync_deps"
      ],
      "description": "Which custom-node operation to perform. \"install\", \"update\", \"reinstall\", \"fix\", \"uninstall\", \"enable\" and \"disable\" require `id`; \"list\" and \"sync_deps\" take no required parameters."
    },
    "id": {
      "description": "The pack to act on. REQUIRED for actions \"install\", \"update\", \"reinstall\", \"fix\", \"uninstall\", \"enable\" and \"disable\". For \"install\" this is a registry id, git URL, or node-pack name (find one with search_custom_nodes); for \"update\"/\"fix\" it may also be 'all' (every installed pack); for \"update\"/\"reinstall\"/\"fix\"/\"uninstall\"/\"enable\"/\"disable\" it is a registry id / module name of an INSTALLED pack.",
      "type": "string"
    },
    "source": {
      "description": "action:\"install\" — how to interpret `id` (default 'auto', which detects git URLs vs registry ids).",
      "type": "string",
      "enum": [
        "registry",
        "git",
        "auto"
      ]
    },
    "version": {
      "description": "Version to install. action:\"install\" — e.g. 'latest', 'nightly', or a semver; for git installs this is treated as a git ref unless `ref` is also provided, and registry installs default to 'latest'. action:\"reinstall\" — version to reinstall (default 'latest').",
      "type": "string"
    },
    "ref": {
      "description": "action:\"install\" — git ref (commit SHA, branch, or tag) to pin when installing a git URL. Overrides any ref parsed from the URL and any `version` value. Ignored for registry-id installs.",
      "type": "string"
    },
    "mode": {
      "description": "Two distinct meanings, one per action group. For actions \"install\"/\"update\"/\"reinstall\"/\"fix\": the ComfyUI-Manager data source (default 'remote'); 'remote' fetches the live node list, 'local'/'cache' use bundled/cached data. For action:\"list\": 'default' lists the installed packs as they are on disk NOW; 'imported' returns that SAME custom_nodes/ scan frozen at ComfyUI startup, so the only difference is packs installed or removed since the server booted. 'imported' is NOT an import-success filter: it includes DISABLED packs and cannot tell you whether the Python of a pack actually loaded — for that use node_pack action:\"verify\", which checks the node class_types of the pack against /object_info on the running server. Passing a value from the wrong group is refused, naming the ones the action accepts.",
      "type": "string",
      "enum": [
        "remote",
        "local",
        "cache",
        "default",
        "imported"
      ]
    },
    "channel": {
      "description": "ComfyUI-Manager channel name (default 'default').",
      "type": "string"
    },
    "useCmCli": {
      "description": "Prefer the official comfy-cli subprocess instead of the ComfyUI-Manager HTTP API. Local operations use comfy-cli by default; set false to force Manager HTTP. Requires a local ComfyUI install — for actions \"install\"/\"disable\"/\"enable\"/\"uninstall\"/\"list\", an unavailable or unsupported CLI falls back to Manager HTTP automatically (disclosed in the result); \"update\"/\"reinstall\"/\"fix\" do not fall back.",
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "status",
        "assess",
        "apply"
      ],
      "description": "Which kitchen operation. \"status\" takes no other parameters; \"assess\" takes `workflow`; \"apply\" takes `recommendation_id` and `confirm` for restarts/downloads."
    },
    "workflow": {
      "description": "action:\"assess\" / \"apply\" — workflow JSON (API-format {id:{class_type,inputs}} or UI-format {nodes,links}), as a string or object.",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "recommendation_id": {
      "description": "action:\"apply\" — id from assess (e.g. \"fp8_unet_fast:12\" or \"ck_attention\").",
      "type": "string"
    },
    "confirm": {
      "description": "action:\"apply\" — required true for anything that restarts or downloads. Widget edits do not need it.",
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "list",
        "schema",
        "generate"
      ],
      "description": "Which API-node operation to perform. \"list\" takes an optional `filter`; \"schema\" requires `class_type`; \"generate\" requires `class_type` + `inputs` (optional `disable_random_seed`)."
    },
    "filter": {
      "description": "action:\"list\" — case-insensitive substring to narrow results, matched against class_type, display name, or category (e.g. \"image\", \"video\", \"kling\").",
      "type": "string"
    },
    "class_type": {
      "description": "The node class_type, e.g. \"FluxProImageNode\". REQUIRED for action:\"schema\" and action:\"generate\"; find one with action:\"list\".",
      "type": "string"
    },
    "inputs": {
      "description": "action:\"generate\" — REQUIRED. Input values keyed by input name, per the node's schema (action:\"schema\").",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "disable_random_seed": {
      "description": "action:\"generate\" — if true, do not randomize seed/noise_seed inputs.",
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "list",
        "remove",
        "embeddings",
        "list_paths",
        "add_path",
        "remove_path"
      ],
      "description": "Which inventory operation to perform. \"list\" (optional `model_type`), \"embeddings\" and \"list_paths\" are READ-ONLY. \"remove\" DELETES the model file named by `path` — required, and destructive. \"add_path\"/\"remove_path\" edit the extra-search-path YAML and require `category` + `path`; they never touch model files."
    },
    "model_type": {
      "description": "action:\"list\" — filter by model type (e.g. 'checkpoints', 'loras'). Lists all types if omitted.",
      "type": "string",
      "enum": [
        "checkpoints",
        "loras",
        "vae",
        "upscale_models",
        "controlnet",
        "embeddings",
        "clip",
        "diffusers",
        "diffusion_models",
        "gligen",
        "hypernetworks",
        "photomaker",
        "style_models",
        "text_encoders",
        "unet"
      ]
    },
    "path": {
      "description": "REQUIRED by three actions, and it means two DIFFERENT things — read this before calling. action:\"remove\": the MODEL FILE to DELETE, relative to the ComfyUI models/ directory (e.g. 'checkpoints/sd_xl_base_1.0.safetensors'); the leading segment is the category used to locate the file in extra roots too. action:\"add_path\" / action:\"remove_path\": a DIRECTORY to add to / remove from the extra-search-path YAML for `category` (absolute paths are safest; relative paths are resolved by ComfyUI) — no file is deleted.",
      "type": "string",
      "minLength": 1
    },
    "target": {
      "description": "action:\"list_paths\" / \"add_path\" / \"remove_path\" — config target. auto (default) is LIVE-FIRST: the running ComfyUI's own --extra-model-paths-config, else the extra_model_paths.yaml next to its main.py. When no server is reachable, auto shows the Desktop config if one exists, otherwise standalone. When a reachable LOCAL server does not expose main.py, listing degrades to the server-named config (if it exists here) or the local auto-selected one, explicitly marked as an unconfirmed display fallback; mutations refuse instead. standalone forces <ComfyUI root>/extra_model_paths.yaml, where the root is COMFYUI_PATH (or an auto-detected install) and falls back to the saved default workspace; desktop forces the OS app-data extra_models_config.yaml. Use standalone/desktop (or config_path) to deliberately target a file the running server does not read.",
      "type": "string",
      "enum": [
        "auto",
        "standalone",
        "desktop"
      ]
    },
    "config_path": {
      "description": "action:\"list_paths\" / \"add_path\" / \"remove_path\" — explicit YAML config path override, mainly for advanced/manual installs.",
      "type": "string"
    },
    "group": {
      "description": "action:\"add_path\" / \"remove_path\" — top-level YAML group to edit. Defaults to comfyui_mcp.",
      "type": "string"
    },
    "category": {
      "description": "REQUIRED for action:\"add_path\" / action:\"remove_path\" — the ComfyUI search-path category, e.g. checkpoints, loras, vae, diffusion_models, unet_gguf, or custom_nodes.",
      "type": "string",
      "minLength": 1
    },
    "is_default": {
      "description": "action:\"add_path\" — set is_default on a newly-created group. Existing groups are not overwritten.",
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "list",
        "read_workflow",
        "read_manifest",
        "list_templates",
        "check_runtime",
        "extract_deps",
        "install_deps",
        "skill_list",
        "skill_read",
        "generate_skill"
      ],
      "description": "Which knowledge operation to perform. \"list\", \"list_templates\" and \"skill_list\" take no other parameters; \"read_workflow\", \"read_manifest\" and \"skill_read\" require `name`; \"check_runtime\" takes `pack` OR `graph`; \"extract_deps\" and \"install_deps\" require `workflow` (and \"install_deps\" INSTALLS custom nodes — the only action here that installs, though \"generate_skill\" also WRITES to disk: its skill cache on every miss, plus `install_in` when set); \"generate_skill\" requires `source` (optional `install_in`/`refresh`)."
    },
    "name": {
      "description": "REQUIRED for action:\"read_workflow\" and action:\"read_manifest\" — the pack name (a directory under packs/, e.g. 'krea2-txt2img-manual'), from action:\"list\". REQUIRED for action:\"skill_read\" — the skill name (a directory under plugin/skills/, e.g. 'krea2-txt2img'), from action:\"skill_list\".",
      "type": "string",
      "minLength": 1
    },
    "pack": {
      "description": "action:\"check_runtime\" — a bundled pack name (from action:\"list\"). Packs are local/free; this confirms it from the actual graph.",
      "type": "string"
    },
    "graph": {
      "description": "action:\"check_runtime\" — a workflow graph to classify (UI or API/prompt format), as an object or a JSON string. Use this for ad-hoc/generated workflows.",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "workflow": {
      "description": "REQUIRED for action:\"extract_deps\" and action:\"install_deps\" — a ComfyUI workflow in API format (JSON string or object).",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "source": {
      "description": "REQUIRED for action:\"generate_skill\" — a ComfyUI Registry node ID (e.g. 'comfyui-impact-pack') or a GitHub repository URL.",
      "type": "string"
    },
    "install_in": {
      "description": "action:\"generate_skill\" — optional directory to write the generated SKILL.md into. Created recursively if missing; an existing SKILL.md is overwritten. Omit to only return the markdown without touching disk.",
      "type": "string"
    },
    "refresh": {
      "description": "action:\"generate_skill\" — bypass the read-through cache and rebuild the SKILL.md, overwriting the cached entry.",
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "category": {
      "description": "Only list this category (as shown in the catalog headings).",
      "type": "string"
    },
    "search": {
      "description": "Case-insensitive substring filter over tool names and descriptions.",
      "type": "string"
    }
  }
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "read",
        "propose",
        "fetch_civitai"
      ],
      "description": "Which metadata operation to perform. All three actions require `category` + `name`; \"propose\" also requires `fields` (optional `note`); \"fetch_civitai\" takes an optional `version_id`."
    },
    "category": {
      "description": "ComfyUI model folder, e.g. 'loras'. REQUIRED for all three actions.",
      "type": "string"
    },
    "name": {
      "description": "model filename incl. .safetensors. REQUIRED for all three actions.",
      "type": "string"
    },
    "fields": {
      "description": "action:\"propose\" — REQUIRED proposed field map (see description).",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "note": {
      "description": "action:\"propose\" — optional one-line note about this revision.",
      "type": "string"
    },
    "version_id": {
      "description": "action:\"fetch_civitai\" — force a specific Civitai modelVersionId if hash lookup misses.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "scaffold",
        "verify",
        "publish",
        "list_files",
        "read",
        "search",
        "write",
        "patch",
        "git"
      ],
      "description": "Which node-pack operation to perform. \"scaffold\" requires `name` + `display_name`; \"list_files\" requires `pack`; \"read\" requires `path`; \"search\" requires `query`; \"write\" requires `path` + `content`; \"patch\" requires `patch`; \"git\" requires `pack` + `git_action`. \"verify\" and \"publish\" have no required parameters — \"verify\" resolves the pack from `name` (or checks `class_types` directly), \"publish\" from `name` or `path`."
    },
    "name": {
      "description": "Pack folder name under <COMFYUI_PATH>/custom_nodes/. REQUIRED for action:\"scaffold\" — a safe lowercase slug (letters, digits, hyphens, underscores), e.g. 'my-cool-nodes', which becomes the directory under custom_nodes/ and the pyproject [project].name. For action:\"verify\", the pack whose __init__.py NODE_CLASS_MAPPINGS keys are inferred and checked when `class_types` is omitted. For action:\"publish\", the pack folder to publish (give this or `path`).",
      "type": "string"
    },
    "display_name": {
      "description": "action:\"scaffold\" — REQUIRED. Human-readable name shown in the ComfyUI node menu and the registry listing.",
      "type": "string"
    },
    "category": {
      "description": "action:\"scaffold\" — node menu category for the sample node (default 'custom').",
      "type": "string"
    },
    "description": {
      "description": "action:\"scaffold\" — short description written to pyproject [project].description.",
      "type": "string"
    },
    "publisher_id": {
      "description": "action:\"scaffold\" — your Comfy Registry publisher id, stamped into [tool.comfy].PublisherId. If omitted a placeholder is written that you must replace before publishing.",
      "type": "string"
    },
    "with_frontend": {
      "description": "action:\"scaffold\" — if true, also generate a web/js/<name>.js extension stub and set WEB_DIRECTORY (default false).",
      "type": "boolean"
    },
    "with_ci": {
      "description": "action:\"scaffold\" — if true, also generate .github/workflows/publish_action.yml (Comfy-Org/publish-node-action; needs the REGISTRY_ACCESS_TOKEN repo secret) so pushing a pyproject.toml version bump auto-publishes (default false).",
      "type": "boolean"
    },
    "overwrite": {
      "description": "action:\"scaffold\" — overwrite template files in an existing pack directory instead of refusing (default false). action:\"write\" — overwrite an existing file instead of refusing (default false).",
      "type": "boolean"
    },
    "class_types": {
      "description": "action:\"verify\" — explicit NODE_CLASS_MAPPINGS keys to confirm are registered in /object_info. Takes precedence over inferring from `name`.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "restart": {
      "description": "action:\"verify\" — restart ComfyUI before checking so newly-added packs load (default true). Set false to check the live server as-is.",
      "type": "boolean"
    },
    "pack": {
      "description": "Pack folder name under custom_nodes/ (e.g. 'ComfyUI-Manager'). REQUIRED for action:\"list_files\" and action:\"git\".",
      "type": "string"
    },
    "path": {
      "description": "REQUIRED for action:\"read\" and action:\"write\": a pack-relative path under custom_nodes/, e.g. 'MyPack/nodes.py'. For action:\"search\", the pack-relative directory to search, or '.' for all packs (default '.'). For action:\"publish\" ONLY, this is instead an explicit absolute path to the pack directory to publish, and it overrides `name` when both are given.",
      "type": "string"
    },
    "content": {
      "description": "action:\"write\" — REQUIRED. Full file contents to write.",
      "type": "string"
    },
    "create_dirs": {
      "description": "action:\"write\" — create missing parent directories (default true).",
      "type": "boolean"
    },
    "patch": {
      "description": "action:\"patch\" — REQUIRED. A unified diff (---/+++ headers) or an apply-patch / simplified diff (`*** Begin Patch` / `*** Update File: path`). File headers are read to determine touched paths, which must resolve inside custom_nodes/ (e.g. 'a/MyPack/nodes.py' or 'MyPack/nodes.py').",
      "type": "string"
    },
    "query": {
      "description": "action:\"search\" — REQUIRED. Regular expression to search for.",
      "type": "string"
    },
    "glob": {
      "description": "action:\"list_files\" — optional glob to filter entries (supports *, **, ?), matched against pack-relative paths. action:\"search\" — optional glob to restrict which files are searched (e.g. '**/*.py').",
      "type": "string"
    },
    "max_entries": {
      "description": "action:\"list_files\" — maximum entries to return (default 500, max 2000 — a hard clamp). The walk STOPS at this many, so a capped result is not the pack's full file list.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "start_line": {
      "description": "action:\"read\" — 1-based line to start at (default 1).",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "line_count": {
      "description": "action:\"read\" — number of lines to return (default 240, max 800).",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "max_chars": {
      "description": "action:\"read\" — maximum characters to return (default 12000, min 500, max 24000 — hard clamps; values outside are silently pulled into range). action:\"git\" — maximum characters of git output to return (default 12000, min 500, max 24000 — hard clamps the runtime applies; values outside are silently pulled into range).",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "max_results": {
      "description": "action:\"search\" — maximum matches to return (default 50, max 100). The scan STOPS at this many, so a capped result is not a complete match set.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "case_sensitive": {
      "description": "action:\"search\" — match case-sensitively (default false).",
      "type": "boolean"
    },
    "git_action": {
      "description": "action:\"git\" — REQUIRED. Which git operation to run: status/diff/log are read-only; commit/push require COMFYUI_MCP_ALLOW_GIT_WRITES=1. Named `git_action` rather than `action` only because `action` is this tool's dispatch field; the git operation itself is unchanged.",
      "type": "string",
      "enum": [
        "status",
        "diff",
        "log",
        "commit",
        "push"
      ]
    },
    "message": {
      "description": "action:\"git\" — commit message (required for git_action 'commit').",
      "type": "string"
    },
    "paths": {
      "description": "action:\"git\" — pack-relative paths to stage/scope (jail-checked). Defaults to all pack changes.",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "list",
        "save",
        "restore"
      ],
      "description": "Which snapshot operation to perform. \"list\" takes no other parameters; \"save\" takes an optional `name`; \"restore\" requires `name`."
    },
    "name": {
      "description": "Snapshot name (no extension, no path separators). REQUIRED for action:\"restore\" (as shown by action:\"list\"). OPTIONAL for action:\"save\" — omit to let ComfyUI-Manager assign a timestamped name. Ignored by action:\"list\".",
      "type": "string"
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "list",
        "status",
        "get_workflow",
        "move",
        "edit",
        "cancel",
        "cancel_queued",
        "clear"
      ],
      "description": "Which queue operation to perform. \"list\" and \"clear\" take no other parameters; \"status\", \"get_workflow\" and \"cancel_queued\" require `prompt_id`; \"move\" requires `prompt_id` + `position`; \"edit\" requires `prompt_id` (optional `workflow`/`node_inputs`/`position`); \"cancel\" takes an optional `prompt_id` and `clear_pending`."
    },
    "prompt_id": {
      "description": "The prompt_id of a job (the id returned by enqueue_workflow). REQUIRED for actions \"status\", \"get_workflow\", \"move\", \"edit\" and \"cancel_queued\" (a PENDING queue item for all but \"status\"). OPTIONAL for action:\"cancel\" — if given, only interrupts the running job when its prompt_id matches; omit to interrupt whatever is currently running.",
      "type": "string"
    },
    "include_workflows": {
      "description": "action:\"list\" — include each running/pending job's workflow payload and extra_data. Can be large.",
      "type": "boolean"
    },
    "position": {
      "description": "Where to requeue the job. REQUIRED for action:\"move\". OPTIONAL for action:\"edit\" — defaults to back.",
      "type": "string",
      "enum": [
        "front",
        "back"
      ]
    },
    "workflow": {
      "description": "action:\"edit\" — optional complete replacement API-format workflow. If omitted, the existing queued workflow is patched with `node_inputs`.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "node_inputs": {
      "description": "action:\"edit\" — optional input patches keyed by node id, e.g. {\"3\":{\"steps\":30,\"cfg\":7}}.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "clear_pending": {
      "description": "action:\"cancel\" — also clear ALL pending jobs (recommended when resetting after a stuck/slow render, so a re-queue doesn't stack behind a backlog). Default false.",
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "description": "Short, specific issue title."
    },
    "body": {
      "type": "string",
      "minLength": 1,
      "description": "Issue body: what happened, steps to reproduce, the exact error text, and environment (GPU/VRAM, ComfyUI version, ComfyUI FRONTEND version, OS) if known. The FRONTEND version is a SEPARATE package from ComfyUI and they move independently — get_system_stats (action:\"health\") prints both, and for any panel/UI bug it is often the deciding variable. Scrub secrets first."
    },
    "repo": {
      "description": "owner/repo (default 'artokun/comfyui-mcp'; use 'artokun/comfyui-mcp-panel' for the sidebar panel).",
      "type": "string"
    },
    "labels": {
      "description": "Optional GitHub label names to prefill.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "mcp_version": {
      "description": "The running comfyui-mcp version (from the env line in your context). Auto-detected if omitted.",
      "type": "string"
    },
    "panel_version": {
      "description": "The running comfyui-mcp-panel (sidebar) version, from the env line in your context, if known.",
      "type": "string"
    },
    "no_file": {
      "description": "Force the prefilled-URL path even for our repos (skip the Worker). Rarely needed.",
      "type": "boolean"
    }
  },
  "required": [
    "title",
    "body"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "restart",
        "start",
        "stop"
      ],
      "description": "Which process operation to perform. None of them takes any other parameter. \"restart\" stops and relaunches in one call (and is the only action that also works against a remote/tunnelled ComfyUI); \"start\" relaunches from the info a previous \"stop\" saved; \"stop\" kills the running process tree."
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "create",
        "start",
        "stop",
        "status",
        "list",
        "connect",
        "use_local",
        "deploy_link"
      ],
      "description": "Which RunPod operation to perform. \"start\", \"stop\", \"status\" and \"connect\" require `pod_id`; \"create\" takes the optional deploy parameters (name/gpu_type/cloud_type/connect/deadman); \"list\", \"use_local\" and \"deploy_link\" take no other parameters. \"create\" and \"start\" BILL; \"stop\" ends billing."
    },
    "pod_id": {
      "description": "The RunPod pod ID (from console.runpod.io, or action:\"list\"). REQUIRED for actions \"start\", \"stop\", \"status\" and \"connect\". Ignored by \"create\", \"list\", \"use_local\" and \"deploy_link\".",
      "type": "string"
    },
    "gpu_count": {
      "description": "action:\"start\" — GPUs to attach on resume (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 8
    },
    "name": {
      "description": "action:\"create\" — pod name (default 'comfyui-mcp').",
      "type": "string"
    },
    "gpu_type": {
      "description": "action:\"create\" — GPU type to prefer, e.g. \"NVIDIA GeForce RTX 4090\". Default tries: NVIDIA GeForce RTX 4090, NVIDIA RTX A6000, NVIDIA RTX PRO 4500 Blackwell, NVIDIA A40, NVIDIA RTX A5000.",
      "type": "string"
    },
    "cloud_type": {
      "description": "action:\"create\" — COMMUNITY (cheaper, default) or SECURE.",
      "type": "string",
      "enum": [
        "COMMUNITY",
        "SECURE"
      ]
    },
    "connect": {
      "description": "action:\"create\" — auto-connect when booted: the ORCHESTRATOR waits for ComfyUI to answer (1-3min), then retargets + watches — this call returns immediately (default false: deploy only; connect later with action:\"connect\"). This is the create-time flag, NOT the action of the same name.",
      "type": "boolean"
    },
    "deadman": {
      "description": "action:\"create\" — arm the pod-side dead-man watchdog (default true for OUR stock template): the pod STOPS ITSELF if comfyui-mcp's heartbeats stop (process crash/offline — boot grace ~45min, then ~20min without beats). Uses the pod-scoped API key RunPod auto-injects into every pod — your account key never leaves this machine. false deploys without the watchdog. With a custom template (RUNPOD_TEMPLATE_ID) the default is OFF — pass true only if that image ships our watchdog.",
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ]
}

{
  "destructiveHint": true,
  "openWorldHint": true,
  "idempotentHint": false
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "watch",
        "unwatch",
        "troubleshoot"
      ],
      "description": "Which watch operation to perform. \"watch\" and \"troubleshoot\" require `pod_id`; \"unwatch\" takes no other parameters (it clears whichever pod is currently watched)."
    },
    "pod_id": {
      "description": "The RunPod pod ID. REQUIRED for actions \"watch\" and \"troubleshoot\". Ignored by \"unwatch\", which clears the single currently watched pod.",
      "type": "string"
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "save",
        "lock",
        "verify_lock"
      ],
      "description": "Which write/provenance operation to perform. All three require `filename`; \"save\" also requires `workflow`."
    },
    "filename": {
      "description": "Workflow filename in the ComfyUI user library (e.g. 'my_workflow.json'). REQUIRED for every action. A missing `.json` suffix is appended before use; extension case and forward-slash subfolders are preserved. The name must be a safe relative path. For action:\"save\" this OVERWRITES an existing file of the same canonical name; for \"lock\"/\"verify_lock\" the lock is read/written as '<filename>.lock.json' alongside it.",
      "type": "string"
    },
    "workflow": {
      "description": "action:\"save\" (REQUIRED) — Workflow JSON to save. Web UI format ({ nodes: [], links: [] }) is stored verbatim; API format ({ '1': { class_type, inputs } }) is auto-converted to Web UI format (generated layout) so it stays openable in ComfyUI's canvas. Not validated against the server before saving.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "search",
        "details"
      ],
      "description": "Which registry lookup to perform. \"search\" requires `query` (and takes optional `limit`/`page`); \"details\" requires `id`."
    },
    "query": {
      "description": "action:\"search\" — REQUIRED. Keyword(s) to match against pack name/description, e.g. 'impact', 'controlnet aux'.",
      "type": "string"
    },
    "limit": {
      "description": "action:\"search\" — max results to return (default 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "page": {
      "description": "action:\"search\" — page number for pagination (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "id": {
      "description": "action:\"details\" — REQUIRED. Exact registry pack id (the 'id' field from action:\"search\"), e.g. 'comfyui-impact-pack'.",
      "type": "string"
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "doctor",
        "bootstrap",
        "build_image"
      ],
      "description": "Which trainer-setup operation to perform. \"doctor\" is read-only and takes no other parameters; \"bootstrap\" takes `target` (+ `pod_id` for target 'pod'); \"build_image\" takes an optional `aiToolkitRef`. None of them touches a dataset or a job."
    },
    "target": {
      "default": "local",
      "description": "action:\"bootstrap\" — where to install the native trainer. Default local.",
      "type": "string",
      "enum": [
        "local",
        "pod"
      ]
    },
    "pod_id": {
      "description": "action:\"bootstrap\" — pod to bootstrap (target 'pod'). Default: the connected pod.",
      "type": "string"
    },
    "aiToolkitRef": {
      "description": "action:\"build_image\" — ai-toolkit git ref (commit/tag) to build against. Default: the Dockerfile's pinned ref.",
      "type": "string"
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "prepare",
        "list",
        "detail",
        "update",
        "delete",
        "file",
        "caption_image",
        "caption_dataset"
      ],
      "description": "Which dataset operation to perform. \"list\" takes no other parameters; \"prepare\" requires `name` + `items`; \"detail\", \"update\", \"delete\" and \"caption_dataset\" require `name`; \"file\" and \"caption_image\" require `path`. NOTE \"delete\" here destroys a DATASET (images + captions) — deleting a training JOB is train_start action:\"delete\"."
    },
    "name": {
      "description": "Dataset name — the staging dir name. REQUIRED for actions \"prepare\" (it is created), \"detail\", \"update\", \"delete\" and \"caption_dataset\" (from action:\"list\"). This is a DATASET name, never a training job id.",
      "type": "string",
      "minLength": 1
    },
    "items": {
      "description": "action:\"prepare\" — the images to stage. REQUIRED for that action.",
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "path": {
            "description": "Absolute path to a source image (png/jpg/jpeg/webp).",
            "type": "string",
            "minLength": 1
          },
          "ref": {
            "description": "ComfyUI file ref (e.g. from get_image (action:\"list_outputs\") format:json) — resolved server-side with containment checks. Give path OR ref.",
            "type": "object",
            "properties": {
              "filename": {
                "type": "string",
                "minLength": 1,
                "description": "Basename only — no path separators."
              },
              "subfolder": {
                "description": "Subfolder under the root (default top level).",
                "type": "string"
              },
              "type": {
                "default": "output",
                "description": "Which ComfyUI dir to resolve against (default output).",
                "type": "string",
                "enum": [
                  "output",
                  "input"
                ]
              }
            },
            "required": [
              "filename"
            ]
          },
          "caption": {
            "description": "Caption for this image.",
            "type": "string"
          }
        }
      }
    },
    "defaultCaption": {
      "description": "action:\"prepare\" — fallback caption for items without one; usually the trigger word.",
      "type": "string"
    },
    "setCaptions": {
      "description": "action:\"update\" — {filename: caption} pairs to write (replaces existing captions).",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "deleteImages": {
      "description": "action:\"update\" — image filenames to delete from the dataset (caption files go too). Removes only these files; action:\"delete\" removes the whole dataset.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "path": {
      "description": "Absolute path of a file under the training root. REQUIRED for action:\"file\" (a dataset image or job sample, from action:\"detail\"'s datasetPath or train_start action:\"status\"'s samples) and for action:\"caption_image\" (the image to caption).",
      "type": "string",
      "minLength": 1
    },
    "guide": {
      "description": "actions \"caption_image\"/\"caption_dataset\" — extra style guidance for the captioner (e.g. 'focus on outfits and backgrounds').",
      "type": "string"
    },
    "trigger": {
      "description": "actions \"caption_image\"/\"caption_dataset\" — trigger word to prepend to the caption(s).",
      "type": "string"
    },
    "only": {
      "description": "action:\"caption_dataset\" — subset of filenames to caption (default: all images).",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "start",
        "status",
        "cancel",
        "delete",
        "list_flows",
        "job_config",
        "preview_config"
      ],
      "description": "Which training-job operation to perform. \"list_flows\" takes no other parameters; \"status\" takes an OPTIONAL `id` (omit for all jobs); \"cancel\", \"delete\" and \"job_config\" require `id`; \"start\" and \"preview_config\" require `name` + `datasetPath`. NOTE \"delete\" here destroys a training JOB — deleting a staged DATASET is train_prepare_dataset action:\"delete\"."
    },
    "id": {
      "description": "Training job id, as returned by action:\"start\" (e.g. \"t8f3k2ab\") — NEVER a dataset name. REQUIRED and must be non-empty for actions \"cancel\", \"delete\" and \"job_config\". OPTIONAL for action:\"status\": omit it (or pass an empty string) to list every job newest-first. Unused by \"start\", \"list_flows\" and \"preview_config\".",
      "type": "string"
    },
    "name": {
      "description": "Job name — becomes the output .safetensors basename (e.g. 'aria_character'). REQUIRED for actions \"start\" and \"preview_config\". This names the RUN, not the dataset it reads.",
      "type": "string",
      "minLength": 1
    },
    "flow": {
      "default": "character",
      "description": "action:\"start\" — training flow (see action:\"list_flows\").",
      "type": "string",
      "enum": [
        "character"
      ]
    },
    "model": {
      "default": "flux1-dev",
      "description": "action:\"start\" — base model (see action:\"list_flows\").",
      "type": "string",
      "enum": [
        "flux1-dev"
      ]
    },
    "datasetPath": {
      "description": "Dataset dir from train_prepare_dataset (images + same-basename .txt captions). REQUIRED for actions \"start\" and \"preview_config\".",
      "type": "string",
      "minLength": 1
    },
    "trigger": {
      "description": "Unique trigger word (e.g. 'ohwx person') — injected as trigger_word and usable in prompts.",
      "type": "string"
    },
    "params": {
      "description": "Training param overrides for actions \"start\" and \"preview_config\" (steps/lr/rank/resolution/batchSize/saveEvery/sampleEvery/quantize). Omitted keys fall back to the defaults from action:\"list_flows\". action:\"preview_config\" enforces the SAME bounds action:\"start\" does, so a preview always reflects a run that could actually launch.",
      "type": "object",
      "properties": {
        "steps": {
          "description": "Total training steps (200 = smoke test, 1500-3000 real; max 100000).",
          "type": "integer",
          "minimum": 1,
          "maximum": 100000
        },
        "lr": {
          "description": "Learning rate (max 1).",
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 1
        },
        "rank": {
          "description": "LoRA rank (16 simple, 16-32 detailed; max 1024).",
          "type": "integer",
          "minimum": 1,
          "maximum": 1024
        },
        "resolution": {
          "description": "Resolution buckets, e.g. [512,768,1024] (each 64-4096).",
          "minItems": 1,
          "type": "array",
          "items": {
            "type": "integer",
            "minimum": 64,
            "maximum": 4096
          }
        },
        "batchSize": {
          "type": "integer",
          "minimum": 1,
          "maximum": 9007199254740991
        },
        "saveEvery": {
          "description": "Checkpoint cadence (steps).",
          "type": "integer",
          "minimum": 1,
          "maximum": 9007199254740991
        },
        "sampleEvery": {
          "description": "Sample-image cadence (steps).",
          "type": "integer",
          "minimum": 1,
          "maximum": 9007199254740991
        },
        "quantize": {
          "description": "8-bit mixed precision — needed to fit Flux on 24GB.",
          "type": "boolean"
        }
      }
    },
    "device": {
      "description": "action:\"start\" — GPU selector, default cuda:0.",
      "type": "string"
    },
    "target": {
      "default": "local",
      "description": "action:\"start\" — 'local' = docker on this rig; 'pod' = pod-native over ssh on a RunPod pod.",
      "type": "string",
      "enum": [
        "local",
        "pod"
      ]
    },
    "pod_id": {
      "description": "action:\"start\" — RunPod pod to train on (target 'pod'). Default: the connector's currently connected/watched pod.",
      "type": "string"
    },
    "deliverTo": {
      "default": "both",
      "description": "action:\"start\", pod jobs only: where the finished LoRA lands.",
      "type": "string",
      "enum": [
        "pod",
        "local",
        "both"
      ]
    },
    "model_path": {
      "description": "action:\"start\" — override the base model path AS THE TRAINER SEES IT (pod path for target 'pod', container path for 'local') — e.g. a pre-uploaded local HF snapshot dir when the default HF repo id is gated/unreachable.",
      "type": "string"
    },
    "keep_outputs": {
      "description": "action:\"delete\" — keep the job's output dir (checkpoints/samples) and delete only the record.",
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "image",
        "video",
        "audio",
        "output",
        "stage"
      ],
      "description": "What to upload and where. \"image\"/\"video\"/\"audio\" send a LOCAL file (`source_path`) to ComfyUI's input/ directory; \"stage\" re-registers an EXISTING server-side output (`filename`) as an input; \"output\" ships a generated output to cloud storage (`destination`)."
    },
    "source_path": {
      "description": "Absolute path to the local file to upload. REQUIRED for actions \"image\", \"video\" and \"audio\".",
      "type": "string"
    },
    "filename": {
      "description": "Two meanings, one per action. actions \"image\"/\"video\"/\"audio\" — OPTIONAL override for the filename in ComfyUI's input/ directory (auto-detected from source_path if omitted). A path prefix (e.g. assets/clip.mp4) places the upload in that SUBFOLDER of input/ — \"..\" is refused — and the returned filename reference includes the subfolder when the loader enumerates it. action:\"image\" verifies the name against LoadImage /object_info and, if a nested path is stored but not listed, returns a verified root filename instead. action:\"stage\" — REQUIRED filename of the EXISTING output/temp asset to re-register (from get_history or get_image action:\"list_outputs\"), e.g. LTX_video_00001.mp4; its destination name override is `as_filename`, not this field.",
      "type": "string"
    },
    "subfolder": {
      "description": "action:\"stage\" — subfolder the source asset currently lives in, if any.",
      "type": "string"
    },
    "type": {
      "description": "action:\"stage\" — source directory the asset lives in: output (default) or temp (previews).",
      "type": "string",
      "enum": [
        "output",
        "temp"
      ]
    },
    "kind": {
      "description": "action:\"stage\" — force the media kind instead of inferring it from the file extension.",
      "type": "string",
      "enum": [
        "image",
        "video",
        "audio"
      ]
    },
    "as_filename": {
      "description": "action:\"stage\" — override the filename it is registered under in the input/ directory (defaults to the source filename).",
      "type": "string"
    },
    "asset_id": {
      "description": "action:\"output\" — registered asset id from a completed job. Provide exactly one of asset_id or path.",
      "type": "string"
    },
    "path": {
      "description": "action:\"output\" — path to a generated output under COMFYUI_PATH/output. Provide exactly one of asset_id or path.",
      "type": "string"
    },
    "destination": {
      "description": "action:\"output\" — REQUIRED. Exactly one upload destination.",
      "type": "object",
      "properties": {
        "s3": {
          "type": "object",
          "properties": {
            "bucket": {
              "type": "string",
              "minLength": 1,
              "description": "Destination S3 bucket"
            },
            "prefix": {
              "description": "Optional object key prefix",
              "type": "string"
            },
            "async": {
              "description": "Accepted for API compatibility; uploads complete before the tool returns.",
              "type": "boolean"
            }
          },
          "required": [
            "bucket"
          ]
        },
        "azure": {
          "type": "object",
          "properties": {
            "container": {
              "type": "string",
              "minLength": 1,
              "description": "Destination Azure Blob container"
            },
            "blob_prefix": {
              "description": "Optional blob name prefix",
              "type": "string"
            }
          },
          "required": [
            "container"
          ]
        },
        "http": {
          "type": "object",
          "properties": {
            "url": {
              "type": "string",
              "format": "uri",
              "description": "HTTP(S) URL to PUT the output file to"
            }
          },
          "required": [
            "url"
          ]
        },
        "hf": {
          "type": "object",
          "properties": {
            "repo": {
              "type": "string",
              "minLength": 1,
              "description": "HuggingFace repo in owner/name format"
            },
            "repo_type": {
              "description": "Repo type; defaults to model",
              "type": "string",
              "enum": [
                "model",
                "dataset",
                "space"
              ]
            },
            "path": {
              "description": "Optional path prefix inside the repo",
              "type": "string"
            }
          },
          "required": [
            "repo"
          ]
        }
      }
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "render",
        "render_hierarchical",
        "mermaid",
        "to_dsl",
        "from_dsl"
      ],
      "description": "Which rendering/conversion to perform. \"render\", \"render_hierarchical\" and \"to_dsl\" require `workflow`; \"mermaid\" requires `mermaid`; \"from_dsl\" requires `dsl`."
    },
    "workflow": {
      "description": "ComfyUI workflow JSON (as a JSON string or object; API or UI format is auto-detected). REQUIRED for action:\"render\", action:\"render_hierarchical\" and action:\"to_dsl\" — \"to_dsl\" expects API format (node ID -> {class_type, inputs}).",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "show_values": {
      "default": true,
      "description": "action:\"render\" / action:\"render_hierarchical\" — Include widget values (seed, steps, cfg, etc.) in node labels (detail view only, for the hierarchical action).",
      "type": "boolean"
    },
    "direction": {
      "description": "action:\"render\" / action:\"render_hierarchical\" — Flowchart direction: LR (left-to-right) or TB (top-to-bottom). Default LR for \"render\" and for the hierarchical detail view, TB for the hierarchical overview.",
      "type": "string",
      "enum": [
        "LR",
        "TB"
      ]
    },
    "view": {
      "default": "overview",
      "description": "action:\"render_hierarchical\" — overview: compact diagram with sections as summary nodes; detail: full diagram for one section; list: text summary of all sections; summary: structured text optimized for AI ingestion with node IDs, key settings, virtual wires, and full connection graph",
      "type": "string",
      "enum": [
        "overview",
        "detail",
        "list",
        "summary"
      ]
    },
    "section": {
      "description": "action:\"render_hierarchical\" — Section name to show in detail view (required when view=detail). Use view=list to see available section names.",
      "type": "string"
    },
    "mermaid": {
      "description": "action:\"mermaid\" (REQUIRED) — Mermaid flowchart text (with or without ```mermaid code fence). Nodes should use ComfyUI class_type names as labels. Connections should be labeled with data types (e.g., -->|MODEL|).",
      "type": "string"
    },
    "dsl": {
      "description": "action:\"from_dsl\" (REQUIRED) — Workflow DSL text",
      "type": "string"
    }
  },
  "required": [
    "action"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "get",
        "set_default",
        "list"
      ],
      "description": "Which workspace operation to perform. \"get\" and \"list\" take no other parameters; \"set_default\" requires `path`."
    },
    "path": {
      "description": "action:\"set_default\" — REQUIRED absolute path to a ComfyUI installation directory to remember as the default workspace.",
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "action"
  ]
}