Skip to main content
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 (or run claude mcp add)
AmpSettings → MCP Servers, or ~/.config/amp/settings.json
After adding the config, restart your MCP client. You should see 10 tools registered under the comfy-partner server. To verify the server starts correctly before wiring it into a client, run it directly — it should print the JSON-RPC handshake and then idle: 
COMFY_API_KEY=comfyui-... node /ABSOLUTE/PATH/TO/partner-mcp/packages/mcp/dist/bin.js

​
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. Defaults to an allowlist (claude-*, mcp-inspector).

​
Available Tools

The MCP server exposes 10 tools. After a successful install, your MCP client should show all 10 registered under the comfy-partner server.
ToolDescription
generate_imageGenerate still images — text-to-image, edit, or upscale
generate_videoGenerate video clips — text-to-video, image-to-video, or lipsync
generate_3dGenerate 3D meshes (GLB/FBX/OBJ) from text or a reference image
generate_svgGenerate SVG vector illustrations from a text prompt
generate_audioGenerate speech, voice clones, or sound effects from text
generate_musicGenerate instrumental or vocal music from a prompt
media_uploadUpload a file (image/video/audio) and get a media:<id> reference for use in generate_* calls
read_mediaFetch and render a media artifact inline — accepts an HTTPS URL or a media:… token
models_exploreDiscover models, search by capability, and read a model’s full call shape
balanceGet the current account’s remaining balance in USD

​
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