# KreadoAI AI Ad Creative MCP

Connect any MCP-compatible AI agent to KreadoAI image generation and ad creative workflows. Generate marketing images, ecommerce creatives, and multi-size advertising assets directly inside Cursor, Claude, Dify, Coze, and AI workflow systems.

KreadoAI MCP enables AI agents to access AI image generation and ad creative tools using your existing KreadoAI Pro account and API Token.

There’s no need to build complex API workflows manually. Your AI agent can generate images, poll task status, retrieve assets, and automate creative production tasks conversationally.

## Documentation Index

Fetch the complete documentation index at:

```
https://www.kreadoai.com/docs/mcp/llms.txt
```

Use this file to discover all available MCP pages and supported tools.

## Endpoint

```
https://api.kreadoai.com/mcp/agentart/v1/mcp
```

## Supported Products

KreadoAI MCP works with any MCP-compatible AI agent, including:

* Cursor
* Claude
* Claude Code
* Gemini CLI
* Dify
* Coze
* OpenAI Agents
* Manus
* Custom MCP-compatible workflow systems

## Authentication

KreadoAI MCP uses API Token authentication.

You must:

1. Sign in to your KreadoAI account
2. Subscribe to KreadoAI Pro
3. Generate an API Token
4. Add the token to your MCP configuration

All MCP usage consumes your existing KreadoAI credits and quotas.

No additional MCP billing is required.

## Connect Your AI Agent

Add the KreadoAI MCP endpoint to your AI agent configuration.

Example Cursor configuration:

```
{  "mcpServers": {    "aigc-agent-art": {      "url": "https://api.kreadoai.com/mcp/agentart/v1/mcp",      "headers": {        "apiToken": "YOUR_API_TOKEN"      }    }  }}
```

## How It Works

### Connect

Add the KreadoAI MCP endpoint to your AI agent or workflow system.

### Authenticate

Authenticate using your KreadoAI Pro API Token.

### Generate

Your AI agent can generate:

* marketing images
* ecommerce creatives
* product visuals
* multi-size ad creatives

through natural language conversations.

### Retrieve

Agents can automatically:

* poll generation status
* retrieve image assets
* download files
* continue workflows

## What You Can Do

Once connected, your AI agent has access to the following tools:

## Account

| Tool Name            | Description                                                                                                                                                                                                            |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_my_user_detail` | Retrieve current user account details including email, membership level, remaining K-coins, quotas, and registration source. Authentication depends on current session context. Querying other users is not supported. |

## AI Image Generation

| Tool Name                  | Description                                                                                                                                                                                                    |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `submit_ai_image_task`     | Generate AI marketing images, ecommerce creatives, ad banners, product images, and brand visuals. Supports text-to-image and image-to-image workflows. Compatible with GPT Image, Gemini, and Seedream models. |
| `get_ai_image_task_detail` | Retrieve image generation task status and output details including generated image URLs, prompts, status, and model source.                                                                                    |
| `resubmit_ai_image_task`   | Re-run a previous image generation task using original parameters. Useful for retries or additional variations.                                                                                                |

## Multi-Size Ad Creative Generation

| Tool Name                               | Description                                                                                                                                                |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `submit_ai_ad_creative_batch_image`     | Generate multiple advertising creative sizes from uploaded product images. Supports TikTok, Meta, Google, Facebook, Xiaohongshu, and ecommerce ad formats. |
| `get_ai_ad_creative_batch_image_detail` | Retrieve batch creative generation results including task status, output URLs, thumbnail URLs, dimensions, and model source information.                   |

## AI Image Generation Workflow

KreadoAI MCP supports complete AI creative generation workflows for AI agents and automation systems.

## Step 1 — Submit Image Generation Task

Use:

```
submit_ai_image_task
```

Required parameters:

| Parameter      | Description                                   |
| -------------- | --------------------------------------------- |
| `userPrompt`   | Image generation prompt                       |
| `quantity`     | Number of images                              |
| `taskType`     | `1` = image generation, `2` = character image |
| `width`        | Image width                                   |
| `height`       | Image height                                  |
| `sizeRatio`    | Aspect ratio                                  |
| `dpi`          | Image DPI                                     |
| `modelsSource` | AI model source                               |

Optional parameters:

* `isFilter`
* `webSearch`
* `seed`
* `thinkingLevel`

## Image-to-Image Input Rules

Supported file sources:

| fileSource | Required Field | Description                     |
| ---------- | -------------- | ------------------------------- |
| `1`        | `fileId`       | Existing uploaded platform file |
| `2`        | `fileUrl`      | Public image URL                |
| `3`        | `fileUrl`      | Base64 encoded image            |

Notes:

* Local `file://` paths are not supported
* Base64 images should be compressed before upload
* Use original filenames where possible

## Step 2 — Poll Task Status

Use:

```
get_ai_image_task_detail
```

Task status values:

| Status | Meaning    |
| ------ | ---------- |
| `1`    | Waiting    |
| `2`    | Processing |
| `3`    | Success    |
| `4`    | Failed     |

Polling recommendation:

* Poll every 2–5 seconds
* Stop after 30 minutes timeout

## Step 3 — Retrieve Assets

Successful tasks return:

* generated image URLs
* thumbnails
* prompts
* model source information

Agents can automatically:

* download generated assets
* continue workflows
* save outputs locally

## Multi-Size Ad Creative Workflow

Use:

```
submit_ai_ad_creative_batch_image
```

to automatically generate:

* TikTok creatives
* Meta ads
* Facebook banners
* Xiaohongshu visuals
* Google display ads

from a single product image.

Supported layout modes:

* Original Layout
* AI Smart Layout
* Custom Layout

## Cursor Skills Workflow Example

KreadoAI MCP can also be combined with Cursor Skills and workflow automation systems.

Example workflow:

```
name: aigc-image-task-downloaddescription: >  Uses MCP server user-aigc-agent-art tools submit_ai_image_task and  get_ai_image_task_detail to submit an AI image job, poll until completion,  and download produced files locally.
```

## Example Prompt

### Ecommerce Creative Generation

```
Generate 5 TikTok ad creatives for this ecommerce product.
```

### Multi-Size Ad Creative

```
Create Meta, TikTok, and Instagram versions of this product ad.
```

### AI Workflow Automation

```
Generate marketing images and automatically download all generated assets.
```

## Billing

KreadoAI MCP uses your existing:

* KreadoAI Pro subscription
* API Token
* K-coins
* image generation quotas

There are no additional MCP platform fees.

## Remote MCP

| Feature        | KreadoAI MCP                               |
| -------------- | ------------------------------------------ |
| Setup          | Add MCP endpoint + API Token               |
| Runs On        | KreadoAI hosted infrastructure             |
| Authentication | API Token                                  |
| Billing        | Existing Pro plan + credits                |
| Best For       | AI creative workflows and agent automation |

## FAQ

### Do I need an API key?

Yes. KreadoAI MCP currently uses API Token authentication tied to your KreadoAI Pro account.

### Does MCP cost extra?

No. MCP usage consumes your existing KreadoAI credits and quotas.

### Which plans support MCP?

MCP is available for KreadoAI Pro users.

### Can I generate multi-size ad creatives?

Yes. KreadoAI MCP supports automatic multi-size advertising creative generation.

### Which AI clients are supported?

KreadoAI MCP supports:

* Cursor
* Claude
* Gemini CLI
* Dify
* Coze
* OpenAI Agents
* custom MCP-compatible systems

### What’s the difference between MCP and API?

KreadoAI API provides direct REST API integration for developers.

KreadoAI MCP enables AI agents and workflow systems to use those capabilities conversationally through MCP-compatible tools.

### Build AI creative workflows with KreadoAI MCP

Generate marketing images, ecommerce creatives, and multi-size ad assets directly inside AI agents and workflow systems. Get Started with KreadoAI MCP.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kreadoai.gitbook.io/developers/kreadoai-mcp/mcp-types/kreadoai-ai-ad-creative-mcp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.