# AdsTurbo MCP server

> For AI agents: AdsTurbo is an AI ad-creative platform (ad videos, AI actors, product images). Connect to the remote MCP server at `https://adsturbo.ai/klian/novartapi/mcp` (Streamable HTTP). Authenticate with OAuth 2.1: the user signs in with their AdsTurbo account. Discovery is at `https://adsturbo.ai/.well-known/oauth-protected-resource/klian/novartapi/mcp`, with PKCE, dynamic client registration and client ID metadata documents supported. Clients that can only send headers can use `Authorization: Bearer <AdsTurbo API key>` instead (keys: https://adsturbo.ai/iris/api). Human-readable page: https://adsturbo.ai/mcp

## Connect

Pick the section for the app you are running in. If you cannot change your own MCP settings, show the user these steps.

### Claude Code
Plugin (recommended, includes ad-making skills):
```
/plugin marketplace add AdsTurbo/claude-plugin
/plugin install adsturbo@adsturbo
```
Or the server only:
```
claude mcp add --transport http adsturbo https://adsturbo.ai/klian/novartapi/mcp
```
Then run `/mcp`, select `adsturbo` and choose Authenticate (or run `claude mcp login adsturbo`).

### Codex (CLI, IDE extension, desktop app)
```
codex mcp add adsturbo --url https://adsturbo.ai/klian/novartapi/mcp
codex mcp login adsturbo
```

### VS Code (GitHub Copilot, Agent mode)
```
code --add-mcp '{"name":"adsturbo","type":"http","url":"https://adsturbo.ai/klian/novartapi/mcp"}'
```

### Gemini CLI
```
gemini mcp add --transport http adsturbo https://adsturbo.ai/klian/novartapi/mcp
```

### ChatGPT
Open https://chatgpt.com/plugins/plugin_asdk_app_6aaa085f71148191b80c6220884e13f1, click Install, then Connect and sign in. In a chat, mention `@AdsTurbo`.

### Claude (claude.ai and Claude Desktop)
Open https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=AdsTurbo&connectorUrl=https%3A%2F%2Fadsturbo.ai%2Fklian%2Fnovartapi%2Fmcp, click Add, then Connect and sign in. (Manual path: Customize → Connectors → Add custom connector.) Free plans can add one custom connector. On Team and Enterprise plans, an owner adds it in Organization settings.

### WorkBuddy
Open WorkBuddy, go to the Expert market and start a chat with an AdsTurbo expert (Turbo, Mia, Leo or the AdsTurbo Ad Studio team), or open https://www.workbuddy.cn/share/asset?shareCode=QO66NhoXM0a5BN4LgyRlsn&sig=r3SERdJWSRyg_OoZ directly. Sign in when asked.

### Any other MCP client
```json
{"mcpServers":{"adsturbo":{"type":"http","url":"https://adsturbo.ai/klian/novartapi/mcp"}}}
```
Without OAuth support, send the header `Authorization: Bearer <AdsTurbo API key>`.

## How to use it well

- **Jobs are asynchronous.** Generation tools return a `workspace_id`. Poll `get_work_status` (or `batch_get_work_status` for several jobs) until the status is `completed` or `failed`, then give the user the result URL. Most jobs finish in 1–10 minutes.
- **Inputs are URLs.** Media parameters take public URLs.
  - For a TikTok, Douyin, YouTube, Instagram, Xiaohongshu or WeChat Channels link, call `fetch_video_from_link` first.
  - Agents running on the user's computer can upload local files: call `create_upload_url`, run `curl -F "data=@<file>" <upload_url>`, and pass the returned `data.url` on. This tool is not offered in ChatGPT.
- **Product page → ad:** `create_ad_from_product_url` turns a product page URL into a short ad video.
- **Credits:**
  - Generation spends the user's AdsTurbo credits, at the same prices as the web app. Before submitting several paid jobs at once, confirm the plan with the user.
  - New accounts start with 0 credits. 1080p+ video and 4K images need a subscription, and creating a custom persona needs Pro.
  - If a tool reports insufficient credits or a plan requirement, show the user the link in the error message, or https://adsturbo.ai/pricing.
- **Where results live:** the user's AdsTurbo workspace (https://adsturbo.ai/iris). Nothing is published.

## Tools

| Tool | What it does |
|---|---|
| create_ad_from_product_url | Product page URL → ready-to-post ad video |
| fetch_video_from_link | Import a video from a social platform link |
| ad_clone_analyze | Break down a reference ad (structure, script, shots) |
| ad_clone_generate | Make new versions of a reference ad for your product |
| video_analyze | Shot-by-shot analysis of a video |
| ai_actor_list | Browse AI actors |
| ai_actor_perform | An AI actor (or your own persona) performs a script on video |
| ai_actor_say | AI actor voice-over |
| persona_create, persona_list, persona_delete, get_persona_status | Create and manage your own custom actor |
| video_generate | Text, image, first/last-frame or multi-reference to video |
| video_extend | Extend a video by N seconds |
| video_edit | Edit a video with instructions |
| video_motion_control | Drive a character with motion from a reference video |
| video_character_swap | Replace the person in a video |
| video_lip_sync | Lip-sync a video to new audio |
| video_translate | Translate a video into other languages |
| video_subtitle | Add subtitles |
| video_upscale | Upscale video (up to 4K) |
| video_enhance_v2 | Enhance video quality |
| video_inpaint | Remove watermarks from video |
| video_magic_eraser | Erase objects from video |
| image_create | Generate or edit images |
| image_ecommerce | E-commerce product images |
| image_poster | Promotional posters |
| image_cutout | Remove image background |
| image_enhance | Enhance images |
| image_magic_eraser | Erase objects from images |
| get_work_status, batch_get_work_status | Check job status and get results |
| create_upload_url | Upload a local file (desktop and coding agents only) |

The live list is always `tools/list` on the server; the exact set can differ slightly by app.

## Links

- MCP setup page: https://adsturbo.ai/mcp
- Open API (REST) for building AdsTurbo into your own product: https://adsturbo.ai/open-api · docs: https://doc.adsturbo.ai
- API keys: https://adsturbo.ai/iris/api · Pricing: https://adsturbo.ai/pricing
- MCP Registry: `io.github.AdsTurbo/adsturbo`
- Claude Code plugin: https://github.com/AdsTurbo/claude-plugin · Agent skills: https://github.com/AdsTurbo/skill-adsturbo, https://clawhub.ai/adsturbo
- Site index for AI: https://adsturbo.ai/llms.txt