Recraft MCP server

OfficialRecraftConfig last verified Jun 1, 2026

Recraft's official MCP server: generate and edit raster and vector images, build reusable styles, vectorize, upscale, and swap backgrounds from your agent.

Recraft MCP is Recraft's official server that puts its image generation and editing API behind an agent's tool calls. Recraft is a design-focused model that produces both raster and vector (SVG) output, can hold a consistent brand style across generations, and handles the editing operations a real workflow needs — vectorization, upscaling, and background removal or replacement. The server exposes each of these as a discrete tool, so a coding or chat agent can produce a logo, turn it into clean vectors, upscale a hero image, or strip a product photo's background without leaving the editor.

It installs two ways. Locally it runs over stdio with npx using the @recraft-ai/mcp-recraft-server package and a RECRAFT_API_KEY from your Recraft account; generated images are written to a local directory by default (configurable via IMAGE_STORAGE_DIRECTORY) or kept on Recraft's servers when RECRAFT_REMOTE_RESULTS_STORAGE is set. Recraft also hosts a remote endpoint at https://mcp.recraft.ai/mcp that authenticates with OAuth 2.0 against your Recraft account, so clients that support remote MCP can connect with no local setup. Either way you pay for generations against your Recraft credit balance, which the get_user tool can report.

Quick install

Copy-paste configs are provided for all 8 supported clients. Pick your client below.

Add to ~/.claude.json

~/.claude.json
json
{
  "mcpServers": {
    "recraft": {
      "type": "http",
      "url": "https://mcp.recraft.ai/mcp"
    }
  }
}
Or via CLI
bash
claude mcp add --transport http recraft https://mcp.recraft.ai/mcp

Heads up

  • First tool call opens a browser to authorize.

Available tools

ToolDescription
generate_imageGenerate raster or vector images from a text prompt, optionally applying a chosen style.
image_to_imageGenerate raster or vector images from an input image plus a prompt, transforming the source.
create_styleCreate a reusable style from a list of reference images so later generations stay on-brand.
vectorize_imageConvert a raster image into clean scalable vector (SVG) output.
remove_backgroundRemove the background from an image, leaving a transparent cutout.
replace_backgroundGenerate a new background for an image from a text prompt.
crisp_upscaleUpscale an image with a crisp, detail-preserving enhancement.
creative_upscaleUpscale an image with a creative enhancement that adds plausible detail.
get_userGet information about the authenticated user, including the remaining credit balance.

Required configuration

  • RECRAFT_API_KEYRequired

    Recraft API key from recraft.ai/profile/api. Required for the local stdio server; the remote server uses OAuth instead.

  • IMAGE_STORAGE_DIRECTORYOptional

    Directory where generated images are saved locally. Optional; defaults to ~/.mcp-recraft-server.

  • RECRAFT_REMOTE_RESULTS_STORAGEOptional

    Set to 1 to store results remotely on Recraft instead of saving to disk. Optional.

What you can do with it

Produce on-brand raster and vector art

Ask the agent for a logo or illustration and it calls generate_image; capture the look with create_style, then reuse that style on later generations so a whole set of assets stays consistent.

Edit and finish images in the agent loop

Hand the agent an existing image and have it vectorize it for print, swap the background with replace_background, or sharpen it with crisp_upscale — all without round-tripping through a separate design tool.

FAQ

Is it free?
The MCP server is open source under an MIT license and free to run, but every generation and edit calls the Recraft API, which is paid and metered against your account's credit balance. The get_user tool reports your remaining credits.
Does it support remote/OAuth?
Yes. Recraft hosts a remote endpoint at https://mcp.recraft.ai/mcp that authenticates with OAuth 2.0 against your Recraft account, so supported clients connect with no local install. You can also run the local stdio server with npx @recraft-ai/mcp-recraft-server and a RECRAFT_API_KEY.
Can it output vectors, not just raster images?
Yes. generate_image and image_to_image can return vector (SVG) output, and vectorize_image converts an existing raster image into clean vectors — a core reason designers reach for Recraft over raster-only image models.
← Browse all ai-ml servers