io.github.runcomfy-com-runcomfy-mcp

The io.github.runcomfy-com/runcomfy-mcp is a remote MCP server for the RunComfy Serverless API (ComfyUI). It handles deployments and asynchronous inference, exposing 10 tools that mirror the serverless docs. It provides an endpoint for MCP interactions and a dedicated docs page.

🛠️ Key Features

Remote MCP server for RunComfy Serverless API (ComfyUI)
Deployment management and asynchronous inference
10 tools mirroring serverless documentation
Endpoint: https://mcp.runcomfy.com/mcp
Documentation link: docs.runcomfy.com/mcp
Readme excerpt highlights deployment operations and tooling

🚀 Use Cases

Manage deployments programmatically
Run inference asynchronously across AI assistants
Retrieve and orchestrate results from multiple assistants (e.g., Claude, Cursor, Windsurf)
Integrate RunComfy MCP into serverless pipelines

⚡ Developer Benefits

Clear MCP endpoint and mapping to serverless tools
Mirrors official serverless docs for consistency
Focused on deployment lifecycle (list, get, create, update)
Grounded in a concise readme excerpt with tool coverage

⚠️ Limitations

Source data excerpt is partial; complete tool catalog is not shown
Specific tool definitions and parameters are truncated in the excerpt
Behavior beyond the documented endpoints may require direct docs access

RunComfy MCP

MCP server for the RunComfy Serverless API (ComfyUI). Manage deployments, run inference, and retrieve results from AI assistants like Claude, Cursor, and Windsurf.

Endpoint: https://mcp.runcomfy.com/mcp

Docs: docs.runcomfy.com/mcp

What it does

10 tools that mirror docs.runcomfy.com/serverless 1:1:

Category	Tools
Deployment management	`list_deployments`, `get_deployment`, `create_deployment`, `update_deployment`, `delete_deployment`
Inference	`submit_request`, `get_request_status`, `get_request_result`, `cancel_request`
Advanced	`call_instance_proxy`

Quick setup

Claude Code

bash

claude mcp add runcomfy \
  --transport streamable-http \
  https://mcp.runcomfy.com/mcp \
  --header "Authorization: Bearer <YOUR_RUNCOMFY_TOKEN>"

Cursor

Add to .cursor/mcp.json:

json

{
  "mcpServers": {
    "runcomfy": {
      "url": "https://mcp.runcomfy.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_RUNCOMFY_TOKEN>"
      }
    }
  }
}

Windsurf

Add to Windsurf Settings > MCP:

json

{
  "mcpServers": {
    "runcomfy": {
      "serverUrl": "https://mcp.runcomfy.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_RUNCOMFY_TOKEN>"
      }
    }
  }
}

Get your API token from your Profile page.

Architecture

code

MCP Client  ──Bearer token──>  Cloudflare Worker (/mcp)
                                      │
                                      ▼
                              Cloudflare Container
                              (Python FastMCP app)
                                      │
                                      ▼
                              api.runcomfy.net
                              (using caller's token)

Cloudflare Worker (src/index.ts) — thin proxy: CORS, body size check, forwards the caller's token to the container. No auth logic — api.runcomfy.net handles authentication.
Python container (server.py) — FastMCP app with 10 tools. Uses the caller's token (forwarded via x-runcomfy-user-token header) for all outbound API calls. Each user sees only their own deployments.
Cloudflare Container auto-starts on first request, sleeps after 10 minutes idle.

Project layout

code

src/index.ts          Cloudflare Worker entrypoint
server.py             MCP tool definitions (10 tools)
runcomfy_client.py    RunComfy API client (serverless endpoints)
container_app.py      ASGI middleware (request IDs, token forwarding)
container_entrypoint.py  Uvicorn startup
container_runtime.py  Env validation, structured logging
wrangler.jsonc        Cloudflare Worker + Container config
Dockerfile            Container image
.env.example          Local dev config

Local development

bash

# Python 3.11+
python3.11 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
# Set RUNCOMFY_API_KEY in .env
python -m container_entrypoint

Local endpoints:

http://127.0.0.1:8000/healthz
http://127.0.0.1:8000/mcp

In local mode (no Worker), the Python app uses RUNCOMFY_API_KEY from .env for all outbound calls.

Deploy

Requires Cloudflare Workers Paid plan with Containers enabled.

bash

npm install

# Set the API key secret (one-time)
npx wrangler secret put RUNCOMFY_API_KEY

# Deploy
CLOUDFLARE_ACCOUNT_ID=<your-account-id> npx wrangler deploy

The MCP endpoint goes live at https://mcp.runcomfy.com/mcp (custom domain configured in wrangler.jsonc).

Environment variables

Worker secrets (set via `wrangler secret put`)

Name	Required	Description
`RUNCOMFY_API_KEY`	Yes	Fallback API key for the container

Worker vars (in `wrangler.jsonc`)

Name	Default	Description
`CONTAINER_INSTANCE_NAME`	`runcomfy-unified`	Durable Object instance name
`CONTAINER_STARTUP_TIMEOUT_MS`	`15000`	Max wait for container start
`CONTAINER_PORT_READY_TIMEOUT_MS`	`30000`	Max wait for port ready
`MCP_MAX_BODY_BYTES`	`1048576`	Max request body size
`RUNCOMFY_SERVERLESS_BASE_URL`	`https://api.runcomfy.net`	Serverless API base URL

Local dev (`.env` file)

Name	Required	Description
`RUNCOMFY_API_KEY`	Yes	Your RunComfy API token
`RUNCOMFY_SERVERLESS_BASE_URL`	No	Override base URL (default: `https://api.runcomfy.net`)
`RUNCOMFY_MCP_MOUNT_PREFIX`	No	Path prefix for MCP mount (default: empty)

ids	any	optional
include_payload	boolean	optional
include_readme	boolean	optional

deployment_id	string	required
include_payload	boolean	optional
include_readme	boolean	optional

name	string	required
workflow_id	string	required
workflow_version	string	required
hardware	string	optional
min_instances	integer	optional
max_instances	integer	optional
queue_size	integer	optional
keep_warm_duration_in_seconds	integer	optional

deployment_id	string	required
name	any	optional
workflow_version	any	optional
hardware	any	optional
min_instances	any	optional
max_instances	any	optional
queue_size	any	optional
keep_warm_duration_in_seconds	any	optional
is_enabled	any	optional

deployment_id	string	required
overrides	any	optional
workflow_api_json	any	optional
extra_data	any	optional
webhook_url	any	optional
webhook_intermediate_status	any	optional
wait_for_completion	boolean	optional
timeout_seconds	integer	optional

Runcomfy MCP

io.github.runcomfy-com-runcomfy-mcp

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

list_deployments

get_deployment

create_deployment

update_deployment

delete_deployment

submit_request

get_request_status

get_request_result

cancel_request

call_instance_proxy

RunComfy MCP

What it does

Quick setup

Claude Code

Cursor

Windsurf

Architecture

Project layout

Local development

Deploy

Environment variables

Worker secrets (set via `wrangler secret put`)

Worker vars (in `wrangler.jsonc`)

Local dev (`.env` file)

Install

Remote endpoint

io.github.runcomfy-com-runcomfy-mcp

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

list_deployments

get_deployment

create_deployment

update_deployment

delete_deployment

submit_request

get_request_status

get_request_result

cancel_request

call_instance_proxy

RunComfy MCP

What it does

Quick setup

Claude Code

Cursor

Windsurf

Architecture

Project layout

Local development

Deploy

Environment variables

Worker secrets (set via wrangler secret put)

Worker vars (in wrangler.jsonc)

Local dev (.env file)

Install

Remote endpoint

Worker secrets (set via `wrangler secret put`)

Worker vars (in `wrangler.jsonc`)

Local dev (`.env` file)