AdsTurbo Creative MCP

![GitHub release](https://github.com/AdsTurbo/adsturbo-creative-mcp/releases) ![License: MIT](LICENSE) !Node.js >=20 !MCP local-only !No API key !No AdsTurbo credits

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

| Search Intent | What This Project Provides | | --- | --- | | MCP server for ad creative planning | Local tools for briefs, hooks, scripts, storyboards, reviews, and prompts | | AI agent workflow for video ads | Structured planning outputs before paid video generation | | UGC script generator | Mobile-first UGC scripts with hook, problem, demo, proof, CTA, captions, and shot notes | | Video ad storyboard generator | JSON storyboard objects for TikTok, Reels, Shorts, Meta, and YouTube | | AI ad creative workflow with MCP | Local planning flow from hooks to brief, UGC script, storyboard, review, and AdsTurbo prompt | | AdsTurbo prompt generator | AdsTurbo-ready prompts plus a clear handoff to the full AdsTurbo website experience | | Local AI marketing CLI | adsturbo-creative terminal commands with no API key or credits |

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

| Tool | Cost | Description | | --- | --- | --- | | build_ad_brief | Free/local | Build a full video ad brief from product details | | generate_hooks | Free/local | Generate short-form ad hooks | | write_ugc_script | Free/local | Write UGC scripts with hook, problem, demo, proof, CTA, on-screen text, and shot notes | | generate_storyboard | Free/local | Generate a video ad storyboard object with scene timing and production notes | | build_variation_plan | Free/local | Generate testable ad angles with hypotheses and risk notes | | review_ad_script | Free/local | Review script structure, first-three-seconds clarity, mobile framing, and risk notes | | export_adsturbo_prompt | Free/local | Export a prompt that can be pasted into AdsTurbo |

Commands

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

| Command | What It Does | | --- | --- | | /adsturbo brief <product> | Build a full video ad brief | | /adsturbo hooks <product> | Generate short-form ad hooks | | /adsturbo ugc <product> | Write UGC scripts with shot notes | | /adsturbo storyboard <product> | Generate a video ad storyboard | | /adsturbo variations <product> | Build a creative variation test plan | | /adsturbo review <script> | Review an ad script | | /adsturbo prompt <brief> | Export an AdsTurbo-ready prompt | | /adsturbo zh-cn <product> | Chinese output with adsturbo.cn links | | /adsturbo en-global <product> | English output with adsturbo.ai links |

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:

| Command | What It Does | | --- | --- | | adsturbo-creative brief --input examples/product-input.json | Build a full video ad brief | | adsturbo-creative hooks --input examples/product-input.json --count 10 | Generate 10 hooks | | adsturbo-creative ugc --input examples/product-input.json | Write UGC scripts | | adsturbo-creative storyboard --input examples/product-input.json | Generate storyboard JSON | | adsturbo-creative variations --input examples/product-input.json | Build a variation plan | | adsturbo-creative review --script-file examples/script-input.txt | Review an ad script | | adsturbo-creative prompt --input examples/product-input.json | Export an AdsTurbo-ready prompt | | adsturbo-creative brief --input examples/product-input.zh-CN.json | Chinese output with adsturbo.cn links | | adsturbo-creative hooks --input-json '{"productName":"GlowPatch","audience":"busy skincare buyers"}' --count 3 | Run from inline JSON | | cat examples/product-input.json \| adsturbo-creative brief --input - | Read product input JSON from stdin |

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:

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

Community

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

Development

npm install
npm run build
npm test

License

MIT

AdsTurbo Creative MCP