<div align="center">
  <h1>
    <img src="images/recraft.svg" width="500px">
    <br/>Recraft MCP Server
  </h1>

  <img src="https://badge.mcpx.dev?type=server" title="MCP Server"/>
  <img src="https://img.shields.io/npm/v/@recraft-ai/mcp-recraft-server" alt="npm version"/>
  <img src="https://img.shields.io/npm/dw/@recraft-ai/mcp-recraft-server" alt="npm downloads"/>
  <a href="https://smithery.ai/server/@recraft-ai/mcp-recraft-server">
    <img src="https://smithery.ai/badge/@recraft-ai/mcp-recraft-server" alt="smithery badge">
  </a>
</div>

> [!CAUTION]
>
> ## Deprecated
>
> **This project is deprecated.** No further updates, bug fixes, or security patches will be published.
>
> Please use the **Recraft remote MCP server** instead, available at `https://mcp.recraft.ai/mcp`, following the [remote server documentation](https://www.recraft.ai/docs/mcp-reference/remote-server). It requires no local installation or API key — authentication is handled via OAuth in your browser. Please keep in mind that the remote MCP server uses a different credits model.
>
> To migrate in Claude Code:
>
> ```bash
> claude mcp add --transport http recraft https://mcp.recraft.ai/mcp
> ```
>
> To migrate in Claude Desktop, replace this server's entry in your `claude_desktop_config.json` with:
>
> ```json
> {
>   "mcpServers": {
>     "recraft": {
>       "command": "npx",
>       "args": ["-y", "mcp-remote", "https://mcp.recraft.ai/mcp"]
>     }
>   }
> }
> ```
>
> For Cursor, VS Code, and other MCP clients, see the [remote server documentation](https://www.recraft.ai/docs/mcp-reference/remote-server).

This is an MCP ([Model Context Protocol](https://modelcontextprotocol.io/)) server integrating MCP clients with [Recraft](https://recraft.ai/)'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](#table-of-contents)
- [Setup](#setup)
  - [Prerequisites](#prerequisites)
  - [Claude Desktop Extensions](#claude-desktop-extensions)
  - [Smithery](#smithery)
  - [Manual Setup](#manual-setup)
    - [From NPM](#from-npm)
    - [From source](#from-source)
- [Tools](#tools)

# Setup

## Prerequisites

- First of all, you will need a [Recraft API](https://www.recraft.ai/docs) key. To obtain it, register your account on [Recraft](https://www.recraft.ai); then go to your [profile API page](https://www.recraft.ai/profile/api). 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](https://claude.ai/download).

## Claude Desktop Extensions

If you are using [Claude Desktop](https://claude.ai/download) you can set up this server using [Claude Desktop Extensions](https://www.anthropic.com/engineering/desktop-extensions).

- Download `mcp-recraft-server.dxt` from the [latest release](https://github.com/recraft-ai/mcp-recraft-server/releases/latest/download/mcp-recraft-server.dxt)
- 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](https://www.recraft.ai/profile/api). 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](https://claude.ai/download).


## Smithery

You can find this MCP server on [Smithery](https://smithery.ai/server/@recraft-ai/mcp-recraft-server). 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](https://nodejs.org/en/download).

### From NPM

Modify your `claude_desktop_config.json` file to add the following:

```json
{
  "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:

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

In the directory with cloned repository run:

```bash
npm install
npm run build
```

Modify your `claude_desktop_config.json` file to add the following:

```json
{
  "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](https://www.recraft.ai/profile/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 <br/> - style <br/> - size <br/> - model <br/> - number of images | \$0.04/\$0.08 per raster/vector image |
| `create_style` | Creates a style from the list of images | - list of images <br/> - basic style | \$0.04 |
| `vectorize_image` | Vectorizes raster image | - image | \$0.01 |
| `image_to_image` | Generates raster/vector images from image and prompt | - image <br/> - prompt <br/> - similarity strength <br/> - style <br/> - size <br/> - model <br/> - 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 <br/> - prompt for background <br/> - style <br/> - size <br/> - model <br/> - 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](https://recraft.ai/docs).