{
  "markdown": "# AdsTurbo Creative MCP\n\n[![GitHub release](https://img.shields.io/github/v/release/AdsTurbo/adsturbo-creative-mcp?display_name=tag)](https://github.com/AdsTurbo/adsturbo-creative-mcp/releases)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n![Node.js >=20](https://img.shields.io/badge/node-%3E%3D20-339933)\n![MCP local-only](https://img.shields.io/badge/MCP-local--only-6f42c1)\n![No API key](https://img.shields.io/badge/API%20key-not%20required-success)\n![No AdsTurbo credits](https://img.shields.io/badge/AdsTurbo%20credits-not%20used-success)\n\nLocal MCP server for AI video ad planning.\n\n[简体中文](README.zh-CN.md)\n\nAdsTurbo 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.\n\nUse 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.\n\n## Quick Preview\n\n```bash\nnpm install\nnpm run build\nnode dist/cli.js hooks --input examples/product-input.zh-CN.json --count 2 --format markdown\n```\n\n```text\n## AdsTurbo Next Step\n\nRecommended action: Continue video generation in AdsTurbo\nNext: Click \"Continue video generation in AdsTurbo\", then paste adsturboPrompt into the product video workflow...\nTracking: utm_source=adsturbo_creative_mcp, utm_medium=mcp, utm_campaign=creative_handoff\n```\n\n## Search use cases\n\n| Search Intent | What This Project Provides |\n| --- | --- |\n| MCP server for ad creative planning | Local tools for briefs, hooks, scripts, storyboards, reviews, and prompts |\n| AI agent workflow for video ads | Structured planning outputs before paid video generation |\n| UGC script generator | Mobile-first UGC scripts with hook, problem, demo, proof, CTA, captions, and shot notes |\n| Video ad storyboard generator | JSON storyboard objects for TikTok, Reels, Shorts, Meta, and YouTube |\n| AI ad creative workflow with MCP | Local planning flow from hooks to brief, UGC script, storyboard, review, and AdsTurbo prompt |\n| AdsTurbo prompt generator | AdsTurbo-ready prompts plus a clear handoff to the full AdsTurbo website experience |\n| Local AI marketing CLI | `adsturbo-creative` terminal commands with no API key or credits |\n\nIt is a planning layer only:\n\n- No AdsTurbo API key required\n- No video generation\n- No hidden telemetry\n- No calls to AdsTurbo internal services\n- No credit consumption\n- No ad account access\n\nWhen 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.\n\n## Tools\n\n| Tool | Cost | Description |\n| --- | --- | --- |\n| `build_ad_brief` | Free/local | Build a full video ad brief from product details |\n| `generate_hooks` | Free/local | Generate short-form ad hooks |\n| `write_ugc_script` | Free/local | Write UGC scripts with hook, problem, demo, proof, CTA, on-screen text, and shot notes |\n| `generate_storyboard` | Free/local | Generate a video ad storyboard object with scene timing and production notes |\n| `build_variation_plan` | Free/local | Generate testable ad angles with hypotheses and risk notes |\n| `review_ad_script` | Free/local | Review script structure, first-three-seconds clarity, mobile framing, and risk notes |\n| `export_adsturbo_prompt` | Free/local | Export a prompt that can be pasted into AdsTurbo |\n\n## Commands\n\nUse these slash-style commands in Codex, Claude Code, or another agent client after connecting the MCP server:\n\n| Command | What It Does |\n| --- | --- |\n| `/adsturbo brief <product>` | Build a full video ad brief |\n| `/adsturbo hooks <product>` | Generate short-form ad hooks |\n| `/adsturbo ugc <product>` | Write UGC scripts with shot notes |\n| `/adsturbo storyboard <product>` | Generate a video ad storyboard |\n| `/adsturbo variations <product>` | Build a creative variation test plan |\n| `/adsturbo review <script>` | Review an ad script |\n| `/adsturbo prompt <brief>` | Export an AdsTurbo-ready prompt |\n| `/adsturbo zh-cn <product>` | Chinese output with `adsturbo.cn` links |\n| `/adsturbo en-global <product>` | English output with `adsturbo.ai` links |\n\nThese slash-style commands are prompt conventions. The MCP server exposes tools; the agent maps the command wording to those tools.\n\n## CLI\n\nYou can also run the same planning workflows directly from the terminal:\n\n| Command | What It Does |\n| --- | --- |\n| `adsturbo-creative brief --input examples/product-input.json` | Build a full video ad brief |\n| `adsturbo-creative hooks --input examples/product-input.json --count 10` | Generate 10 hooks |\n| `adsturbo-creative ugc --input examples/product-input.json` | Write UGC scripts |\n| `adsturbo-creative storyboard --input examples/product-input.json` | Generate storyboard JSON |\n| `adsturbo-creative variations --input examples/product-input.json` | Build a variation plan |\n| `adsturbo-creative review --script-file examples/script-input.txt` | Review an ad script |\n| `adsturbo-creative prompt --input examples/product-input.json` | Export an AdsTurbo-ready prompt |\n| `adsturbo-creative brief --input examples/product-input.zh-CN.json` | Chinese output with `adsturbo.cn` links |\n| `adsturbo-creative hooks --input-json '{\"productName\":\"GlowPatch\",\"audience\":\"busy skincare buyers\"}' --count 3` | Run from inline JSON |\n| `cat examples/product-input.json \\| adsturbo-creative brief --input -` | Read product input JSON from stdin |\n\nCLI 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.\n\n## Install\n\n```bash\ngit clone https://github.com/AdsTurbo/adsturbo-creative-mcp.git\ncd adsturbo-creative-mcp\nnpm install\nnpm run build\n```\n\nAfter building, run local CLI commands with `node dist/cli.js`:\n\n```bash\nnode dist/cli.js brief --input examples/product-input.zh-CN.json\nnode dist/cli.js review --script-file examples/script-input.zh-CN.txt --locale zh --region cn\n```\n\nInstall from npm to use the shorter CLI binary:\n\n```bash\nnpm install -g adsturbo-creative-mcp\nadsturbo-creative brief --input examples/product-input.json\nadsturbo-creative hooks --input-json '{\"productName\":\"GlowPatch\",\"audience\":\"busy skincare buyers\"}' --count 3\ncat examples/product-input.json | adsturbo-creative brief --input -\n```\n\nWithout global installation, run the CLI binary through npm package execution:\n\n```bash\nnpx -y -p adsturbo-creative-mcp adsturbo-creative hooks --input examples/product-input.json --count 3\n```\n\nThe npm package exposes two binaries:\n\n```text\nadsturbo-creative-mcp  # stdio MCP server\nadsturbo-creative      # terminal CLI\n```\n\n## Use with an MCP client\n\nClaude Desktop, Cursor, Codex, and other MCP-compatible clients can run the built server over stdio.\n\nFor Codex CLI, register the server after `npm run build`:\n\n```bash\ncodex mcp add adsturbo-creative -- node /absolute/path/to/adsturbo-creative-mcp/dist/server.js\ncodex mcp list\n```\n\nRestart 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.\n\n```json\n{\n  \"mcpServers\": {\n    \"adsturbo-creative\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/adsturbo-creative-mcp/dist/server.js\"]\n    }\n  }\n}\n```\n\nMCP clients can also start the server with npx:\n\n```json\n{\n  \"mcpServers\": {\n    \"adsturbo-creative\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"adsturbo-creative-mcp\"]\n    }\n  }\n}\n```\n\nMore setup notes:\n\n- [MCP client setup](docs/mcp-client-setup.md)\n- [MCP client recipes](docs/mcp-client-recipes.md)\n- [Command guide](docs/commands.md)\n- [Use cases and example inputs](docs/use-cases.md)\n- [Developer articles](docs/articles/README.md)\n- [Distribution plan](docs/distribution.md)\n- [Directory submission kit](docs/directory-submission-kit.md)\n\nFor GitHub search and contribution guidance, see [docs/github-discoverability.md](docs/github-discoverability.md).\n\n## Inspect locally\n\n```bash\nnpm run inspect\n```\n\n## Example MCP prompt\n\n```text\nUse adsturbo-creative to build a TikTok video ad brief for:\n\nProduct: GlowPatch Reusable LED Face Mask\nBrand: GlowPatch\nAudience: busy skincare buyers who want a simple at-home routine\nBenefits: hands-free 10 minute sessions, reusable silicone mask, red and blue light modes\nPain points: too many skincare steps, expensive appointments, hard to stay consistent\nProof points: designed for daily at-home use, soft flexible fit, one-button mode switching\nOffer: 15% off this week\nForbidden claims: cures acne, guaranteed results overnight\n```\n\n## Input shape\n\n```json\n{\n  \"productName\": \"GlowPatch Reusable LED Face Mask\",\n  \"brandName\": \"GlowPatch\",\n  \"productUrl\": \"https://example.com/products/glowpatch-led-mask\",\n  \"category\": \"beauty device\",\n  \"audience\": \"busy skincare buyers who want a simple at-home routine\",\n  \"platform\": \"tiktok\",\n  \"durationSeconds\": 30,\n  \"price\": \"$89\",\n  \"benefits\": [\n    \"hands-free 10 minute sessions\",\n    \"reusable silicone mask\",\n    \"red and blue light modes\"\n  ],\n  \"painPoints\": [\n    \"too many skincare steps\",\n    \"expensive appointments\"\n  ],\n  \"proofPoints\": [\n    \"designed for daily at-home use\",\n    \"soft flexible fit\"\n  ],\n  \"offer\": \"15% off this week\",\n  \"tone\": \"friendly UGC demo\",\n  \"primaryCta\": \"Shop the routine\",\n  \"locale\": \"en\",\n  \"websiteRegion\": \"global\",\n  \"requiredShots\": [\n    \"mask close-up on a bathroom counter\",\n    \"creator wearing the mask while making coffee\"\n  ],\n  \"forbiddenClaims\": [\n    \"cures acne\",\n    \"guaranteed results overnight\"\n  ]\n}\n```\n\nThe server does not fetch `productUrl`. It is context only.\n\n## Language and website region\n\nUse `locale` to control the language of MCP output:\n\n- `en`: English output\n- `zh`: Chinese output\n\nUse `websiteRegion` to control AdsTurbo website handoff links returned by tools:\n\n- `global`: use `https://adsturbo.ai`\n- `cn`: use `https://adsturbo.cn`\n\nExamples:\n\n```json\n{\n  \"locale\": \"zh\",\n  \"websiteRegion\": \"cn\"\n}\n```\n\nEvery 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`.\n\n## Example outputs\n\n- [examples/storyboard-output.json](examples/storyboard-output.json)\n- [examples/storyboard-output.zh-CN.json](examples/storyboard-output.zh-CN.json)\n- [examples/ugc-script-review.md](examples/ugc-script-review.md)\n- [examples/product-input.json](examples/product-input.json)\n- [examples/use-cases/](examples/use-cases/)\n\n## Community\n\n- [Contributing](CONTRIBUTING.md)\n- [Security policy](SECURITY.md)\n- [GitHub discoverability](docs/github-discoverability.md)\n- [Distribution plan](docs/distribution.md)\n\n## Cost boundary\n\nThis repository is the planning layer only.\n\nIt does not include:\n\n- `generate_video`\n- `create_adsturbo_project`\n- `submit_storyboard`\n- `ad_clone_generate`\n- `ai_actor_perform`\n- `lip_sync`\n- `video_translate`\n- Any other AdsTurbo paid generation call\n\nIf paid tools are added later, they must require a user-provided API key, show a cost estimate, and never run by default.\n\nFull boundary: [docs/cost-boundary.md](docs/cost-boundary.md)\n\n## Safety and compliance\n\n- Use references for structure, pacing, and inspiration, not to copy protected creative work.\n- Keep claims specific to product information that can be substantiated.\n- Review platform policy and regulated-category requirements before publishing.\n- Do not use this tool to impersonate people or brands without permission.\n- Do not treat generated plans as legal, medical, financial, or platform-policy advice.\n\nFull notes: [docs/safety-and-compliance.md](docs/safety-and-compliance.md)\n\n## Companion projects\n\n- [product-page-to-ad-brief](https://github.com/AdsTurbo/product-page-to-ad-brief)\n- [skill-adsturbo](https://github.com/AdsTurbo/skill-adsturbo)\n- [AdsTurbo Open API](https://adsturbo.ai/open-api)\n- [AdsTurbo China](https://adsturbo.cn)\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnpm test\n```\n\n## License\n\nMIT\n",
  "bytes": 12652,
  "sha": "080a137a3b0076eeb1487b47c3257cff6196d4df2c12edae28b5cc0b41ea2ea0",
  "repo_slug": "adsturbo/adsturbo-creative-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_adsturbo_adsturbo_creative_mcp_9f116d66/readme"
}