Recraft MCP Server – AI Image and Vector Design
Recraft's official MCP servers give AI agents access to image generation and editing tools for both raster and vector workflows. Use Recraft MCP for design asset creation, image transformations, background work, vector conversion, upscaling, and reusable custom styles.
Overview
Recraft provides official remote and local MCP servers for image generation and editing. Both expose Recraft's creative tools through a standardized interface so AI agents can create and transform raster and vector assets without requiring users to switch between the chat client and Recraft Studio.
What the MCP server enables
Recraft documents MCP tools for:
- Generating raster or vector images from text prompts.
- Creating custom styles from reference images.
- Converting raster artwork into vector graphics.
- Producing image-to-image variations and transformations.
- Removing image backgrounds.
- Replacing or generating backgrounds from prompts.
- Upscaling images while either preserving content or regenerating detail.
- Retrieving account information and remaining balance.
The supported model parameter covers Recraft V2, V3, V4, and V4.1 model families where applicable. Vector models return SVG output, while raster models return formats such as PNG, WebP, or JPG. Style compatibility varies by model generation.
When to use it
Use Recraft MCP when an AI-assisted design workflow needs production-ready raster or vector visuals. Typical uses include illustrations, icons, branded assets, social graphics, campaign concepts, product imagery, vector conversion, background cleanup, creative upscaling, and generating multiple visual variants from a shared prompt or custom style.
The remote server is best for fast setup and workflows that use Recraft subscription credits. The local server is useful when generated files should be saved locally or when billing should use Recraft API units.
Connection and authentication
The hosted server uses Streamable HTTP at https://mcp.recraft.ai/mcp and authenticates with OAuth 2.0. On first connection, the MCP client redirects the user to Recraft to authorize access.
Recraft also provides an official local stdio server through:
npx -y @recraft-ai/mcp-recraft-server@latest
The local server requires RECRAFT_API_KEY. It can optionally use IMAGE_STORAGE_DIRECTORY for local output or RECRAFT_REMOTE_RESULTS_STORAGE=1 to return remotely stored results.
Key considerations
The remote and local servers use different balances. Remote calls consume Recraft subscription credits, while the local server consumes separately purchased API units. Some image operations may take several minutes, especially large generations or upscales. Model and style compatibility must be checked before reuse, and custom styles are tied to the model and base style used during creation. Store API keys securely and review generated assets for licensing, brand, privacy, accessibility, and quality before publication.
Supported Transports
streamable_http
URL: https://mcp.recraft.ai/mcp
stdio
Command: npx
Args:
-y@recraft-ai/mcp-recraft-server@latest
Frequently Asked Questions
- When should an AI agent use the Recraft MCP server?
- Use it when a workflow needs raster or vector image generation, image-to-image transformation, background removal or replacement, vectorization, upscaling, custom styles, or reusable visual asset creation.
- What does the Recraft MCP server add to an AI agent's capabilities?
- It gives the agent structured access to Recraft's live creative tools, allowing it to generate, edit, transform, upscale, vectorize, and style images instead of only describing how those operations should be performed.
- What can an AI agent access or manage through Recraft MCP?
- The agent can generate raster and vector images, create custom styles, transform images, remove or replace backgrounds, vectorize raster artwork, perform crisp or creative upscaling, and retrieve user balance information.
- How is authentication configured for the Recraft MCP server?
- The hosted server uses OAuth 2.0 with an interactive Recraft authorization flow. The local stdio server requires a Recraft API key in RECRAFT_API_KEY and uses API units rather than subscription credits.
- Which transport should be used for the Recraft MCP server?
- Use Streamable HTTP with https://mcp.recraft.ai/mcp for Recraft's hosted OAuth service. Use stdio with @recraft-ai/mcp-recraft-server when local file storage, custom environments, or API-unit billing is preferred.