| name | comfy |
| description | Generate images, video, audio, and 3D with Comfy Cloud — search hundreds of models and workflow templates, run custom ComfyUI workflows, and manage generation jobs through the hosted Comfy Cloud MCP server. Cloud-only — connects to the hosted service, not a local ComfyUI install. Use for any "generate/edit an image", "make a video", "text to 3D", or ComfyUI workflow task. |
Comfy Cloud
Comfy Cloud runs ComfyUI in the cloud and exposes it to
agents as an MCP server: image/video/audio/3D generation via partner models
(Ideogram, Flux, Kling, Veo, Seedance, and more) and open-source pipelines,
plus full ComfyUI workflow authoring — search templates, override inputs,
submit custom graphs, and fetch outputs as signed URLs.
Scope: this skill connects to the hosted Comfy Cloud MCP server and
requires a Comfy account — it does not drive a local ComfyUI install. A
local-ComfyUI MCP is on the roadmap and will ship as a separate skill; until
then, for local instances see
comfy-cli.
Connect
The server supports two auth methods: OAuth (browser sign-in, nothing to
manage — recommended) and API keys (for headless or CI setups).
Option A — OAuth (recommended)
openclaw mcp set comfy '{"url":"https://cloud.comfy.org/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login comfy
openclaw gateway restart
openclaw mcp login prints an authorization URL — open it, sign in to your
Comfy account, and finish the flow as the CLI directs (it may ask you to rerun
with --code <code>). Verify with openclaw mcp status --verbose. Note that
OpenClaw ignores static headers on a server entry once auth: "oauth" is
set, so don't combine the two.
Option B — API key (headless / CI)
-
Get an API key — sign in at cloud.comfy.org,
then create a key under Settings → API Keys. Keys start with comfyui-.
-
Export it (put this in your shell profile or OpenClaw's env):
export COMFY_API_KEY="comfyui-..."
-
Register the MCP server with OpenClaw:
openclaw mcp set comfy '{"url":"https://cloud.comfy.org/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer ${COMFY_API_KEY}"}}'
openclaw gateway restart
The server also accepts the key as an X-API-Key: ${COMFY_API_KEY} header,
but prefer the Authorization: Bearer form above — standard headers survive
every client's proxy layer, and some OpenClaw builds have dropped custom
headers on streamable-http transports (see openclaw#65590). If you get a
401 with a key you know is valid, you are probably hitting that: switch to
the Bearer form, route through mcporter, or just use OAuth (Option A).
Either way: browsing/search tools work with any account; generation consumes
Comfy Cloud credits and needs a subscription or credit balance.
Which tools to use
Images and video from a named model (Ideogram, Flux, Gemini, Kling, Veo,
Seedance, …): before calling partner_generate, check whether the named
family also has an OSS route — some families (MiniMax H3 is a current
example, as of 2026-08) ship BOTH a paid partner node and open-source weights
under the identical display title. Run search_templates for the family name
alongside search_nodes; if both exist, tell the user the OSS option exists
(it has no partner/API fee, but running it still spends ordinary Comfy Cloud
compute credits — it isn't free on Comfy Cloud, only free of the partner
surcharge) and ask which they want. If only the partner route exists, or the
user picks paid, call partner_generate — it runs the provider through Comfy
Cloud and saves the result to your asset library. Do not hand-build a workflow
for plain text-to-image/video when a partner model is named.
Anything workflow-shaped (open-source models, LoRA/ControlNet, multi-step
pipelines): start from a template — search_templates → get_template_schema
→ run_template with input_overrides. For fully custom graphs use
submit_workflow (the graph must end in an output node like SaveImage, or
validation rejects it). Save and reuse with save_workflow /
run_saved_workflow.
Editing an existing image: upload_file first, then reference the
uploaded file from a LoadImage node (or pass it to partner_generate for
image-to-image partners). Never inline base64 image data into a workflow.
Getting results: wait_for_job → get_output. Outputs come back as
time-limited signed URLs — download them exactly as returned (don't edit query
params, they're part of the signature). get_queue and cancel_job manage
in-flight jobs; submit_batch / wait_for_batch fan out variations.
Discovery: search_models (checkpoints/LoRAs on the platform),
search_nodes (available ComfyUI nodes with wiring hints),
get_prompting_guide (model-specific prompting advice).
Example prompts
- "Generate an image of a cozy bookstore café on a rainy afternoon with
Ideogram and download it to ./bookstore.png"
- "Take ./product.jpg, remove the background, and upscale the result 2×"
- "Find a text-to-video template for Kling, run it with the prompt 'a paper
boat drifting down a rain gutter, cinematic', and give me the output URL"
Notes
- Generation spends Comfy Cloud credits; search/discovery tools are free.
- Full MCP docs and per-client setup: docs.comfy.org/cloud/mcp
