# ZenCreator MCP Server

ZenCreator is an AI image and video generation platform. The ZenCreator MCP server lets any MCP client — Claude.ai, Claude Desktop, Claude Code, Cursor, ChatGPT — drive ZenCreator on your behalf: generate images and video, edit and composite with reference images, face-swap, upscale, lip-sync, animate photos, browse templates, and manage your assets and credits. It exposes a family of `zencreator_*` tools that proxy the ZenCreator API, so your AI client can run real generation jobs from inside a chat.

## Why it's different

Most MCP servers are something you install and run locally, wired up with an API key you paste into a config file. ZenCreator's MCP is the opposite: a **hosted, remote server secured with OAuth 2.1**.

Connecting means:

- **Add one URL** — `https://mcp.zncr.pro/mcp`.
- **Log in once** in your browser. You approve a consent screen; that's it.
- **No API keys** to paste, nothing to install, no local process to run.
- **Tokens are automatic** — your client stores the token and refreshes it for you.

You need a ZenCreator account at [app.zencreator.pro](https://app.zencreator.pro). You log in with it during the OAuth flow.

## What you can make

Each capability runs through a **generation tool** you pass to `zencreator_create_task` (named in parentheses). Full model details live in [Generation tools & models](./models.md).

- **Generate images from text** (`by_prompt`)
- **Edit and composite images with references** — the main, most flexible image tool (`image_editor`)
- **Generate a new face from attributes** (`facegen`)
- **Run a face + body reference batch through a preset** (`photoshoot`)
- **Face-swap onto a photo** — image only (`faceswap`)
- **Upscale an image to a higher resolution** (`upscaler`)
- **Animate a photo into video, or text → video** (`videogen`, `text_to_video`)
- **Replace a character in an existing video** (`video2video`)
- **Lip-sync a talking head from audio + a first frame** (`lipsync`)
- **Upscale a video** (`video_upscaler`)
- **Stitch 2–5 video clips into one, with transitions** (`video_merger`)
- **Browse and reuse templates** (presets with ready-to-submit inputs)

ZenCreator also supports uncensored / NSFW generation, gated by account settings. See [Concepts](./concepts.md) for how the `nsfw_allowed` and `is_trusted` gates work.

## The connection in one line

```
https://mcp.zncr.pro/mcp
```

Add that URL in your client, log in, and you're connected. See the [Quickstart](./quickstart.md) or pick your client below.

## Documentation map

This page is the navigation hub. Every other page is linked here.

### Get started

| Page | What it covers |
| --- | --- |
| [Quickstart](./quickstart.md) | Connect and run your first generation in a few minutes. |

### Connect your client

| Page | What it covers |
| --- | --- |
| [Claude.ai (web)](./connect/claude-ai.md) | Add the connector in Settings and log in via OAuth. |
| [Claude Code (CLI)](./connect/claude-code.md) | `claude mcp add`, scopes, and authenticating via `/mcp`. |
| [Cursor](./connect/cursor.md) | Add the remote MCP server and complete the browser login. |
| [ChatGPT](./connect/chatgpt.md) | Add a custom connector under Settings → Connectors. |

### Understand it

| Page | What it covers |
| --- | --- |
| [Concepts](./concepts.md) | The two layers (MCP tools vs. generation tools), tasks and calls, assets, templates, credits, NSFW gates, and the response contract. |
| [Workflows](./workflows.md) | End-to-end recipes: generate, edit, upscale, animate, lip-sync, and use templates. |
| [Generation tools & models](./models.md) | Every `tool_name` value and its models, with prompt guidance. |

### Tool reference

| Page | What it covers |
| --- | --- |
| [Generation & tasks](./tools/generation.md) | Discovery, pricing, and task-lifecycle tools (`create_task`, `run_and_wait`, `get_task`, and more). |
| [Assets](./tools/assets.md) | Upload assets and fetch download / preview URLs. |
| [Templates](./tools/templates.md) | List, fetch, use, and (where enabled) search templates. |
| [Account](./tools/account.md) | Profile, credit balance, and transaction history. |

### Operate

| Page | What it covers |
| --- | --- |
| [Troubleshooting](./troubleshooting.md) | Connection, auth, out-of-credits, and NSFW-gate fixes. |

## First steps

New here? Start with the **[Quickstart](./quickstart.md)** — it walks you from adding the URL to running your first generation. If you already know which client you use, jump straight to its [connect guide](./connect/claude-code.md).