AdsTurbo Creative

GitHub release License: MIT

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:

• 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