{
  "markdown": "# StarReel MCP\n\n> Turn a script into a finished, downloadable short-drama episode — from Claude, Cursor, or any MCP client.\n\n[![npm version](https://img.shields.io/npm/v/%40starreel%2Fmcp)](https://www.npmjs.com/package/@starreel/mcp)\n[![npm downloads](https://img.shields.io/npm/dm/%40starreel%2Fmcp)](https://www.npmjs.com/package/@starreel/mcp)\n[![license](https://img.shields.io/badge/license-MIT-blue)](./LICENSE)\n[![node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)\n\n**StarReel** is a prepaid AI video-production pipeline. This MCP server exposes the\nwhole factory — **80+ tools** covering every stage — so an AI agent can take a raw\nscript all the way to a finished `.mp4`:\n\n```\nscript → AI rewrite → cast / scenes / props extraction → character portraits & sheets\n       → storyboards → keyframes → video shots → voiceover (TTS) → final cut (.mp4 link)\n```\n\nIt is a thin, open client: all the heavy lifting (character-consistency gates,\nframe chaining, best-of-N auditing, billing) runs server-side at\n[starreel.ai](https://starreel.ai).\n\n## Quick start\n\n[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=starreel&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBzdGFycmVlbC9tY3AiXSwiZW52Ijp7IlNUQVJSRUVMX0FQSV9LRVkiOiJzcmtfbGl2ZV94eHgifX0=)\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_MCP-0098FF)](https://vscode.dev/redirect/mcp/install?name=starreel&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40starreel%2Fmcp%22%5D%2C%22env%22%3A%7B%22STARREEL_API_KEY%22%3A%22srk_live_xxx%22%7D%7D)\n\n1. Create an API key with `produce` scope in **StarReel → Settings → API Keys**\n   (`srk_live_...`, shown once).\n2. Add the server to Claude Code:\n\n```bash\nclaude mcp add starreel -e STARREEL_API_KEY=srk_live_xxx -- npx -y @starreel/mcp\n```\n\nOr install the **Claude Code plugin** — MCP server + agent skill in one step\n(set `STARREEL_API_KEY` in your shell first):\n\n```text\n/plugin marketplace add waydaxp/starreel-mcp\n/plugin install starreel@starreel\n```\n\n3. Ask your agent: *\"Take this script and produce a full episode: `<your script>`\"* —\n   it will quote each paid stage first and only spend after you confirm.\n\n## Works with any MCP client\n\nRequires Node ≥ 18 (`npx`). The **standard config** below works as-is in\n**Cursor · Windsurf · Cline / Roo Code · Claude Desktop · Trae · Cherry Studio ·\nChatbox · DeepChat** and any client that reads an `mcpServers` JSON block:\n\n```json\n{\n  \"mcpServers\": {\n    \"starreel\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@starreel/mcp\"],\n      \"env\": { \"STARREEL_API_KEY\": \"srk_live_xxx\" }\n    }\n  }\n}\n```\n\nClients with their own format:\n\n<details>\n<summary><b>Codex CLI</b> — <code>~/.codex/config.toml</code></summary>\n\n```toml\n[mcp_servers.starreel]\ncommand = \"npx\"\nargs = [\"-y\", \"@starreel/mcp\"]\nenv = { \"STARREEL_API_KEY\" = \"srk_live_xxx\" }\n```\n</details>\n\n<details>\n<summary><b>VS Code (Copilot agent mode)</b> — <code>.vscode/mcp.json</code> or user <code>mcp.json</code></summary>\n\n```json\n{\n  \"servers\": {\n    \"starreel\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@starreel/mcp\"],\n      \"env\": { \"STARREEL_API_KEY\": \"srk_live_xxx\" }\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><b>Gemini CLI</b> — <code>~/.gemini/settings.json</code></summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"starreel\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@starreel/mcp\"],\n      \"env\": { \"STARREEL_API_KEY\": \"srk_live_xxx\" }\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><b>No Node / can't run npx?</b> (Coze, Dify, GPTs, custom agents)</summary>\n\nDrive the same pipeline over REST (`/v1/produce/*`) and paste\n[`SKILL.md`](./SKILL.md) into your system prompt — it carries the full\nworkflow order, billing disciplines, and failure playbook.\nSee the [API docs](https://api.shortreelai.com/docs/mcp).\n</details>\n\n## What's inside\n\n| Stage | Tools (selection) |\n|---|---|\n| Project setup | `create_drama` · `update_project_settings` · `list_project_options` |\n| Script | `set_script` · AI rewrite · `edit_rewritten_script` |\n| Cast & world | asset extraction · `update_character` · `generate_world_concept` · `generate_art_bible` |\n| Identity anchors | `generate_portraits_and_sheets` (portraits + character sheets = the consistency anchor) |\n| Storyboards | `quote_storyboards` → `generate_storyboards` → `get_storyboards` |\n| Frames & video | `quote_frames` → `generate_frames` · `quote_videos` → `generate_videos` |\n| Audio | `generate_tts` · `generate_bgm` · `generate_sfx` · voice management |\n| Finishing | `compose_episode` (free) · `get_final_cut` · `render_multi_aspect` · posters & covers |\n| Localization | `translate_subtitles` · localization jobs |\n| Ads / MV modes | product library & product sheets · MV lyrics → story → script |\n\nProject types: `drama` / `ad` / `mv` / `brand_film`.\n\n## Billing is agent-safe by design\n\n- **Prepaid, never negative.** Costs are pre-authorized *before* any vendor call;\n  insufficient balance returns a clean `402` — nothing half-runs.\n- **Quote before spend.** Big-ticket stages are `quote_*` → show the user →\n  `generate_*` with the returned `quote_id`. For video, **quote == actual charge**\n  (same function computes both).\n- **Final cut is free.** Composition, transitions, SFX matching and deliverable\n  packaging don't bill.\n- API keys are stored hashed and exchanged for 15-minute short-lived tokens;\n  revoke in Settings at any time.\n\n## Built for agents: the operating skill\n\n[`SKILL.md`](./SKILL.md) ships inside the package — a platform-agnostic operating\nmanual (full pipeline order + ten operating disciplines + a failure playbook).\nSkill-aware clients load it automatically; on platforms that can't run `npx`\n(Coze / Dify / GPTs / custom agents) paste it into the system prompt and drive\nthe same pipeline over REST (`/v1/produce/*`).\n\nInstall it as a standalone agent skill (Claude Code, Codex, Cursor, OpenCode\nand [70+ agents](https://github.com/vercel-labs/skills#supported-agents)) via\nthe [`skills`](https://skills.sh) CLI:\n\n```bash\nnpx skills add waydaxp/starreel-mcp\n```\n\n## Environment variables\n\n| Variable | Required | Default |\n|---|---|---|\n| `STARREEL_API_KEY` | ✅ | — |\n| `STARREEL_AUTH_BASE` | | `https://api.shortreelai.com` |\n\n## REST API (OpenAPI)\n\nPrefer plain REST? The full production facade is described in\n[`openapi.json`](./openapi.json) (OpenAPI 3.1, 100+ operations — generated from\nthis package's tool surface, so `operationId`s match MCP tool names 1:1).\nBrowse it rendered at\n[waydaxp.github.io/starreel-mcp](https://waydaxp.github.io/starreel-mcp/), or\ngenerate a typed client for any language:\n\n```bash\nnpx openapi-typescript https://raw.githubusercontent.com/waydaxp/starreel-mcp/main/openapi.json -o starreel.d.ts\n```\n\n## Links\n\n- Website: [starreel.ai](https://starreel.ai)\n- API reference (OpenAPI): [waydaxp.github.io/starreel-mcp](https://waydaxp.github.io/starreel-mcp/)\n- Full MCP / REST docs: [api.shortreelai.com/docs/mcp](https://api.shortreelai.com/docs/mcp)\n- npm: [@starreel/mcp](https://www.npmjs.com/package/@starreel/mcp)\n- 中文文档: [README.zh-CN.md](./README.zh-CN.md)\n\n## License\n\n[MIT](./LICENSE) — this client is open; the production pipeline is a hosted service.\n",
  "bytes": 7264,
  "sha": "2e769f5e979ba404eaa3f04dd4d7880a3f0f8ca0ce1fdb788a4823b373f5c2bf",
  "repo_slug": "waydaxp/starreel-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_starreel_starreel_bca2a5ae/readme"
}