AdsTurbo Creative MCP

Local MCP server for AI video ad planning.

Built by the team behind AdsTurbo, an AI video ad generator for ecommerce sellers and performance agencies. This server is local-only: it never calls the AdsTurbo API and never spends credits.

简体中文

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