Recraft MCP server
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.
Available tools
| Tool | Description |
|---|---|
| generate_image | Generate raster or vector images from a text prompt, optionally applying a chosen style. |
| image_to_image | Generate raster or vector images from an input image plus a prompt, transforming the source. |
| create_style | Create a reusable style from a list of reference images so later generations stay on-brand. |
| vectorize_image | Convert a raster image into clean scalable vector (SVG) output. |
| remove_background | Remove the background from an image, leaving a transparent cutout. |
| replace_background | Generate a new background for an image from a text prompt. |
| crisp_upscale | Upscale an image with a crisp, detail-preserving enhancement. |
| creative_upscale | Upscale an image with a creative enhancement that adds plausible detail. |
| get_user | Get 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.