Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.comfy.org/llms.txt

Use this file to discover all available pages before exploring further.

Private preview — waitlist required. The Comfy Partner MCP server is currently in a private preview. Features and APIs may change. Sign up for the waitlist to request access.
Comfy Partner MCP is a local MCP server that provides AI agents with unified generation tools across 30+ partner providers, including BFL, Ideogram, Kling, Runway, Veo, Meshy, ElevenLabs, and more. It uses a single canonical request shape for all generation types. Key features:
  • 🎨 6 generation modalities — image, video, 3D, SVG, audio, and music
  • 🔌 30+ providers under one interface
  • 💻 Local server — runs on your machine, connects to the Comfy API
  • 🔍 Built-in model search with BM25 text search
  • 🧩 Drop-in compatible with Claude Desktop, Claude Code, and Amp

​
Requirements

  • Node.js 20+
  • pnpm 10
  • Comfy API key (starts with comfyui-) — get one from the Comfy partner dashboard

​
Installation

git clone <repo-url> partner-mcp
cd partner-mcp
pnpm install
pnpm build
After building, the MCP server launcher is at packages/mcp/dist/bin.js.

​
Configuration

Add the server to your MCP client config. The same JSON format works across Claude Desktop, Claude Code, and Amp: 
{
  "mcpServers": {
    "comfy-partner": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/partner-mcp/packages/mcp/dist/bin.js"],
      "env": {
        "COMFY_API_KEY": "comfyui-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}
Client config locations:
ClientConfig file
Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%/Claude/claude_desktop_config.json (Windows)
Claude Code~/.claude/mcp.json
AmpSettings → MCP Servers, or ~/.config/amp/settings.json
After adding the config, restart your MCP client. You should see tools registered under the comfy-partner server.

​
Environment Variables

VariableRequiredPurpose
COMFY_API_KEYyesAPI key (comfyui-…). Sent as X-API-Key header.
COMFY_API_BASE_URLnoOverride the proxy host (defaults to production Comfy API).
COMFY_INLINE_LIMIT_KBnoCap (KB) for inlining image bytes in tool results. Default 600.
COMFY_MCP_RESOURCE_LINKSnoForce resource_link content blocks on/off.

​
Available Tools

The MCP server provides tools for all major generation modalities:
ToolDescription
generate_imageGenerate images from text prompts
generate_videoGenerate video from text or images
generate_3dGenerate 3D models (GLB/FBX/OBJ)
generate_svgGenerate SVG vector graphics
generate_audioGenerate speech or sound effects
generate_musicGenerate music tracks
models_exploreSearch and explore available models
balanceCheck your account balance
regionsList available generation regions

​
Example Prompts

After installing, try these in your AI assistant: 
Generate an image of a cat astronaut floating in space, photorealistic style

Generate a short video of a sunset over the ocean

Create a 3D model of a modern chair

Generate music with a calm, lo-fi vibe, about 30 seconds long