SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Recraft MCP with Atomic Agent

Connect Atomic Agent to Recraft MCP. Generate a product illustration in your custom style, edit this image into a poster design, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Recraft MCP logoRecraft MCP
Dcr Oauth

Recraft MCP is a provider-hosted visual creation service for generating and editing images. It gives teams managed access to Recraft’s image tools, custom styles, and account details.

22 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Recraft.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Recraft account. See the Atomic Agent documentation for installation instructions.

Also integrate Recraft MCP with

ChatGPTClaude CoworkHermes

How Atomic Agent connects to Recraft

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Recraft to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Recraft. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Recraft account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Recraft MCP server, and what's possible with it?

The Recraft MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Recraft account. It provides structured and secure access to Recraft's image generation, editing, upscaling, vectorization, style management, and account tools, so your agent can create visual assets, modify images, apply custom styles, and check your Recraft usage on your behalf.

  • Image generation and variations: Have your agent generate images from text prompts, create variations of existing images, transform images with image-to-image instructions, and choose a suitable model for a request.
  • Image editing and background work: Let the agent edit images from prompts, inpaint or erase selected regions, remove or replace backgrounds, and generate new backgrounds for masked areas.
  • Image enhancement and vectorization: Direct your agent to use creative or crisp upscaling for supported images, or convert raster artwork into a vector format.
  • Custom visual styles: Instruct your agent to create styles from reference images, list available custom or built-in styles, inspect a style's details, or delete a custom style.
  • Account and plan information: Have your agent check your Recraft profile and remaining credits, or review available subscription plans and their credit allowances.

Use Recraft from Atomic Agent

With your account connected, ask Atomic Agent to work with Recraft in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Recraft MCP action and event your agent gets out of the box.

Call agent

Talk to Recraft's Design Agent in a chat.

Create style

Create a custom style from one or more reference images.

Creative upscale

Input must have at most 4194304 pixels (4 MP), sides from 256 to 4096 pixels, and at most 48 MiB of raster data.

Crisp upscale

Input must have at most 4194304 pixels (4 MP), sides from 32 to 4096 pixels, and at most 48 MiB of raster data.

Delete style

Delete a custom style by its `style_id`.

Erase region

Erase a masked region from an image, filling it with content-aware background.

Generate background

Generate a background for a masked region of an image based on a text prompt.

Generate image

Generate an image from a text prompt.

Get style

Get details of a specific style by its `style_id`: its name, type, model and privacy.

Get user

Get information about the current user (ID, email, name, and the remaining credits balance on the account).

Image edit

Edit one or more input images according to a text prompt, producing new image(s).

Image to image

Transform an existing image based on a text prompt.

Inpaint image

Fill in a masked region of an image based on a text prompt.

List basic styles

Lists the built-in styles configured in this environment; coverage differs by model.

List styles

List all custom styles created by the current user.

Remove background

Remove the background from an image.

Replace background

Replace the background of an image based on a text prompt.

Request upload url

Issue an upload URL for a direct image upload.

Subscription plans

List available Recraft subscription plans with their plan IDs, credits granted per refill period, and prices.

Suggest model

Suggest a supported image generation or instruction-editing model for a given user request.

Variate image

Generate variations of an existing image.

Vectorize image

Convert a raster image to a vector format.

FRAMEWORKS

How to build Recraft MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Recraft MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use Recraft MCP with Claude Cowork

Hermes logo

Hermes

Use Recraft MCP with Hermes

FAQ

Frequently asked questions

With a standalone Recraft MCP server, the agents and LLMs can only access a fixed set of Recraft tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Recraft and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Recraft tools.

Yes, absolutely. You can configure which Recraft scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Recraft data and credentials are handled as safely as possible.

Start with Recraft MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Recraft MCP tool your agent needs.Free to start.

Start building