Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Recraft AI MCP connector

OAuth 2.1/DCRDesignAI

Connect to Recraft AI MCP. Generate AI-powered images, vectors, icons, and mockups from your AI agents using Recraft's creative design tools.

Recraft AI MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'recraftmcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Recraft AI MCP:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'recraftmcp_get_user',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Image vectorize, variate, inpaint — Convert a raster image to a vector format
  • Model suggest — Suggest the best Recraft image generation model for a given user request
  • Plans subscription — List available Recraft subscription plans with their credits, refill periods, and pricing
  • Url request upload — Issue an upload URL for a direct image upload
  • Background replace, remove, generate — Replace the background of an image based on a text prompt
  • List styles — List all custom styles created by the current user

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

recraftmcp_create_style#Create a custom style from one or more reference images. Provide images via URLs or base64-encoded data. The style parameter defines the base style type.6 params

Create a custom style from one or more reference images. Provide images via URLs or base64-encoded data. The style parameter defines the base style type.

NameTypeRequiredDescription
input_image_typestringrequiredVisual image type for the style
input_style_images_b64arrayoptionalBase64-encoded reference images (1–5). Mutually exclusive with input_style_images_urls.
input_style_images_urlsarrayoptionalPublicly accessible HTTPS URLs of reference images (1–5). Mutually exclusive with input_style_images_b64.
modelstringoptionalModel version. Default: recraftv4_1.
privatebooleanoptionalWhether the style is private.
style_promptstringoptionalOptional text prompt to refine style (1–1000 chars).
recraftmcp_creative_upscale#Upscale an image using creative AI enhancement. Returns the upscaled image as a URL and a WEBP preview.1 param

Upscale an image using creative AI enhancement. Returns the upscaled image as a URL and a WEBP preview.

NameTypeRequiredDescription
input_image_urlstringrequiredPublicly accessible HTTPS URL of the input image (PNG/JPEG/WEBP). Use request_upload_url first for local files.
recraftmcp_crisp_upscale#Upscale an image with sharp, crisp quality enhancement. Returns the upscaled image as a URL and a WEBP preview.1 param

Upscale an image with sharp, crisp quality enhancement. Returns the upscaled image as a URL and a WEBP preview.

NameTypeRequiredDescription
input_image_urlstringrequiredPublicly accessible HTTPS URL of the input image (PNG/JPEG/WEBP). Use request_upload_url first for local files.
recraftmcp_delete_style#Delete a custom style by its ID.1 param

Delete a custom style by its ID.

NameTypeRequiredDescription
input_style_idstringrequiredID of the style to delete.
recraftmcp_erase_region#Erase a masked region from an image, filling it with content-aware background. Returns the processed image as a URL and a WEBP preview.2 params

Erase a masked region from an image, filling it with content-aware background. Returns the processed image as a URL and a WEBP preview.

NameTypeRequiredDescription
input_image_urlstringrequiredPublicly accessible HTTPS URL of the source image (PNG/JPEG/WEBP).
mask_image_urlstringrequiredPublicly accessible HTTPS URL of the mask image. White areas will be erased.
recraftmcp_generate_background#Generate a background for a masked region of an image based on a text prompt. Returns the processed image as a URL and a WEBP preview.7 params

Generate a background for a masked region of an image based on a text prompt. Returns the processed image as a URL and a WEBP preview.

NameTypeRequiredDescription
input_image_urlstringrequiredPublicly accessible HTTPS URL of the source image (PNG/JPEG/WEBP).
mask_image_urlstringrequiredPublicly accessible HTTPS URL of the mask image. White areas define the background region.
promptstringrequiredText prompt for the background (1–10000 chars).
input_stylestringoptionalVisual style. Mutually exclusive with input_style_id.
input_style_idstringoptionalStyle ID to apply. Mutually exclusive with input_style.
modelstringoptionalModel version.
nintegeroptionalNumber of images to generate (1–6). Default: 1.
recraftmcp_generate_image#Generate an image from a text prompt. Returns image URLs and WEBP previews.6 params

Generate an image from a text prompt. Returns image URLs and WEBP previews.

NameTypeRequiredDescription
promptstringrequiredText prompt (1–10000 chars).
image_sizestringoptionalImage dimensions or aspect ratio. Default: 1:1.
input_stylestringoptionalVisual style. Mutually exclusive with input_style_id.
input_style_idstringoptionalStyle ID. Mutually exclusive with input_style.
modelstringoptionalModel version. Default: recraftv4_1.
nintegeroptionalNumber of images (1–6). Default: 1.
recraftmcp_get_style#Get details of a specific style by its ID.1 param

Get details of a specific style by its ID.

NameTypeRequiredDescription
style_idstringrequiredUUID of the style (e.g. '550e8400-e29b-41d4-a716-446655440000').
recraftmcp_get_user#Get information about the current user including ID, email, name, and credit balance.0 params

Get information about the current user including ID, email, name, and credit balance.

recraftmcp_image_to_image#Transform an existing image based on a text prompt. The strength parameter controls how much the output differs from the input.8 params

Transform an existing image based on a text prompt. The strength parameter controls how much the output differs from the input.

NameTypeRequiredDescription
input_image_urlstringrequiredPublicly accessible HTTPS URL of the input image (PNG/JPEG/WEBP).
promptstringrequiredText prompt for the transformation (1–10000 chars).
image_sizestringoptionalOutput image dimensions.
input_stylestringoptionalVisual style. Mutually exclusive with input_style_id.
input_style_idstringoptionalStyle ID. Mutually exclusive with input_style.
modelstringoptionalModel version.
nintegeroptionalNumber of images (1–6).
strengthnumberoptionalTransformation strength (0=identical, 1=fully transformed). Default: 0.6.
recraftmcp_inpaint_image#Fill in a masked region of an image based on a text prompt. Returns the processed image as a URL and a WEBP preview.7 params

Fill in a masked region of an image based on a text prompt. Returns the processed image as a URL and a WEBP preview.

NameTypeRequiredDescription
input_image_urlstringrequiredPublicly accessible HTTPS URL of the source image (PNG/JPEG/WEBP).
mask_image_urlstringrequiredPublicly accessible HTTPS URL of the mask image. White areas define the inpainting region.
promptstringrequiredText prompt describing what to paint in the masked region (1–10000 chars).
input_stylestringoptionalVisual style. Mutually exclusive with input_style_id.
input_style_idstringoptionalStyle ID. Mutually exclusive with input_style.
modelstringoptionalModel version to use for generation.
nintegeroptionalNumber of images to generate (1–6).
recraftmcp_list_styles#List all custom styles created by the current user.0 params

List all custom styles created by the current user.

recraftmcp_remove_background#Remove the background from an image. Returns the result as a URL and a WEBP preview.1 param

Remove the background from an image. Returns the result as a URL and a WEBP preview.

NameTypeRequiredDescription
input_image_urlstringrequiredPublicly accessible HTTPS URL of the image (PNG/JPEG/WEBP).
recraftmcp_replace_background#Replace the background of an image based on a text prompt. Returns the processed image as a URL and a WEBP preview.6 params

Replace the background of an image based on a text prompt. Returns the processed image as a URL and a WEBP preview.

NameTypeRequiredDescription
input_image_urlstringrequiredPublicly accessible HTTPS URL of the source image (PNG/JPEG/WEBP).
promptstringrequiredText prompt describing the new background (1–10000 chars).
input_stylestringoptionalVisual style. Mutually exclusive with input_style_id.
input_style_idstringoptionalStyle ID. Mutually exclusive with input_style.
modelstringoptionalModel version to use for generation.
nintegeroptionalNumber of images to generate (1–6).
recraftmcp_request_upload_url#Issue an upload URL for a direct image upload. Use this when you have a local image file and need a publicly accessible URL. PUT the image bytes to the returned upload URL, then use the resulting image_url in other tools.0 params

Issue an upload URL for a direct image upload. Use this when you have a local image file and need a publicly accessible URL. PUT the image bytes to the returned upload URL, then use the resulting image_url in other tools.

recraftmcp_subscription_plans#List available Recraft subscription plans with their credits, refill periods, and pricing.0 params

List available Recraft subscription plans with their credits, refill periods, and pricing.

recraftmcp_suggest_model#Suggest the best Recraft image generation model for a given user request.1 param

Suggest the best Recraft image generation model for a given user request.

NameTypeRequiredDescription
promptstringrequiredThe user's image generation request to evaluate.
recraftmcp_variate_image#Generate variations of an existing image. Returns image URLs and WEBP previews.6 params

Generate variations of an existing image. Returns image URLs and WEBP previews.

NameTypeRequiredDescription
input_image_urlstringrequiredPublicly accessible HTTPS URL of the source image (PNG/JPEG/WEBP).
image_sizestringoptionalOutput image size as aspect ratio.
input_stylestringoptionalVisual style. Mutually exclusive with input_style_id.
input_style_idstringoptionalStyle ID. Mutually exclusive with input_style.
modelstringoptionalModel version to use for generation.
nintegeroptionalNumber of variations to generate (1–6).
recraftmcp_vectorize_image#Convert a raster image to a vector format. Returns the vector image as a URL.1 param

Convert a raster image to a vector format. Returns the vector image as a URL.

NameTypeRequiredDescription
input_image_urlstringrequiredPublicly accessible HTTPS URL of the raster image (PNG/JPEG/WEBP).