🎨 Recraft MCP Server

A Model Context Protocol (MCP) server that gives AI assistants (Claude, Gemini, or any MCP client) direct access to the Recraft AI image generation API — generate, transform, upscale, and vectorize images without leaving your chat.

"Generate a set of 8 fantasy game icons in the same art style." "Remove the background from this screenshot and upscale it." "Create 5 style variations of this logo and put them in a comparison grid."

Coming from the official server?

Recraft archived @recraft-ai/mcp-recraft-server in July 2026 and now points users at a hosted endpoint, https://mcp.recraft.ai/mcp. Which of the three you want depends on what you are doing:

If you only generate the occasional image, the hosted server is less work and this one has nothing to offer you. If you are producing assets in bulk, working from files already on disk, or need to know what a run costs before it runs, that is what this exists for.

Tool name mapping

The names are the old ones with a recraft_ prefix, except where noted:

One behavioural difference worth knowing: Recraft's style field takes six broad families, and the specific look (pixel_art, kawaii, b_and_w…) is a separate substyle field. Passing a substyle name as style is silently ignored by the API. This server accepts either and routes it correctly, so prompts written against the old servers keep working.

🌟 Key Features

• 🖼️ Text-to-image generation across all Recraft models (V4.1, V4 Styles, V4, V4 Vector/SVG, V4 Pro, V3, V2), with the full style taxonomy — 6 families × 104 substyles, generated from Recraft's own API spec rather than transcribed by hand
• 🔁 Image transformation — image-to-image, inpaint, background replace/generate, outpaint (canvas expansion), variations
• ✨ Enhancement — background removal, vectorization, crisp/creative upscale, region erase
• 🔎 Discovery — open-ended exploration generation, "more like this," and automatic prompt enhancement
• 🧩 Asset pipelines — one-call generate → download → background-remove → save, batch generation, themed asset sets with style consistency
• 🎮 Game-dev extras — sized generation for sprites/icons, style comparison grids, texture/atlas swapping

🛠️ Provided Tools

This MCP server exposes 24 tools to your AI agent — full coverage of the Recraft API.

Generation

Discovery

Transformation

Enhancement

Style management

Assets & account

⚙️ Quick Start

Requires Node.js 20.9.0 or newer. Version 1.1.0 upgrades the native image-processing dependencies to address known libvips vulnerabilities; Node.js 18 is no longer supported.

1. Get a Recraft API key

Sign up at recraft.ai and grab an API key from your account settings.

2. Install & configure

claude mcp add --scope user recraft \
  -e RECRAFT_API_KEY=your-api-key-here \
  -- npx -y recraft-mcp-server

Or add it manually to your MCP client config:

{
  "mcpServers": {
    "recraft": {
      "command": "npx",
      "args": ["-y", "recraft-mcp-server"],
      "env": {
        "RECRAFT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Environment Variables

Docker

docker build -t recraft-mcp-server .
docker run -i --rm -e RECRAFT_API_KEY=your-key recraft-mcp-server

In an MCP client config:

{
  "mcpServers": {
    "recraft": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "RECRAFT_API_KEY", "recraft-mcp-server"],
      "env": { "RECRAFT_API_KEY": "your-key" }
    }
  }
}

The container talks MCP over stdio and never opens a port, so -i is required and -p is not. It runs as an unprivileged user; tools that write files need the target directory bind-mounted (-v /path:/path).

🤖 Example AI Prompts

Game asset pipeline:

"Generate a themed set of 6 fantasy potion icons in the same style, then export a Pixi.js manifest." → recraft_generate_themed_set

Quick sprite generation:

"Generate a 64x64 pixel-art coin icon." → recraft_generate_sized

Style exploration:

"Show me this logo prompt in 4 different styles side by side." → recraft_compare_styles

Photo cleanup:

"Remove the background from this photo and upscale it for print." → recraft_remove_background → recraft_creative_upscale

Asset swapping:

"Swap the texture in this region of the spritesheet with a new design." → recraft_texture_swap

Canvas expansion:

"Widen this image to a 16:9 banner without cropping the subject." → recraft_outpaint

Open-ended exploration:

"Explore some ideas for a race car on a track, then give me more like the third one." → recraft_explore → recraft_explore_similar

Prompt polishing:

"Enhance this rough prompt before generating: 'red panda with a sign.'" → recraft_enhance_prompt

Development

git clone https://github.com/muhammetali/recraft-mcp-server.git
cd recraft-mcp-server
npm install
npm run build
npm test
npm run audit:security
npm run verify

Version 1.2.0 uses the official modular MCP SDK v2 while preserving all 24 tools. See security policy and dependency review for release checks, dependency decisions, and necessary runtime capabilities.

📄 License

MIT — see LICENSE.