Note: This is an unofficial, community-maintained project and is not affiliated with or endorsed by Recraft.
16 tools for image generation, processing, and style management — all accessible through the Model Context Protocol.
- Generate — Text-to-image, image-to-image, inpainting, background replacement & generation
- Process — Background removal, region erasing, vectorization (SVG), crisp & creative upscaling
- Styles — Create custom styles from reference images, list/get/delete styles
- Account — Check remaining credits and user info (included in
stylestoolset) - Configurable — Filter toolsets, adjust cache TTL, control retries
Prerequisites
- Node.js 20+ (or Docker)
- A Recraft API token
Installation
Claude Desktop
Add to your config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"recraft": {
"command": "npx",
"args": ["-y", "recraft-mcp"],
"env": {
"RECRAFT_API_TOKEN": "your-api-token"
}
}
}
}
VS Code
Add to .vscode/mcp.json in your workspace (or use the one-click install buttons above):
{
"servers": {
"recraft": {
"command": "npx",
"args": ["-y", "recraft-mcp"],
"env": {
"RECRAFT_API_TOKEN": "your-api-token"
}
}
}
}
Claude Code
claude mcp add recraft-mcp -e RECRAFT_API_TOKEN=your-api-token -- npx -y recraft-mcp
Cursor
Add to Cursor's MCP settings (~/.cursor/mcp.json):
{
"mcpServers": {
"recraft": {
"command": "npx",
"args": ["-y", "recraft-mcp"],
"env": {
"RECRAFT_API_TOKEN": "your-api-token"
}
}
}
}
Windsurf
Add to Windsurf's MCP config (~/.codeium/windsurf/mcp_config.json):
{
"mcpServers": {
"recraft": {
"command": "npx",
"args": ["-y", "recraft-mcp"],
"env": {
"RECRAFT_API_TOKEN": "your-api-token"
}
}
}
}
Docker
docker run --rm -i -e RECRAFT_API_TOKEN="your-api-token" ghcr.io/bartwaardenburg/recraft-mcp-server:latest
Use Docker in any MCP client by replacing the command:
{
"mcpServers": {
"recraft": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "RECRAFT_API_TOKEN=your-api-token",
"ghcr.io/bartwaardenburg/recraft-mcp-server:latest"
]
}
}
}
Smithery
npx -y @smithery/cli install recraft-mcp --client claude
Tools
Generation
Processing
Styles & Account
Tool Annotations
All tools include MCP tool annotations to help clients understand their behavior:
generate_image
image_to_image
inpaint_image
replace_background
generate_background
remove_background
erase_region
vectorize_image
crisp_upscale
creative_upscale
create_style
get_style
delete_style
list_styles, list_basic_styles, get_current_user
No parameters required.
Configuration
Toolset Filtering
Reduce the number of tools exposed to the LLM by enabling only what you need:
# Only image generation
RECRAFT_TOOLSETS=generation
# Generation + processing, no style management
RECRAFT_TOOLSETS=generation,processing
Supported Models
Note: V4 models do not support the
styleparameter — use the prompt to control style.
Supported Styles
Image Input
Tools that accept images (image_to_image, inpaint_image, remove_background, etc.) support:
- URL — Any publicly accessible HTTP(S) URL
- Base64 — Raw base64-encoded image data
Security
- API token — Your
RECRAFT_API_TOKENis sent only to the Recraft API (https://external.api.recraft.ai). It is never logged or stored beyond the process lifetime. - Image data — Images are sent to Recraft's servers for processing. No image data is cached on disk.
- Network access — This server makes outbound HTTPS requests to
external.api.recraft.aiandregistry.npmjs.org(for update checks).
See SECURITY.md for reporting vulnerabilities.
Development
pnpm install # Install dependencies
pnpm dev # Run with tsx (hot reload)
pnpm build # Compile TypeScript
pnpm test # Run tests
pnpm typecheck # Type check
See CONTRIBUTING.md for guidelines.