Skip to main content
1 tool. Generated from the live MCP tool schemas — do not edit by hand; run npm run docs:gen.
You don’t type these calls. Ask your agent for what you want in ordinary English — it chooses the tool and fills in the arguments. The JSON on this page is what it sends. New here? Start with Using the tools.

​
comfy_cli

Drive the official comfy-cli (envelope/1 JSON contract) for the selected ComfyUI environment. The MCP resolves comfy from COMFY_CLI_PATH, PATH, or the selected workspace’s .venv/venv. Driven by the action parameter:
  • action:“status” — Inspect the comfy-cli integration and selected environment (comfy which / comfy env); detail selects version/which/env/discover (default env). Call this before local CLI operations when workspace or server routing is uncertain.
  • action:“server_start” / “server_stop” / “server_restart” — Manage a local ComfyUI through comfy-cli background process management. Restart performs comfy stop followed by comfy launch --background; extra launch arguments go in launchArgs.
  • action:“jobs_list” — List local or Comfy Cloud jobs (limit optional). Local jobs include CLI-tracked async submissions plus the ComfyUI queue/history.
  • action:“jobs_status” / “jobs_watch” / “jobs_cancel” — Inspect, watch, or cancel one job; promptId required.
  • action:“jobs_wait” — Wait for jobs: one of promptId, promptIds, or all=true is required; timeoutSeconds optional.
  • action:“search_nodes” — Fuzzy-search actual ComfyUI node classes by name, display name, or description using comfy nodes search; query required. Complements search_custom_nodes, which searches installable node packs. Works locally, in Comfy Cloud, or offline with objectInfoPath. When comfy-cli is not installed/on PATH and the target is the connected (local) server, falls back to fuzzy-searching that server’s live /object_info — so installed-node discovery works without the CLI.
  • action:“workflow_validate” — Validate an API/UI workflow file (class types, inputs, enums, edge wiring) without submission; workflowPath required.
  • action:“workflow_run” — Submit an API/UI workflow file (workflowPath required). Asynchronous by default; set wait=true to await outputs (timeoutSeconds).
  • action:“transfer_upload” — Upload input files (files required) for local ComfyUI or Comfy Cloud; overwrite=false passes —no-overwrite.
  • action:“transfer_download” — Download completed outputs for promptId (required); outDir and urlOnly optional.
  • action:“models_list_folders” / “models_list_folder” / “models_search” / “models_show” — Discover model folders/files locally or in Comfy Cloud (folder required for list_folder, name for show). When comfy-cli is not installed/on PATH and the target is the connected (local) server, these read-only listings fall back to that server’s own local models (via /models) — so model discovery works without the CLI.
  • action:“models_download” — Download a model url (required) into the workspace (relativePath, default models/checkpoints). A download can run for many minutes and is gated on an idle-liveness timeout, so a progressing download is never killed.
  • action:“models_remove” — Remove workspace model files (modelNames required; relativePath optional).
  • action:“skills_list” / “skills_show” / “skills_validate” / “skills_install” / “skills_status” / “skills_uninstall” — Manage the official comfy-cli bundled agent skills (comfy, fragments, debug, relay, director). validate requires path; install/uninstall default to dry-run unless apply=true; scope=“project” requires projectDir.

​
Parameters

​
enum
required
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). Options: action:"status", action:"server_start", action:"server_stop", action:"server_restart", action:"jobs_list", action:"jobs_status", action:"jobs_wait", action:"jobs_watch", action:"jobs_cancel", action:"search_nodes", action:"workflow_validate", action:"workflow_run", action:"transfer_upload", action:"transfer_download", action:"models_list_folders", action:"models_list_folder", action:"models_search", action:"models_show", action:"models_download", action:"models_remove", action:"skills_list", action:"skills_show", action:"skills_validate", action:"skills_install", action:"skills_status", action:"skills_uninstall".
​
enum
default:"env"
action:“status” — which inspection to run. Options: version, which, env, discover.
​
string
Optional ComfyUI workspace override. Otherwise COMFYUI_PATH/auto-detection is used.
​
string[]
actions “server_start”/“server_restart” — extra ComfyUI launch arguments, e.g. [‘—listen’,‘0.0.0.0’,‘—port’,‘8188’].
​
string
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).
​
string[]
action:“jobs_wait” — prompt ids to wait on. Use this or promptId or all=true.
​
boolean
action:“jobs_wait” — wait on every known job.
​
integer
Result cap for “jobs_list”, “search_nodes” and the “models_*” listing/search actions.
​
integer
actions “jobs_wait”/“jobs_watch”/“workflow_run” — max seconds to wait.
​
enum
Target for the jobs/search_nodes/workflow/transfer/models actions: “local” (default) or “cloud” (Comfy Cloud). Options: local, cloud.
​
string
action:“search_nodes” — fuzzy search text. REQUIRED.
​
string
action:“search_nodes” — offline object_info JSON file to search instead of a live target.
​
string
actions “workflow_validate”/“workflow_run” — path to an API/UI workflow JSON file. REQUIRED.
​
boolean
action:“workflow_run” — await outputs instead of returning after submission.
​
string[]
action:“transfer_upload” — input files to upload. REQUIRED.
​
string
action:“transfer_download” — output directory.
​
boolean
action:“transfer_upload” — set false to pass —no-overwrite.
​
boolean
action:“transfer_download” — print URLs instead of downloading files.
​
string
action:“models_list_folder” — the model folder to list. REQUIRED.
​
string
action:“models_search” — search text.
​
string
action:“models_search” — model type filter (checkpoint, lora, vae, …).
​
string
actions “models_show”/“skills_show” — the model or skill name.
​
string
action:“models_download” — model URL to download. REQUIRED.
​
string
actions “models_download”/“models_remove” — workspace-relative model directory (default models/checkpoints).
​
string[]
action:“models_remove” — model filenames to remove. REQUIRED.
​
string
action:“skills_validate” — path to the skill to validate. REQUIRED.
​
enum
actions “skills_install”/“skills_uninstall”/“skills_status” — install scope. Options: user, project.
​
string
Working directory for project-scoped skill operations. Required when scope=‘project’.
​
string[]
actions “skills_install”/“skills_uninstall” — agent targets.
​
string[]
actions “skills_install”/“skills_uninstall” — skill names.
​
boolean
default:"false"
actions “skills_install”/“skills_uninstall” — actually mutate; default false = dry-run.

​
Example

No worked example yet — the call below is a skeleton generated from the required parameters. Real examples live in scripts/tool-doc-examples.ts; contributions welcome.