comfy-h3-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| COMFYUI_URL | No | The URL of the ComfyUI server. Defaults to http://127.0.0.1:8188 | http://127.0.0.1:8188 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| h3_image_to_videoA | Generate video with synchronized audio from a text prompt, optionally anchored by a first and/or last keyframe (MiniMax-H3 fl2va model). With no keyframes this is pure text-to-video. Images may be a local file path (uploaded automatically) or a name already in ComfyUI's input folder. length is a frame count at 24 fps and snaps up to the model's 17k+5 grid; 124 frames is about 5 seconds, and the trained range is roughly 124-362. Leave width/height unset: they default to 864x480, which is both faster and closer to the prompt than larger canvases. Only raise it if the user asks. This produces ONE continuous shot - it cannot contain cuts, so for a multi-shot sequence call this once per shot and edit the clips together rather than describing several shots in one prompt. Takes MINUTES: ~3-4 min at the defaults on an RTX 4090, longer at higher resolution or step count. The response carries estimated_seconds; poll job_status at that cadence instead of assuming a long run has hung. Do NOT set sage_attention without first checking list_assets - if ComfyUI runs with --use-sage-attention, sage is already on and this is redundant. Returns immediately with a prompt_id - poll job_status to get the output. |
| h3_reference_to_videoA | Generate video with synchronized audio from a prompt plus reference images, videos, and/or audio (MiniMax-H3 ref2va model). References are addressed positionally in the prompt as , and , all 1-based per type - e.g. "<Picture 1> walks through the door speaking in the voice of <Audio 1>". Max 9 images, 3 videos, 3 audio. A reference video's own soundtrack is passed through automatically. ref_image_size "match" scales references to the output's pixel area; "max" uses a 2048px short edge for better identity fidelity but is several times slower, since reference tokens ride through every step. This is the tool for CONSISTENCY ACROSS SHOTS: generate shot 1, pull a frame of the character or location from it, and pass it here as a reference for shots 2..n so they match. Leave width/height unset (864x480 default). Takes MINUTES; see estimated_seconds in the response and poll at that cadence. Check list_assets before setting sage_attention - it is redundant when ComfyUI already runs with --use-sage-attention. Returns immediately with a prompt_id - poll job_status to get the output. |
| job_statusA | Check a submitted H3 job. Returns queued / running / completed / failed, plus the output file paths once it has finished. |
| job_cancelA | Cancel an H3 job: removes it if still queued, interrupts it if running. |
| job_previewA | Look at and listen to a finished H3 job. MCP has no video content type, so this returns a contact sheet of frames sampled evenly across the clip (viewable as an image) plus the soundtrack as audio. Use it to actually judge a result before iterating on the prompt. |
| list_assetsA | List what this ComfyUI can actually load: H3 models, and the images, videos and audio already sitting in the input folder (usable by name). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool has a clearly distinct role: job management (status, cancel, preview), asset discovery, and two generation tools with different use cases (keyframes vs. reference-based consistency). The generation tools are well-separated by their descriptions, leaving no ambiguity.
Names follow a predictable pattern within categories: job_* for job operations, h3_* for generation, and list_assets for assets. However, there is no single uniform verb_noun convention across all tools (e.g., job_cancel vs. list_assets), which is a minor deviation.
Six tools is well-scoped for this focused video-generation server. Each tool fills a necessary part of the workflow—submitting generation jobs, managing jobs, inspecting results, and listing available assets—with no redundant tools.
The tool set covers the full generation lifecycle: submit (two variants), poll status, cancel, preview, and list assets. A minor gap is the lack of a listing mechanism for all submitted jobs, which could be a workaround but is not critical.