Recraft MCP Server

What is Recraft MCP Server about?

Provides an MCP server that connects MCP clients (e.g., Claude Desktop) with Recraft's suite of image services, covering raster and vector generation, editing, styling, vectorization, background manipulation, and upscaling.

How to use Recraft MCP Server?

1. Obtain a Recraft API key from your Recraft account.
2. Add the server to your MCP client configuration (e.g., claude_desktop_config.json). Preferred installation via npm:

   {
     "mcpServers": {
       "recraft": {
         "command": "npx",
         "args": ["-y", "@recraft-ai/mcp-recraft-server@latest"],
         "env": {
           "RECRAFT_API_KEY": "<YOUR_RECRAFT_API_KEY>",
           "IMAGE_STORAGE_DIRECTORY": "<YOUR_IMAGE_STORAGE_DIRECTORY>",
           "RECRAFT_REMOTE_RESULTS_STORAGE": "<YOUR_REMOTE_RESULTS_STORAGE_INDICATOR>"
         }
       }
     }
   }
   

3. Run the MCP client; the server will start automatically and listen for tool requests.
4. Optional: install via Claude Desktop Extensions (.dxt file) or clone the repo and run npm install && npm run build.

Key Features

• Generate raster or vector images from text prompts.
• Create custom styles from a set of reference images.
• Vectorize existing raster images.
• Image‑to‑image generation with controllable similarity strength.
• Background removal and replacement with new generated backgrounds.
• Two upscaling options: crisp (low‑cost) and creative (high‑quality).
• Ability to store results locally or remotely, returning URLs when remote storage is enabled.
• Built‑in get_user tool to fetch account information and remaining credit balance.

Use Cases

• Automated content creation pipelines for marketing assets.
• Real‑time image generation in AI assistants or chat interfaces.
• Batch processing of photos for vector conversion and upscaling.
• Dynamic background removal/replacement for e‑commerce product images.
• Designing custom visual styles for branding projects.

FAQ

Q: Which environment variables are required?
A: RECRAFT_API_KEY is mandatory; IMAGE_STORAGE_DIRECTORY and RECRAFT_REMOTE_RESULTS_STORAGE are optional for controlling where results are saved.

Q: Can I run the server without npm?
A: Yes, by cloning the repository, building it locally, and configuring the command to node with the compiled dist/index.js.

Q: How are pricing and credits handled?
A: Each tool lists its per‑image cost (e.g., $0.04 for raster generation). Credits are deducted from your Recraft account automatically.

Q: What image formats are supported?
A: The server forwards requests to Recraft, which supports common raster formats (PNG, JPEG) and vector formats (SVG, PDF).

Q: Is remote result storage optional?
A: Yes. Set RECRAFT_REMOTE_RESULTS_STORAGE="1" to store images remotely and receive URLs; otherwise images are saved locally in the specified directory.

This is an MCP (Model Context Protocol) server integrating MCP clients with Recraft's raster- and vector-image operations:

• raster and vector image generation
• raster and vector image editing
• creating custom styles and generating images in them
• vectorization of raster images
• background removal and replacement
• upscaling of raster images

By connecting this MCP server to your MCP client you will be able to generate high-quality raster and vector images using Recraft, combining different tools.

Table of Contents

• Table of Contents
• Setup
  • Prerequisites
  • Claude Desktop Extensions
  • Smithery
  • Manual Setup
    • From NPM
    • From source
• Tools

Setup

Prerequisites

• First of all, you will need a Recraft API key. To obtain it, register your account on Recraft; then go to your profile API page. Here you can buy API units (credits) and generate an API key.

• You will need to have an MCP client installed, for example Claude Desktop.

Claude Desktop Extensions

If you are using Claude Desktop you can set up this server using Claude Desktop Extensions.

• Download mcp-recraft-server.dxt from the latest release
• Double-click the file to open it with Claude Desktop
• Click Install
• Fill out the form
• Enable the server

In the form you need to paste your Recraft API key obtained on your profile API page. You can also specify a local path for generated image storage or indicate that all results should be stored remotely.

In case of installation issues, check that you have the latest version of Claude Desktop.

Smithery

You can find this MCP server on Smithery. If this MCP is installed from Smithery, all generation results will be stored remotely. Use Desktop Extensions or Manual Setup to store generation results on your local device.

Manual Setup

You're going to need Node running on your machine so you can run npx or node commands in your terminal. If you don't have Node, you can install it from nodejs.org.

From NPM

Modify your claude_desktop_config.json file to add the following:

{
  "mcpServers": {
    "recraft": {
      "command": "npx",
      "args": [
        "-y",
        "@recraft-ai/mcp-recraft-server@latest"
      ],
      "env": {
        "RECRAFT_API_KEY": "<YOUR_RECRAFT_API_KEY>",
        "IMAGE_STORAGE_DIRECTORY": "<YOUR_IMAGE_STORAGE_DIRECTORY>",
        "RECRAFT_REMOTE_RESULTS_STORAGE": "<YOUR_REMOTE_RESULTS_STORAGE_INDICATOR>"
      }
    }
  }
}

From source

Clone this repository:

git clone https://github.com/recraft-ai/mcp-recraft-server.git

In the directory with cloned repository run:

npm install
npm run build

Modify your claude_desktop_config.json file to add the following:

{
  "mcpServers": {
    "recraft": {
      "command": "node",
      "args": ["<ABSOLUTE_PATH_TO_CLONED_DIRECTORY>/dist/index.js"],
      "env": {
        "RECRAFT_API_KEY": "<YOUR_RECRAFT_API_KEY>",
        "IMAGE_STORAGE_DIRECTORY": "<YOUR_IMAGE_STORAGE_DIRECTORY>",
        "RECRAFT_REMOTE_RESULTS_STORAGE": "<YOUR_REMOTE_RESULTS_STORAGE_INDICATOR>"
      }
    }
  }
}

You can specify these parameters:

• RECRAFT_API_KEY: mandatory parameter, your Recraft API key.
• IMAGE_STORAGE_DIRECTORY: optional parameter, you can specify the directory in which all generated images will be stored. By default this directory is $HOME_DIR/.mcp-recraft-server. If RECRAFT_REMOTE_RESULTS_STORAGE="1", the value of this parameter is ignored.
• RECRAFT_REMOTE_RESULTS_STORAGE: optional parameter, you can set the value to "1", in this case all generated images will be stored remotely and their URLs will be returned. Also, IMAGE_STORAGE_DIRECTORY will be ignored in this case.

Tools

In this MCP you can use the following tools:

Tool Name	Description	Parameters	Price
generate_image	Generates raster/vector images from prompt	- prompt - style - size - model - number of images	$0.04/$0.08 per raster/vector image
create_style	Creates a style from the list of images	- list of images - basic style	$0.04
vectorize_image	Vectorizes raster image	- image	$0.01
image_to_image	Generates raster/vector images from image and prompt	- image - prompt - similarity strength - style - size - model - number of images	$0.04/$0.08 per raster/vector image
remove_background	Removes background in image	- image	$0.01
replace_background	Generates new background in image from prompt	- image - prompt for background - style - size - model - number of images	$0.04/$0.08 per raster/vector image
crisp_upscale	Crisp upscale of image	- image	$0.004
creative_upscale	Creative upscale of image	- image	$0.25
get_user	Get information about the user and left balance

You can find the detailed explanation of tools, their parameters, and prices in Recraft API docs.