Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
COMFYUI_URLNoURL of your ComfyUI server. Can also be set in the config file under comfyui_url.http://127.0.0.1:8188
COMFY_MCP_CONFIGNoPath to the TOML configuration file. Overrides the default ~/.config/comfy-mcp/config.toml. Can also be set with --config PATH.~/.config/comfy-mcp/config.toml
COMFY_MCP_HTTP_TOKENNoBearer token for Streamable HTTP mode. Required when running with --http; must be at least 16 characters.
COMFY_MCP_OUTPUT_DIRNoDirectory where generated images are saved. Can also be set in the config file under output_dir.~/Pictures/ComfyUI

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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
generate_imageA

Generate new image(s) from a text prompt.

    model: which image model to use; omit for the configured default. Currently available: "qwen21"
    (Qwen Image 2.1). list_models shows what is installed and ready.
    Canvas: give width and height (multiples of 32, default 1024×1024) or an aspect preset:
    square, landscape (1344×768), portrait (768×1344), wide (1536×640), tall (640×1536).
    seed: omit for random; the seed used is always returned so a result can be reproduced.
    steps default 25, cfg default 1.0 (Qwen 2.1 works best at cfg 1.0; a negative prompt only
    matters when cfg > 1). count 1-4 images in one run.
    save=true writes full-size PNGs to the configured output folder and returns their paths plus
    a small preview of each; save=false returns base64 PNG in the text instead of writing files.
    Blocks until done (typically 20-60 s). If it returns JSON with a job_id, the server was busy:
    use wait_for_job(job_id).
    
edit_imageA

Edit one image, or compose a new image from 2-4 reference images.

    model: which image model to use; omit for the configured default. Currently available: "qwen21".
    images: 1-4 local file paths (or data:/base64 strings). ORDER MATTERS: the first image is
    the base/subject and sets the output canvas (unless width/height are given); it is fitted and
    padded, never stretched. Later images are supporting references at ~1 MP.
    instruction: start with the operation ("Replace the background with…", "Put the person from
    <image1> into the scene from <image2>…"). Say what comes from each reference, what must stay
    recognizable and what must change. For placing a subject into a scene: subject FIRST, scene
    SECOND, with explicit <image1>/<image2> roles.
    Other parameters and the return value match generate_image.
    
server_statusA

Check the ComfyUI server: reachability, version, GPU memory, queue length and whether someone else's job is running (this MCP always queues behind it).

list_modelsA

List the image models this server can drive (keys for the model parameter) with their readiness, plus everything ComfyUI currently has installed.

job_statusA

Peek at a job returned by generate_image/edit_image without waiting.

wait_for_jobA

Block up to timeout seconds for a job to finish. Returns the images (preview + saved path) when done, or the job status JSON if still running.

fetch_resultA

Return the images of a finished job (preview + saved path). Fails if the job is not done yet.

cancel_jobA

Cancel one of this server's own jobs: removes it from the ComfyUI queue or interrupts it if running.

Prompts

Interactive templates invoked by user choice

NameDescription
image_prompt_guidanceHow to write prompts and edit instructions for the available image models

Resources

Contextual data attached and managed by the client

NameDescription
modelsLive model inventory from ComfyUI

TDQS

A4.2/5.0

Scored across 8 tools

Disambiguation5/5

Each tool targets a distinct concern: generation, editing, server/model inspection, and job lifecycle management. The job-related tools (status, wait, fetch, cancel) are clearly differentiated by their blocking behavior and return payload.

Naming Consistency4/5

Most tools follow a clear verb_noun pattern: generate_image, edit_image, list_models, fetch_result, cancel_job. The two status tools (server_status, job_status) are noun-first, which is a minor deviation but still readable and internally consistent.

Tool Count5/5

Eight tools is well-scoped for an image generation/editing server with asynchronous job support. Each tool serves a clear purpose without redundancy or bloat.

Completeness5/5

The surface covers the full generation/edit workflow plus model discovery, server health, and complete job lifecycle management (status, wait, fetch, cancel). No critical operations are missing for the stated domain.

Maintenance

ActivityMaintained
ResponsivenessNo issues