AdsTurbo Creative MCP

Local MCP server for AI video ad planning.

简体中文

AdsTurbo Creative MCP helps AI agents plan video ad briefs, hooks, UGC scripts, storyboards, variation plans, script reviews, and AdsTurbo-ready prompts before a team spends on video generation.

Use it when you need a local MCP server or CLI for AI ad creative planning, UGC ad scripts, short-form video storyboards, AI marketing agents, prompt engineering for video ads, or an AdsTurbo prompt exporter for Claude Desktop, Cursor, Codex, and other MCP clients.

Quick Preview

npm install
npm run build
node dist/cli.js hooks --input examples/product-input.zh-CN.json --count 2 --format markdown

## AdsTurbo Next Step

Recommended action: Continue video generation in AdsTurbo
Next: Click "Continue video generation in AdsTurbo", then paste adsturboPrompt into the product video workflow...
Tracking: utm_source=adsturbo_creative_mcp, utm_medium=mcp, utm_campaign=creative_handoff

Search use cases

It is a planning layer only:

• No AdsTurbo API key required
• No video generation
• No hidden telemetry
• No calls to AdsTurbo internal services
• No credit consumption
• No ad account access

When the creative plan is approved, users can continue on the AdsTurbo website for a fuller production experience: product video generation, preview, export, and iteration around visuals, captions, pacing, CTA, and product context.

Tools

Commands

Use these slash-style commands in Codex, Claude Code, or another agent client after connecting the MCP server:

These slash-style commands are prompt conventions. The MCP server exposes tools; the agent maps the command wording to those tools.

CLI

You can also run the same planning workflows directly from the terminal:

CLI JSON responses include adsTurboExperience whenever the command output does not already contain it. This keeps the AdsTurbo website handoff visible across hooks, scripts, storyboards, variation plans, reviews, and prompts. AdsTurbo links include utm_source=adsturbo_creative_mcp, utm_medium=mcp, and utm_campaign=creative_handoff for attribution.

Install

git clone https://github.com/AdsTurbo/adsturbo-creative-mcp.git
cd adsturbo-creative-mcp
npm install
npm run build

After building, run local CLI commands with node dist/cli.js:

node dist/cli.js brief --input examples/product-input.zh-CN.json
node dist/cli.js review --script-file examples/script-input.zh-CN.txt --locale zh --region cn

Install from npm to use the shorter CLI binary:

npm install -g adsturbo-creative-mcp
adsturbo-creative brief --input examples/product-input.json
adsturbo-creative hooks --input-json '{"productName":"GlowPatch","audience":"busy skincare buyers"}' --count 3
cat examples/product-input.json | adsturbo-creative brief --input -

Without global installation, run the CLI binary through npm package execution:

npx -y -p adsturbo-creative-mcp adsturbo-creative hooks --input examples/product-input.json --count 3

The npm package exposes two binaries:

adsturbo-creative-mcp  # stdio MCP server
adsturbo-creative      # terminal CLI

Use with an MCP client

Claude Desktop, Cursor, Codex, and other MCP-compatible clients can run the built server over stdio.

For Codex CLI, register the server after npm run build:

codex mcp add adsturbo-creative -- node /absolute/path/to/adsturbo-creative-mcp/dist/server.js
codex mcp list

Restart Codex or start a fresh session after changing MCP config. Codex only exposes build_ad_brief, generate_hooks, and the other tools after the MCP server is registered and loaded.

{
  "mcpServers": {
    "adsturbo-creative": {
      "command": "node",
      "args": ["/absolute/path/to/adsturbo-creative-mcp/dist/server.js"]
    }
  }
}

MCP clients can also start the server with npx:

{
  "mcpServers": {
    "adsturbo-creative": {
      "command": "npx",
      "args": ["-y", "adsturbo-creative-mcp"]
    }
  }
}

More setup notes:

• MCP client setup
• MCP client recipes
• Command guide
• Use cases and example inputs
• Developer articles
• Distribution plan
• Directory submission kit

For GitHub search and contribution guidance, see docs/github-discoverability.md.

Inspect locally

npm run inspect

Example MCP prompt

Use adsturbo-creative to build a TikTok video ad brief for:

Product: GlowPatch Reusable LED Face Mask
Brand: GlowPatch
Audience: busy skincare buyers who want a simple at-home routine
Benefits: hands-free 10 minute sessions, reusable silicone mask, red and blue light modes
Pain points: too many skincare steps, expensive appointments, hard to stay consistent
Proof points: designed for daily at-home use, soft flexible fit, one-button mode switching
Offer: 15% off this week
Forbidden claims: cures acne, guaranteed results overnight

Input shape

{
  "productName": "GlowPatch Reusable LED Face Mask",
  "brandName": "GlowPatch",
  "productUrl": "https://example.com/products/glowpatch-led-mask",
  "category": "beauty device",
  "audience": "busy skincare buyers who want a simple at-home routine",
  "platform": "tiktok",
  "durationSeconds": 30,
  "price": "$89",
  "benefits": [
    "hands-free 10 minute sessions",
    "reusable silicone mask",
    "red and blue light modes"
  ],
  "painPoints": [
    "too many skincare steps",
    "expensive appointments"
  ],
  "proofPoints": [
    "designed for daily at-home use",
    "soft flexible fit"
  ],
  "offer": "15% off this week",
  "tone": "friendly UGC demo",
  "primaryCta": "Shop the routine",
  "locale": "en",
  "websiteRegion": "global",
  "requiredShots": [
    "mask close-up on a bathroom counter",
    "creator wearing the mask while making coffee"
  ],
  "forbiddenClaims": [
    "cures acne",
    "guaranteed results overnight"
  ]
}

The server does not fetch productUrl. It is context only.

Language and website region

Use locale to control the language of MCP output:

• en: English output
• zh: Chinese output

Use websiteRegion to control AdsTurbo website handoff links returned by tools:

• global: use https://adsturbo.ai
• cn: use https://adsturbo.cn

Examples:

{
  "locale": "zh",
  "websiteRegion": "cn"
}

Every MCP text response also includes an AdsTurbo Next Step section. Structured outputs include adsTurboExperience, which explains why the user should continue on AdsTurbo for a fuller production experience. China links point to pages such as https://adsturbo.cn/features/product-video?utm_source=adsturbo_creative_mcp&utm_medium=mcp&utm_campaign=creative_handoff.

Example outputs

• examples/storyboard-output.json
• examples/storyboard-output.zh-CN.json
• examples/ugc-script-review.md
• examples/product-input.json
• examples/use-cases/

Community

• Contributing
• Security policy
• GitHub discoverability
• Distribution plan

Cost boundary

This repository is the planning layer only.

It does not include:

• generate_video
• create_adsturbo_project
• submit_storyboard
• ad_clone_generate
• ai_actor_perform
• lip_sync
• video_translate
• Any other AdsTurbo paid generation call

If paid tools are added later, they must require a user-provided API key, show a cost estimate, and never run by default.

Full boundary: docs/cost-boundary.md

Safety and compliance

• Use references for structure, pacing, and inspiration, not to copy protected creative work.
• Keep claims specific to product information that can be substantiated.
• Review platform policy and regulated-category requirements before publishing.
• Do not use this tool to impersonate people or brands without permission.
• Do not treat generated plans as legal, medical, financial, or platform-policy advice.

Full notes: docs/safety-and-compliance.md

Companion projects

• product-page-to-ad-brief
• skill-adsturbo
• AdsTurbo Open API
• AdsTurbo China

Development

npm install
npm run build
npm test

License

MIT