io.github.AdsTurbo/adsturbo-creative-mcp

Official

by AdsTurbo · TypeScript

AdsTurbo Creative MCP

Local-only MCP server and CLI for AI video ad briefs, UGC scripts, storyboards, and prompts.

Creates AI video ad briefs, UGC scripts, storyboards, and creative prompts locally.

Topics

ad-creativeadsturbomarketing-agentsmcpmodel-context-protocolstoryboardugc-adsvideo-adsai-agentsai-marketingclicreative-automationmcp-servernodejsprompt-engineeringstoryboard-generatortypescriptvideo-marketingad-briefugc-scripts

README.md12 KBView on GitHub

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

bash

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

text

## 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

bash

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:

bash

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:

bash

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:

bash

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

The npm package exposes two binaries:

text

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:

bash

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.

json

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

MCP clients can also start the server with npx:

json

{
  "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

bash

npm run inspect

Example MCP prompt

text

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

json

{
  "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:

json

{
  "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

bash

npm install
npm run build
npm test

License

MIT

Install

claude_desktop_config.json

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