Skip to main content
Recraft provides a hosted remote MCP server at https://mcp.recraft.ai/mcp. It supports the Streamable HTTP transport and uses OAuth 2.0 for authentication. The remote server exposes all functionality available through the Recraft API, including image generation, editing, vectorization, upscaling, background removal and replacement, and custom style creation.

​
Billing

The remote MCP server consumes subscription credits from your Recraft plan — the same balance used by the Recraft Studio app. Each operation deducts credits according to the rates in Plans and billing → Credits. Free users receive a daily credit allowance; paid plans include a monthly allowance, with optional top-ups. If you’d rather pay from your API units balance (the pay-as-you-go balance used by the Recraft API), use the Local MCP server instead.

​
Authentication

The remote MCP server uses OAuth 2.0. When you connect for the first time, your MCP client will initiate an OAuth flow and redirect you to Recraft to authorize access. Once authorized, the client stores the token and handles authentication automatically on subsequent requests.

​
Setup by client

​
Claude App

The Recraft MCP server is available as a custom connector in the Claude App (web and desktop). The easiest way to install the connector is to follow this one-click link: Add Recraft to Claude. The link opens the “Add custom connector” modal with the Recraft fields prefilled — review them and click Add. Alternatively, add the connector manually:
  1. Open Settings → Connectors in the Claude App.
  2. Click Add custom connector.
  3. Fill in the fields:
    • Name: Recraft
    • Remote MCP server URL: https://mcp.recraft.ai/mcp
  4. Click Add to save the connector.
The first time you use the connector, Claude will redirect you to Recraft to authorize access via OAuth. Once authorized, the connector stays available across your Claude conversations — enable it from the Search and tools menu in the composer when you want Claude to use Recraft.

​
Claude Code

Run the following command in your terminal: 
claude mcp add --transport http recraft https://mcp.recraft.ai/mcp
Then run /mcp in a session to authenticate via OAuth.
Allow image downloads on Claude Code on the web. Claude Code on the web runs in a managed container with restricted network access, so it may fail to download generated images from Recraft’s image host. To fix this, allowlist the Recraft image host in the environment’s Network access settings:
  1. Open the environment for editing and find the Network access selector in the dialog.
  2. Set the access level to Custom.
  3. In the Allowed domains field, add the Recraft image host (one domain per line): 
    img.recraft.ai
  4. Check Also include default list of common package managers to keep the default trusted domains alongside your custom entry.
Once img.recraft.ai is allowed, Claude Code can download generated images without errors.

​
Claude Desktop

Open your claude_desktop_config.json file and add the following configuration: 
{
  "mcpServers": {
    "recraft": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.recraft.ai/mcp"
      ]
    }
  }
}
On first use, mcp-remote will open a browser window to complete the OAuth flow.

​
Cursor

Open your ~/.cursor/mcp.json file and add the following configuration: 
{
  "mcpServers": {
    "recraft": {
      "url": "https://mcp.recraft.ai/mcp"
    }
  }
}

​
Visual Studio Code

Open your .vscode/mcp.json file (or your user settings) and add: 
{
  "servers": {
    "recraft": {
      "type": "http",
      "url": "https://mcp.recraft.ai/mcp"
    }
  }
}

​
Other MCP clients

Any MCP-compatible client that supports Streamable HTTP transport and OAuth can connect using:
  • URL: https://mcp.recraft.ai/mcp
  • Transport: Streamable HTTP
If your client does not support remote OAuth flows directly and requires a stdio-based command, use mcp-remote: 
npx -y mcp-remote https://mcp.recraft.ai/mcp

​
Supported operations

The remote server supports the full set of image operations available through the Recraft API, including:
  • Generate raster and vector images from text prompts
  • Create image variations and image-to-image transformations
  • Edit selected parts of an image
  • Remove selected objects or regions
  • Remove, replace, or generate backgrounds
  • Convert raster images into vector graphics
  • Upscale images for either sharper or more detailed results
  • Create custom styles from reference images
  • View account details such as your remaining credits