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.

​
list_api_nodes

Discover and run hosted partner/API nodes on the connected ComfyUI (e.g. Flux/BFL, Ideogram, Kling, Stability). These call external image/video providers and run server-side, requiring a Comfy account/API key configured on the ComfyUI server — they spend PAID api credits, unlike a local-GPU render. Driven by the action parameter:
  • action:“list” — List the API/partner nodes available on the connected ComfyUI, optionally narrowed by filter. Returns an empty list if the server has no API nodes (or they are disabled). Start here to find a class_type.
  • action:“schema” — Return the input schema for one API/partner node (class_type) from the connected ComfyUI’s /object_info. Lists visible inputs (with types/defaults/options), hidden inputs (server-filled auth), and outputs. Use action:“list” first to find a class_type.
  • action:“generate” — Build a minimal single-node workflow that runs a chosen API/partner node (class_type) with the provided inputs and enqueue it. Returns immediately with the prompt_id (use queue (action:“status”) / get_history for results). Do NOT pass auth credentials in inputs — the ComfyUI server injects those from its logged-in session. Use action:“schema” to discover valid inputs.

​
Parameters

​
enum
required
Which API-node operation to perform. “list” takes an optional filter; “schema” requires class_type; “generate” requires class_type + inputs (optional disable_random_seed). Options: action:"list", action:"schema", action:"generate".
​
string
action:“list” — case-insensitive substring to narrow results, matched against class_type, display name, or category (e.g. “image”, “video”, “kling”).
​
string
The node class_type, e.g. “FluxProImageNode”. REQUIRED for action:“schema” and action:“generate”; find one with action:“list”.
​
object
action:“generate” — REQUIRED. Input values keyed by input name, per the node’s schema (action:“schema”).
​
boolean
action:“generate” — if true, do not randomize seed/noise_seed inputs.

​
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.