v0.1.4 - MCP Registry Metadata

v0.1.4 - MCP Registry Metadata

This release prepares AdsTurbo Creative MCP for official MCP Registry distribution.

What's New

• Adds mcpName to package.json for npm package ownership verification.
• Adds root server.json using the official MCP Registry server metadata format.
• Includes server.json in the npm package.
• Updates MCP server metadata version to 0.1.4.
• Adds distribution documentation for MCP Registry, MCP.Directory, Glama, Smithery, and community directories.

Registry Name

io.github.adsturbo/adsturbo-creative-mcp

Package

adsturbo-creative-mcp@0.1.4

Cost Boundary

The project remains local-only:

• no AdsTurbo API key required
• no video generation
• no hidden telemetry
• no AdsTurbo API calls
• no AdsTurbo credit consumption
• no ad account access

v0.1.3 - Community and Client Recipes

v0.1.3 - Community and Client Recipes

This release improves GitHub and npm discoverability, onboarding, and community health for AdsTurbo Creative MCP.

What's New

• Adds GitHub community files:
  • security policy
  • pull request template
  • bug report template
  • feature request template
  • MCP client setup issue template
• Adds multilingual docs:
  • command guide
  • MCP client recipes
  • use case index
  • Chinese contributing guide
  • Chinese security policy
• Adds runnable example inputs under examples/use-cases/:
  • beauty device UGC ad
  • ecommerce kitchen gadget demo
  • mobile app screen-recording ad
  • B2B SaaS walkthrough ad
  • Chinese beauty device ad with China website handoff
• Updates npm keywords for more MCP client discovery:
  • claude-code
  • vscode
  • windsurf

Verification

• npm test
• git diff --check
• JSON parse check for all examples/use-cases/*.json
• CLI check using examples/use-cases/zh-beauty-led-mask.json

Cost Boundary

The project remains local-only. It does not call AdsTurbo APIs, generate video, consume AdsTurbo credits, access ad accounts, or send user inputs to hosted AdsTurbo services.

v0.1.2 - npm Binary Fix

v0.1.2 - npm Binary Fix

This release fixes npm-installed CLI execution.

Fixes

• Fixes the adsturbo-creative CLI entrypoint when npm runs it through a bin symlink.
• Adds smoke test coverage for symlink-based CLI execution.
• Normalizes npm bin paths to avoid npm publish auto-correction warnings.
• Normalizes the repository URL format used in the published npm manifest.
• Updates the MCP server metadata version to 0.1.2.

Verification

• npm test
• npm pack --dry-run
• npm exec --package=adsturbo-creative-mcp@0.1.2 -- adsturbo-creative --help
• npm exec --package=adsturbo-creative-mcp@0.1.2 -- adsturbo-creative hooks --input-json '{"productName":"GlowPatch","audience":"busy skincare buyers"}' --count 1

Cost Boundary

This release remains local-only and does not call AdsTurbo APIs, consume AdsTurbo credits, generate videos, or access ad accounts.

v0.1.0 - Local Creative Planning MCP

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

• MCP client setup
• Cost boundary
• Safety and compliance
• GitHub discoverability