> ## 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.

# Comfy Partner MCP

> A local MCP server providing unified generation tools across 30+ partner providers (BFL, Ideogram, Kling, Runway, Veo, Meshy, ElevenLabs, and more).

<Warning>
  **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.
</Warning>

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](/development/api-development/getting-an-api-key)** (starts with `comfyui-`) — get one from the Comfy partner dashboard

***

## Installation

```bash theme={null}
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:

```json theme={null}
{
  "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:**

| Client         | Config 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`)                                                                                      |
| Amp            | Settings → 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:

```bash theme={null}
COMFY_API_KEY=comfyui-... node /ABSOLUTE/PATH/TO/partner-mcp/packages/mcp/dist/bin.js
```

***

## Environment Variables

| Variable                   | Required | Purpose                                                                                              |
| -------------------------- | -------- | ---------------------------------------------------------------------------------------------------- |
| `COMFY_API_KEY`            | yes      | API key (`comfyui-…`). Sent as `X-API-Key` header.                                                   |
| `COMFY_API_BASE_URL`       | no       | Override the proxy host (defaults to production Comfy API).                                          |
| `COMFY_INLINE_LIMIT_KB`    | no       | Cap (KB) for inlining image bytes in tool results. Default `600`.                                    |
| `COMFY_MCP_RESOURCE_LINKS` | no       | Force `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.

| Tool             | Description                                                                                      |
| ---------------- | ------------------------------------------------------------------------------------------------ |
| `generate_image` | Generate still images — text-to-image, edit, or upscale                                          |
| `generate_video` | Generate video clips — text-to-video, image-to-video, or lipsync                                 |
| `generate_3d`    | Generate 3D meshes (GLB/FBX/OBJ) from text or a reference image                                  |
| `generate_svg`   | Generate SVG vector illustrations from a text prompt                                             |
| `generate_audio` | Generate speech, voice clones, or sound effects from text                                        |
| `generate_music` | Generate instrumental or vocal music from a prompt                                               |
| `media_upload`   | Upload a file (image/video/audio) and get a `media:<id>` reference for use in `generate_*` calls |
| `read_media`     | Fetch and render a media artifact inline — accepts an HTTPS URL or a `media:…` token             |
| `models_explore` | Discover models, search by capability, and read a model's full call shape                        |
| `balance`        | Get 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
```

***

## Related

* [Comfy Cloud MCP](/agent-tools/cloud) — Hosted MCP server for Comfy Cloud workflow execution
* [Comfy Partner Nodes CLI](/comfy-cli/reference#generate-partner-nodes) — Use partner nodes from the command line