Comfy Agent Skill by Comfy-Org

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, …): 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