{
  "markdown": "# @demostudio/mcp-server\n\nMCP server for [DemoStudio](https://demostudio.xyz) — lets any MCP-compatible AI assistant (Claude Code, Cursor, Windsurf, etc.) generate short-form video ads directly from a conversation.\n\n## What it does\n\n- **`generate_video`** — Turn a text brief into a rendered Instagram Reel / TikTok / YouTube Short\n- **`get_video_status`** — Check build progress and get the exported video URL\n- **`list_capabilities`** — Show all 5 scene types and 17 Remotion templates\n- **`create_schedule`** — Set up the Agent to auto-generate videos on a recurring schedule\n\n## Requirements\n\n- Node.js 18+\n- A DemoStudio API key — get one at [demostudio.xyz/settings](https://demostudio.xyz/settings)\n\n## Installation\n\n### Claude Code\n\n```bash\nclaude mcp add --transport stdio \\\n  --env DEMOSTUDIO_API_KEY=your_api_key_here \\\n  demostudio \\\n  -- npx -y @demostudio/mcp-server\n```\n\n### Cursor / Windsurf\n\nAdd to your MCP config file (`~/.cursor/mcp.json` or `~/.codeium/windsurf/mcp_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"demostudio\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@demostudio/mcp-server\"],\n      \"env\": {\n        \"DEMOSTUDIO_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"demostudio\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@demostudio/mcp-server\"],\n      \"env\": {\n        \"DEMOSTUDIO_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Usage examples\n\nOnce installed, just talk to your AI assistant naturally:\n\n```\nGenerate a 30-second Instagram Reel for my SaaS product.\nIt's an AI inbox tool called Clearbox. Target: busy founders.\nTone: confident, direct. End with \"Try it free at getclearbox.com\".\nMusic: uplifting. Add subtitles.\n```\n\n```\nWhat Remotion templates does DemoStudio support?\n```\n\n```\nCheck the status of project abc-123.\n```\n\n```\nSet up a weekly automated video for my brand.\nProduct: Kova — project management for remote teams.\nURL: https://getkova.com. Calm music. Run every Monday.\n```\n\n## Tools reference\n\n### `generate_video`\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `prompt` | string | ✓ | Full creative brief — product, audience, tone, scenes, CTA |\n| `product_url` | string | | URL to crawl for brand colors, logo, description |\n| `music_mood` | `hype` \\| `uplifting` \\| `calm` | | Background music mood |\n| `subtitles` | boolean | | Burn subtitles onto voiceover scenes (default: true) |\n| `voice_gender` | `male` \\| `female` | | Preferred voiceover gender |\n\nReturns a project URL to preview and export the video.\n\n### `get_video_status`\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `project_id` | string | ✓ | Project UUID from `generate_video` |\n\n### `list_capabilities`\n\nNo parameters. Returns all 17 Remotion templates with descriptions.\n\n### `create_schedule`\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `frequency` | `daily` \\| `weekly` \\| `biweekly` \\| `monthly` | ✓ | How often to generate |\n| `run_day_of_week` | number (0–6) | | Day of week (0=Sun). Applies to weekly/biweekly/monthly |\n| `brand_description` | string | | Text brief added to the Knowledge Base |\n| `product_url` | string | | URL to crawl and add to the Knowledge Base |\n| `music_mood` | `hype` \\| `uplifting` \\| `calm` | | Default music for automated runs |\n\n## Pricing\n\nDemoStudio is credit-based. New accounts get **500 free credits** (enough for ~1 full video).\nActive accounts receive up to **500 bonus credits** every month.\n\n- Scene generation: 10 credits\n- Video export: 400 credits\n- Automated run: ~700 credits\n\n[View pricing →](https://demostudio.xyz/pricing)\n\n## License\n\nMIT\n\n---\n\n## Maintainer guide — publishing updates\n\n### 1. Make code changes in `src/index.ts`\n\n### 2. Bump the version\n```bash\nnpm version patch   # 0.1.2 → 0.1.3  (bug fix / small change)\nnpm version minor   # 0.1.2 → 0.2.0  (new tool or renamed tool)\nnpm version major   # 0.1.2 → 1.0.0  (breaking change)\n```\n\n### 3. Publish to npm\n```bash\nnpm publish --access public\n```\nThe `prepublishOnly` script runs `tsc` automatically before publishing.\n\n### 4. Update `server.json` — bump both version fields\n```json\n{\n  \"version\": \"0.1.3\",          ← top-level version\n  \"packages\": [{\n    \"version\": \"0.1.3\"         ← must match npm version\n  }]\n}\n```\n\n### 5. Re-authenticate and publish to MCP registry\nThe registry JWT expires after ~1 hour. Always re-login before publishing.\n```bash\n# Download the publisher binary (if not already on PATH)\ncurl -L \"https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz\" | tar xz mcp-publisher\n\n# Login via GitHub device flow\n./mcp-publisher login github\n# → go to https://github.com/login/device and enter the printed code\n\n# Publish\n./mcp-publisher publish server.json\n```\n\n### 6. Push to GitHub\n```bash\ngit add -A\ngit commit -m \"chore: bump to vX.Y.Z — <what changed>\"\ngit push origin main\n```\n\n### Notes\n- `server.json` `$schema` URL is versioned — only update it if the registry publishes a new schema version (check https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/server-json/CHANGELOG.md)\n- `.mcpregistry_*` files are gitignored — they contain auth tokens and must never be committed\n- The npm token is stored in `~/.npmrc` — re-run `npm set //registry.npmjs.org/:_authToken <token>` if it expires\n",
  "bytes": 5628,
  "sha": "7134c8e4c66601820f6e4f26650b37bcbd7df0370b90d9bfd71bc8be60c5bec2",
  "repo_slug": "32bitsret/demostudio-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_32bitsret_demostudio_845330c2/readme"
}