How to add Recraft MCP Server (Official) to Windsurf

Official Recraft server for raster and vector image generation, vectorization, and editing. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 60★ · stdio · apikey · official

Windsurf config for Recraft MCP Server (Official)

npx -y @recraft-ai/mcp-recraft-server@latest

{
  "mcpServers": {
    "recraft-mcp-server-official": {
      "command": "npx",
      "args": [
        "-y",
        "@recraft-ai/mcp-recraft-server@latest"
      ],
      "env": {
        "RECRAFT_API_KEY": "<your-api-key>",
        "IMAGE_STORAGE_DIRECTORY": "/absolute/path/to/output/dir"
      }
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Recraft MCP Server (Official) config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Recraft MCP Server (Official)'s tools become available to Cascade.

Before you start

Node.js installed (to run npx or node)
A Recraft account at recraft.ai
A Recraft API key generated from your profile's API page
Recraft API credits purchased for your account (generation consumes credits)
An MCP-capable client (Claude Desktop, Cursor, etc.)

What Recraft MCP Server (Official) can do in Windsurf

generate_image

Generate a raster or vector image from a text prompt

image_to_image

Transform or edit an existing image guided by a prompt

vectorize_image

Convert a raster image into a vector (SVG)

create_style

Create a reusable custom style from reference images

remove_background

Remove the background from an image

replace_background

Replace an image's background based on a prompt

crisp_upscale

Upscale an image with a crisp, detail-preserving model

creative_upscale

Upscale an image with a creative, detail-enhancing model

Security

The Recraft API key bills generation usage to your account; keep it in env. Generated images are saved to IMAGE_STORAGE_DIRECTORY (defaults under your home dir), so point it somewhere safe.

Recraft MCP Server (Official) + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Recraft MCP Server (Official) config there under the "mcpServers" key and restart the client.

Is Recraft MCP Server (Official) safe to use with Windsurf?

The Recraft API key bills generation usage to your account; keep it in env. Generated images are saved to IMAGE_STORAGE_DIRECTORY (defaults under your home dir), so point it somewhere safe.

How do I get an API key?

Can it output real vector files?

Yes. generate_image can produce vector output and vectorize_image converts existing rasters into SVG vectors.

What's the easiest way to install it?

Download the .dxt Claude Desktop Extension from the latest GitHub release and double-click it; npx and from-source installs are also documented.

View repo Full Recraft MCP Server (Official) page