# Recraft MCP ```json { "name": "Recraft MCP", "slug": "recraft_mcp", "url": "https://composio.dev/toolkits/recraft_mcp", "markdown_url": "https://composio.dev/toolkits/recraft_mcp.md", "logo_url": "https://logos.composio.dev/api/recraft_mcp", "categories": [ "design & creative tools" ], "is_composio_managed": false, "updated_at": "2026-10-22T05:32:12.794Z" } ``` ![Recraft MCP logo](https://logos.composio.dev/api/recraft_mcp) ## Description Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Recraft MCP or direct API to generate visual assets, edit images, manage custom styles, and inspect account information through natural language. ## Summary 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. ## Categories - design & creative tools ## Toolkit Details - Tools: 22 ## Images - Logo: https://logos.composio.dev/api/recraft_mcp ## Authentication - **Dcr Oauth** - Type: `custom` - Description: Dcr Oauth authentication for Recraft MCP. - Setup: - Configure Dcr Oauth credentials for Recraft MCP. - Use the credentials when creating an auth config in Composio. ## Suggested Prompts - Generate a product illustration in my custom style - Edit this image into a poster design - Inspect my Recraft account usage details ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `RECRAFT_MCP_CALL_AGENT` | Call agent | Talk to Recraft's Design Agent in a chat. This is not just any agent — it is The Design Agent, and its superpower is turning a brief — a plain description of a digital product — into a strong, consistent and genuinely amazing set of design assets. Building a coherent look normally means juggling separate tools — one for the logo, another for icons, another for social assets — and without a designer to hold it together the result feels like five apps that have never met. The Design Agent does it all at once: describe the product and it produces a full, consistent set of design assets — a logo, a colour palette, typography, an app icon and social assets among them — and can save them as a reusable Design Kit so every asset pulled from it later stays consistent. It is built for digital products: apps, websites and similar projects. Reach for it whenever the user needs a whole coherent look rather than a single one-off image. This is a two-way, turn-based conversation, not a one-shot request: you send a text message (optionally with input images) and receive the agent's combined reply, which may include images the agent generates. The agent often drives the exchange itself — instead of a final result it may reply with a clarifying question or a set of choices (for example confirming it should proceed, asking for visual references or a preferred direction, or asking which option to develop). When it does, relay that reply to the end user verbatim, collect their answer, and send it back in a follow-up call — do not answer on the user's behalf or skip ahead. A single task can take several turns before the agent produces its final design assets. Omit chat_id to start a new conversation; the response contains the chat_id — pass it in every subsequent call to continue the same conversation with full context. Images flow both ways. To send images to the agent, provide input_image_urls, a list of publicly accessible HTTP or HTTPS URLs (PNG, JPEG, WEBP or SVG); if you only have local image files, call request_upload_url first, PUT the image bytes to the returned upload URL, and pass the resulting image_url values here. Any images the agent generates come back in the response. The response contains the agent's text answer, the chat_id, URLs of any generated images with WEBP previews as base64 encoded bytes, and the credits this call used. | | `RECRAFT_MCP_CREATE_STYLE` | Create style | Create a custom style from one or more reference images. Provide images via URLs or base64-encoded data. The `input_style` parameter defines the base style type. The style is saved to the user's Recraft account, so it is also available in the Recraft app. Returns the new style ID, which you can pass as `input_style_id` to the generation tools. Creating a style is free. | | `RECRAFT_MCP_CREATIVE_UPSCALE` | 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. Larger inputs are rejected before generation or billing. Upscale an image using creative AI enhancement. Provide a publicly accessible HTTP or HTTPS URL as `input_image_url`. If you only have a local image file with no public URL, call `request_upload_url` first, PUT the image bytes to the returned upload URL, and pass the resulting `image_url` here. Returns the processed image as a URL and a preview in WEBP format as a base64 encoded bytes. | | `RECRAFT_MCP_CRISP_UPSCALE` | 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. Upscale an image with sharp, crisp quality enhancement. Provide a publicly accessible HTTP or HTTPS URL as `input_image_url`. If you only have a local image file with no public URL, call `request_upload_url` first, PUT the image bytes to the returned upload URL, and pass the resulting `image_url` here. Returns the processed image as a URL and a preview in WEBP format as a base64 encoded bytes. | | `RECRAFT_MCP_DELETE_STYLE` | Delete style | Delete a custom style by its `style_id`. This cannot be undone. | | `RECRAFT_MCP_ERASE_REGION` | Erase region | Erase a masked region from an image, filling it with content-aware background. Provide the source image as `input_image_url` and a mask image as `mask_image_url`, both publicly accessible HTTP or HTTPS URLs. If you only have local image files with no public URLs, call `request_upload_url` for each, PUT the image bytes to each returned upload URL, and pass the resulting `image_url` values here. Returns the processed image as a URL and a preview in WEBP format as a base64 encoded bytes. | | `RECRAFT_MCP_GENERATE_BACKGROUND` | Generate background | Generate a background for a masked region of an image based on a text prompt. Provide the source image as `input_image_url` and a mask image as `mask_image_url`, both publicly accessible HTTP or HTTPS URLs. If you only have local image files with no public URLs, call `request_upload_url` for each, PUT the image bytes to each returned upload URL, and pass the resulting `image_url` values here. Returns an image_urls array and previews in WEBP format as a base64 encoded bytes. | | `RECRAFT_MCP_GENERATE_IMAGE` | Generate image | Generate an image from a text prompt. You can specify the image size, style, model, and number of images to generate. You don't need to change default parameters if you don't have any specific requirements. Recraft has both raster and vector models. Recraft models come in a `_raster` and a `_vector` variant: a raster model (e.g. recraftv4_1_raster) produces a raster image (PNG/WEBP), while a vector model (e.g. recraftv4_1_vector) produces a true SVG vector file. Whenever the user asks for a vector, an SVG, a scalable logo, or an icon, pass the `_vector` variant of the model — that is the reliable way to get an SVG. Use the `_raster` variant for photos and raster artwork. recraftv4_1_flash_raster has no vector variant. See the `model` parameter for the full list of variants. Besides Recraft models, this tool supports external models such as nano_banana_2, nano_banana_pro, gpt_image_2_medium or bytedance_seedreamv5_pro (see the `model` parameter for the full list); availability depends on your subscription and is validated server-side. External models produce raster images only: they have no `_vector` variants, cannot generate SVG, and do not support custom styles. Recraft also has a large library of built-in "basic styles" beyond the default models. Call the `list_basic_styles` tool to explore the full variety of available styles, then apply a chosen one via its `input_style_id`. To apply a basic or custom style, pass its `input_style_id` (see list_basic_styles, list_styles and create_style) and omit `input_style`: the image type is taken from the style. URLs to generated images, their previews in WEBP format as base64 encoded bytes and the credits the call used will be returned in the response. | | `RECRAFT_MCP_GET_STYLE` | Get style | Get details of a specific style by its `style_id`: its name, type, model and privacy. | | `RECRAFT_MCP_GET_USER` | Get user | Get information about the current user (ID, email, name, and the remaining credits balance on the account). | | `RECRAFT_MCP_IMAGE_EDIT` | Image edit | Edit one or more input images according to a text prompt, producing new image(s). Use this tool for instruction-driven editing: describe the change you want (for example "add a hat", "make it winter", "replace the text with SALE", or "combine these images") and the model rewrites the image to follow the prompt. It can take several input images at once and can use external models. Choose image_edit when you want the model to follow explicit editing instructions or to use an external model; choose image_to_image instead when you want a strength-controlled stylistic transformation of a single image rather than a specific edit. Provide the source images as `input_image_urls` — a list of publicly accessible HTTP or HTTPS URLs (PNG, JPEG, WEBP or SVG). If you only have local image files with no public URL, call `request_upload_url` for each, PUT the image bytes to the returned upload URL, and pass the resulting `image_url` values here. You can specify the image size, model, and number of images to generate. You don't need to change default parameters if you don't have any specific requirements. This tool works only with external models; Recraft models are not supported for instruction-driven editing. External models produce raster images only: they cannot generate SVG and do not support custom styles. The default model is nano_banana_2; others include nano_banana_pro, nano_banana_2p1, gpt_image_2_medium, gpt_image_2p5_flare and bytedance_seedreamv5_pro (see the `model` parameter for the full list). Availability depends on your subscription and is validated server-side. If the image size is not specified, the output size follows the first input image. URLs to the edited images, their previews in WEBP format as base64 encoded bytes and the credits the call used will be returned in the response. | | `RECRAFT_MCP_IMAGE_TO_IMAGE` | Image to image | Transform an existing image based on a text prompt. The strength parameter controls how much the image is transformed (0.0 to 1.0). Provide a publicly accessible HTTP or HTTPS URL as `input_image_url`. Use this tool for a strength-controlled stylistic transformation of a single image, where the prompt and style reshape the whole image and `strength` sets how far the result moves from the original. For instruction-driven edits (changing or adding specific elements, editing several images together, or using an external model such as nano_banana_pro or flux1_kontext_pro), use the image_edit tool instead. If you only have a local image file with no public URL, call `request_upload_url` first, PUT the image bytes to the returned upload URL, and pass the resulting `image_url` here. Returns an image_urls array and previews in WEBP format as a base64 encoded bytes. | | `RECRAFT_MCP_INPAINT_IMAGE` | Inpaint image | Fill in a masked region of an image based on a text prompt. Provide the source image as `input_image_url` and a mask image as `mask_image_url`, both publicly accessible HTTP or HTTPS URLs. If you only have local image files with no public URLs, call `request_upload_url` for each, PUT the image bytes to each returned upload URL, and pass the resulting `image_url` values here. Returns an image_urls array and previews in WEBP format as a base64 encoded bytes. | | `RECRAFT_MCP_LIST_BASIC_STYLES` | List basic styles | Lists the built-in styles configured in this environment; coverage differs by model. The returned model is a compatible generation identifier. Passing input_style_id can select an older model instead of the default v4.1. List Recraft's library of built-in "basic styles" — a large, curated collection of visual styles for image generation that goes well beyond the default models. Call this to explore the full variety of available styles and pick the one that best matches the user's request. Returns a list of styles, each with a `style_name`, its `input_style_id`, its type and the model it belongs to. Apply a chosen style by passing its `input_style_id` to the generation tools (generate_image, image_to_image, etc.); omit `model` to use the style's own model. | | `RECRAFT_MCP_LIST_STYLES` | List styles | List all custom styles created by the current user. Returns a list of style IDs with their names, types (the image type generations with the style produce), models and privacy. Pass a style ID as `input_style_id` to the generation tools. | | `RECRAFT_MCP_REMOVE_BACKGROUND` | Remove background | Remove the background from an image. Provide a publicly accessible HTTP or HTTPS URL as `input_image_url`. If you only have a local image file with no public URL, call `request_upload_url` first, PUT the image bytes to the returned upload URL, and pass the resulting `image_url` here. Returns the processed image with background removed as a URL and a preview in WEBP format as a base64 encoded bytes. | | `RECRAFT_MCP_REPLACE_BACKGROUND` | Replace background | Replace the background of an image based on a text prompt. Provide a publicly accessible HTTP or HTTPS URL as `input_image_url`. If you only have a local image file with no public URL, call `request_upload_url` first, PUT the image bytes to the returned upload URL, and pass the resulting `image_url` here. Returns an image_urls array and previews in WEBP format as a base64 encoded bytes. | | `RECRAFT_MCP_REQUEST_UPLOAD_URL` | Request upload url | Issue an upload URL for a direct image upload. Use this when the user provides a local image file (or raw image data) that has no public URL of its own. If the user already provided a public HTTPS image URL, pass that URL directly to the image tools instead — do NOT route it through this step. This tool takes no parameters and returns an `upload_url` plus a ready-to-run `curl` command. PUT the raw image bytes directly to `upload_url` (no base64, no encoding) with a `Content-Type` header matching the image MIME type (image/png, image/jpeg or image/webp), e.g.: curl -X PUT -H 'Content-Type: image/png' --data-binary @image.png '' The PUT response is JSON containing `image_url`. Use that `image_url` as `input_image_url` (or `mask_image_url`) when calling any image tool such as image_to_image, remove_background, inpaint_image, etc. The link is reusable for up to 15 minutes while session authorization remains valid; request a new link after a 401 response. | | `RECRAFT_MCP_SUBSCRIPTION_PLANS` | Subscription plans | List available Recraft subscription plans with their plan IDs, credits granted per refill period, and prices. | | `RECRAFT_MCP_SUGGEST_MODEL` | Suggest model | Suggest a supported image generation or instruction-editing model for a given user request. Returns JSON with model_suggestion (an exact supported model identifier) and reason. Covers Recraft generation and external instruction-editing models. Chooses a Recraft `_vector` model for SVG output and an image_edit model for instruction editing; honors an explicitly requested supported model. | | `RECRAFT_MCP_VARIATE_IMAGE` | Variate image | Generate variations of an existing image. Set the required image_size parameter to an output aspect ratio. Provide a publicly accessible HTTP or HTTPS URL as `input_image_url`. If you only have a local image file with no public URL, call `request_upload_url` first, PUT the image bytes to the returned upload URL, and pass the resulting `image_url` here. Returns an image_urls array and previews in WEBP format as a base64 encoded bytes. | | `RECRAFT_MCP_VECTORIZE_IMAGE` | Vectorize image | Convert a raster image to a vector format. Provide a publicly accessible HTTP or HTTPS URL as `input_image_url`. If you only have a local image file with no public URL, call `request_upload_url` first, PUT the image bytes to the returned upload URL, and pass the resulting `image_url` here. Returns the processed image as a URL and a preview in WEBP format as a base64 encoded bytes. | ## Supported Triggers None listed. ## Installation and MCP Setup ### Path 1: SDK Installation #### Path 1, Step 1: Install Composio Install the Composio SDK, the OpenAI provider, and the OpenAI SDK ```python pip install composio composio_openai openai ``` ```typescript npm install @composio/core @composio/openai openai ``` #### Path 1, Step 2: Create a Composio session Initialize Composio with the OpenAI Responses provider and create a session scoped to Recraft MCP ```python import json from openai import OpenAI from composio import Composio from composio_openai import OpenAIResponsesProvider composio = Composio(provider=OpenAIResponsesProvider()) client = OpenAI() session = composio.create(user_id="your-user-id", toolkits=["recraft_mcp"]) tools = session.tools() ``` ```typescript import OpenAI from "openai"; import { Composio } from "@composio/core"; import { OpenAIResponsesProvider } from "@composio/openai"; const composio = new Composio({ provider: new OpenAIResponsesProvider() }); const client = new OpenAI(); const session = await composio.create("your-user-id", { toolkits: ["recraft_mcp"] }); const tools = await session.tools(); ``` #### Path 1, Step 3: Run Recraft MCP tools with your agent Send a request, execute the Recraft MCP tool calls through the session, and print the final answer ```python response = client.responses.create( model="gpt-5.6-sol", tools=tools, input=[{"role": "user", "content": "Generate a flat vector illustration of a red fox sitting in a snowy pine forest, using a clean editorial style."}], ) while True: tool_calls = [o for o in response.output if o.type == "function_call"] if not tool_calls: break results = composio.provider.handle_tool_calls(response=response, session=session) response = client.responses.create( model="gpt-5.6-sol", tools=tools, previous_response_id=response.id, input=[ {"type": "function_call_output", "call_id": call.call_id, "output": json.dumps(results[i])} for i, call in enumerate(tool_calls) ], ) print(response.output_text) ``` ```typescript let response = await client.responses.create({ model: "gpt-5.6-sol", tools, input: [{ role: "user", content: "Generate a flat vector illustration of a red fox sitting in a snowy pine forest, using a clean editorial style." }], }); while (response.output.some((o) => o.type === "function_call")) { const outputs = await composio.provider.handleToolCalls(session, response.output); response = await client.responses.create({ model: "gpt-5.6-sol", tools, previous_response_id: response.id, input: outputs, }); } console.log(response.output_text); ``` ### Path 2: MCP Server Setup #### Path 2, Step 1: Install Composio Install the Composio SDK and your agent framework ```python pip install composio claude-agent-sdk ``` ```typescript npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai ``` #### Path 2, Step 2: Create a session with MCP enabled Create a session scoped to Recraft MCP and read its MCP URL and headers ```python from composio import Composio composio = Composio() session = composio.create(user_id="your-user-id", toolkits=["recraft_mcp"], mcp=True) ``` ```typescript import { Composio } from "@composio/core"; const composio = new Composio(); const { mcp } = await composio.create("your-user-id", { toolkits: ["recraft_mcp"], mcp: true, }); ``` #### Path 2, Step 3: Connect your agent to the MCP server Pass the session's MCP URL and headers to your agent and run a Recraft MCP request ```python import asyncio from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, AssistantMessage, TextBlock options = ClaudeAgentOptions( mcp_servers={ "composio": { "type": "http", "url": session.mcp.url, "headers": session.mcp.headers, } }, system_prompt="You are a helpful assistant with access to Recraft MCP tools.", tools=[], allowed_tools=["mcp__composio__*"], ) async def main(): async with ClaudeSDKClient(options=options) as client: await client.query("Generate a flat vector illustration of a red fox sitting in a snowy pine forest, using a clean editorial style.") async for message in client.receive_response(): if isinstance(message, AssistantMessage): for block in message.content: if isinstance(block, TextBlock): print(block.text) asyncio.run(main()) ``` ```typescript import { createMCPClient } from "@ai-sdk/mcp"; import { openai } from "@ai-sdk/openai"; import { generateText, stepCountIs } from "ai"; const client = await createMCPClient({ transport: { type: "http", url: mcp.url, headers: mcp.headers }, }); const { text } = await generateText({ model: openai("gpt-5.6-sol"), tools: await client.tools(), prompt: "Generate a flat vector illustration of a red fox sitting in a snowy pine forest, using a clean editorial style.", stopWhen: stepCountIs(10), }); console.log(text); await client.close(); ``` ## Why Use Composio? ### 1. AI Native Recraft MCP Integration - Supports Recraft MCP and direct API based integrations - Structured, LLM-friendly schemas for reliable image generation and editing - Rich coverage for visual assets, custom styles, and account information ### 2. Managed Auth - Built-in support for connecting to Recraft’s provider-hosted MCP server - Central place to manage, scope, and revoke Recraft MCP access - Per user and per environment credentials instead of hard-coded secrets ### 3. Agent Optimized Design - Tools are tuned using real error and success rates to improve visual workflow reliability - Comprehensive execution logs so you always know what ran, when, and on whose behalf ### 4. Enterprise Grade Security - Fine-grained RBAC so you control which agents and users can access Recraft MCP - Scoped, least privilege access to Recraft visual generation and editing resources - Full audit trail of agent actions to support review and compliance ## Use Recraft MCP with any AI Agent Framework Choose a framework you want to connect Recraft MCP with: - [ChatGPT](https://composio.dev/toolkits/recraft_mcp/framework/chatgpt) - [Claude Cowork](https://composio.dev/toolkits/recraft_mcp/framework/claude-cowork) - [Hermes](https://composio.dev/toolkits/recraft_mcp/framework/hermes-agent) - [Atomic Agent](https://composio.dev/toolkits/recraft_mcp/framework/atomic-agent) ## Related Toolkits - [Figma](https://composio.dev/toolkits/figma) - Figma is a collaborative interface design tool for teams and individuals. It streamlines design workflows with real-time collaboration and easy sharing. - [Abyssale](https://composio.dev/toolkits/abyssale) - Abyssale is a creative automation platform for generating images, videos, GIFs, PDFs, and HTML5 content programmatically. It streamlines and scales visual content production for marketing, design, and operations teams. - [Alttext ai](https://composio.dev/toolkits/alttext_ai) - AltText.ai is a service that generates alt text for images automatically. It helps boost accessibility and SEO for your visual content. - [Are.na](https://composio.dev/toolkits/arena) - Are.na is a creative research platform for collecting images, links, notes, and ideas in channels. Use it to organize inspiration, build knowledge maps, and connect research across projects. - [Bannerbear](https://composio.dev/toolkits/bannerbear) - Bannerbear is an API-driven platform for generating images and videos automatically at scale. It helps businesses create custom graphics, social visuals, and marketing assets using powerful templates. - [Bannerbite](https://composio.dev/toolkits/bannerbite) - Bannerbite is a creative automation platform for generating images and videos from reusable projects and templates. It helps teams produce on-brand visual assets faster without rebuilding designs from scratch. - [BeatAPI](https://composio.dev/toolkits/beatapi) - BeatAPI is an asynchronous API platform for AI image, video, and music workflows. It enables scalable generation, video analysis, uploads, and ecommerce video pipelines. - [Builder.io](https://composio.dev/toolkits/builder_io) - Builder.io is a visual development platform for managing content, models, assets, and Space configuration. Use it to ship editable digital experiences faster without waiting on every code change. - [Canva](https://composio.dev/toolkits/canva) - Canva is a drag-and-drop design suite for creating professional graphics, presentations, and marketing materials. It makes it easy for anyone to design with beautiful templates and a vast library of elements. - [Canva MCP](https://composio.dev/toolkits/canva_mcp) - Canva MCP is Canva's remote MCP server for accessing designs and content. It centralizes design assets and enables programmatic design workflows. - [Claid ai](https://composio.dev/toolkits/claid_ai) - Claid.ai delivers AI-driven image editing APIs for tasks like background removal, upscaling, and color correction. It helps automate and enhance image workflows with powerful, developer-friendly tools. - [Cloudinary](https://composio.dev/toolkits/cloudinary) - Cloudinary is a cloud-based platform for managing, uploading, and transforming images and videos. It streamlines media workflows and delivers optimized assets globally. - [Contentdrips](https://composio.dev/toolkits/contentdrips) - Contentdrips is an asynchronous rendering API for branded graphics and carousels. It turns reusable templates into on-brand social visuals at scale. - [Creatomate](https://composio.dev/toolkits/creatomate) - Creatomate is an API for generating automated videos, images, GIFs, and reusable media templates. Use it to turn structured data into polished visual content at scale. - [Cults](https://composio.dev/toolkits/cults) - Cults is a digital marketplace for 3D printing models, connecting designers and makers. It lets creators share, sell, and discover a huge variety of printable designs easily. - [DeepImage](https://composio.dev/toolkits/deepimage) - DeepImage is an AI-powered image enhancer and upscaler. Get higher-quality images with just a few clicks. - [Dreamstudio](https://composio.dev/toolkits/dreamstudio) - DreamStudio is Stability AI’s platform for generating and editing images with AI. It lets you easily turn ideas into stunning visuals, fast. - [Dribbble](https://composio.dev/toolkits/dribbble) - Dribbble is a design community and publishing platform for managing shots, projects, and attachments. Use it to showcase work, collect feedback, and organize creative designs. - [Dynamic Mockups](https://composio.dev/toolkits/dynamic_mockups) - Dynamic Mockups is an API platform for generating product mockups, rendering templates, and managing visual asset catalogs. Use it to automate high-quality product visuals, AI images, and motion assets at scale. - [Dynapictures](https://composio.dev/toolkits/dynapictures) - Dynapictures is a cloud-based platform for generating personalized images at scale. Instantly create hundreds of custom visuals using your data sources, like Google Sheets. ## Frequently Asked Questions ### Do I need my own developer credentials to use Recraft MCP with Composio? Yes, Recraft MCP requires you to configure your own Dcr OAuth credentials. Once set up, Composio handles secure credential storage and management for you. ### Can I use multiple toolkits together? Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview). ### Is Composio secure? Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev). ### What if the API changes? Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)