Skip to content

v0.1.0 - Local Creative Planning MCP

Choose a tag to compare

View all tags
@mimimile mimimile released this 23 Jun 09:32
· 11 commits to main since this release
v0.1.0
0e9d490

v0.1.0 - Local Creative Planning MCP

First public release of AdsTurbo Creative MCP.

What It Does

  • Runs a local-only MCP server for AI video ad planning.
  • Provides a CLI: adsturbo-creative.
  • Builds video ad briefs, hooks, UGC scripts, storyboards, variation plans, script reviews, and AdsTurbo-ready prompts.
  • Supports English and Chinese output.
  • Supports global and cn AdsTurbo website regions.
  • Adds a consistent AdsTurbo website handoff to every MCP and CLI output.
  • Adds UTM attribution to AdsTurbo handoff URLs:
    • utm_source=adsturbo_creative_mcp
    • utm_medium=mcp
    • utm_campaign=creative_handoff

MCP Tools

  • build_ad_brief
  • generate_hooks
  • write_ugc_script
  • generate_storyboard
  • build_variation_plan
  • review_ad_script
  • export_adsturbo_prompt

Cost Boundary

This release does not:

  • require an AdsTurbo API key
  • generate video
  • call AdsTurbo APIs
  • call AdsTurbo internal services
  • consume AdsTurbo credits
  • access ad accounts
  • send user input to hosted AdsTurbo services

The intended workflow is:

  1. Plan locally with the MCP server or CLI.
  2. Review the brief, script, storyboard, claims, and compliance notes.
  3. Continue in AdsTurbo for product video generation, preview, export, and production iteration.

Quick Start

git clone https://github.com/AdsTurbo/adsturbo-creative-mcp.git
cd adsturbo-creative-mcp
npm install
npm run build
node dist/cli.js brief --input examples/product-input.zh-CN.json --format markdown

Codex Setup

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.

Example Slash-Style Prompts

/adsturbo brief <product>
/adsturbo hooks <product>
/adsturbo ugc <product>
/adsturbo storyboard <product>
/adsturbo variations <product>
/adsturbo review <script>
/adsturbo prompt <brief>

These are prompt conventions for agent clients. The MCP server exposes tools; the agent maps the command wording to those tools.

Documentation

Assets 2
Loading