Skip to main content
Glama
Sign In
Recraft AI MCP Server

Recraft AI MCP Server

Official
by recraft-ai
OverviewSchemaSourceRelated ServersDiscussions(2)Admin
TypeScript
Hybrid
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. 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:

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:

{
  "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.

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

Setup

Related MCP server: Image MCP Server

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.

Available Tools

9 tools
create_styleA

Create a style in Recraft from the set of style reference images. A style is extracted from the provided images and can be used in image generation tools. ID of the created style will be returned in the response.

Inputs: style (required), imageURIs (required).

creative_upscaleA

Creative upscale of the input image using Recraft. This operation takes an input image and returns an upscaled image, boosting resolution with a focus on refining small details and faces. This version of upscale is expensive and slower than crisp upscale. Local path or URL to resulting image and its preview will be returned in the response.

Inputs: imageURI (required).

crisp_upscaleA

Crisp upscale of the input image using Recraft. This operation takes an input image and returns an upscaled image, making the image sharper and cleaner. This version of upscale is much cheaper and faster than creative upscale. Local path or URL to resulting image and its preview will be returned in the response.

Inputs: imageURI (required).

generate_imageA

Generate an image using Recraft from a text prompt. You can specify the image size, style, model, and number of images to generate. You don't need to change default parameters if you don't have any specific requirements. You can use styles to refine the image generation, and also to generate raster or vector images. Local paths or URLs to generated images and their previews will be returned in the response.

Inputs: prompt (required), size, style, substyle, +3 more.

get_userA

Get information about the current Recraft API user (their email, name, and credit balance).

Inputs: no named parameters.

image_to_imageA

Generate an image using Recraft from an input image and a text prompt. You can specify the reference input image, style, model, and number of images to generate. You should provide the same style/substyle/styleID settings as were used for input image generation (if exists) if there are no specific requirements to change the style. Other parameters are recommended to keep default if you don't have any specific requirements on them. You can use styles to refine the image generation, and also to generate raster or vector images. Local paths or URLs to generated images and their previews will be returned in the response.

Inputs: imageURI (required), prompt (required), strength (required), style, +4 more.

remove_backgroundA

Remove background in the input image using Recraft. This operation takes an input image and returns the same image with detected background removed. Raster image will be always returned. Local path or URL to resulting image and its preview will be returned in the response.

Inputs: imageURI (required).

replace_backgroundA

Generate an image using Recraft from an input image with its detected background replaced based on the prompt. You can specify the input image, style, model, and number of images to generate. You should provide the same style/substyle/styleID settings as were used for input image generation (if exists) if there are no specific requirements to change the style. Other parameters are recommended to keep default if you don't have any specific requirements on them. You can use styles to refine the image background generation, and also to generate raster or vector images. Local paths or URLs to generated images and their previews will be returned in the response.

Inputs: imageURI (required), prompt (required), style, substyle, +2 more.

vectorize_imageB

Vectorize an input image using Recraft. This operation takes an input image and returns a vector SVG image, close to it. Local path or URL to resulting image and its preview will be returned in the response.

Inputs: imageURI (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    A4/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: text-to-image, image-to-image, two upscales with different cost/quality, background removal/replacement, vectorization, style creation, and user info. No overlap or confusion.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun snake_case pattern (e.g., create_style, generate_image, remove_background). No deviations or mixed conventions.

    Tool Count5/5

    With 9 tools, the server is well-scoped for an image generation and editing API. Each tool covers a necessary operation without unnecessary bloat or deficiency.

    Completeness4/5

    Core image generation and editing workflows are covered: text-to-image, image-to-image, upscaling, background manipulation, vectorization, and style creation. Minor gaps include lack of explicit editing operations like inpainting or rotation, but these are not essential for the server's stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Image MCP Server

      iplanwebsites
      A
      license
      C
      quality
      Not graded
      maintenance
      An MCP server that provides AI image generation capabilities using OpenAI and Replicate APIs with support for customizable prompts and dimensions. It features specialized tools for generating square, landscape, and portrait images through simple natural language commands.
      5
      44 npm
      MIT

    • Nano-Banana MCP Server

      bongartzdiaz
      A
      license
      A
      quality
      D
      maintenance
      An MCP server that provides AI image generation and editing capabilities using Google's Gemini 2.5 Flash Image API. It allows users to create new images from text, modify existing files, and perform iterative edits through natural language prompts.
      6
      1,683 npm
      MIT

    Appeared in Searches