{
  "markdown": "# Prizmad MCP Server\n\n> **Generate AI UGC video ads from any product URL — straight from your AI agent.**\n\n[![npm version](https://img.shields.io/npm/v/@prizmad/mcp-server.svg)](https://www.npmjs.com/package/@prizmad/mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Model Context Protocol](https://img.shields.io/badge/Model%20Context%20Protocol-2025--06--18-blue)](https://modelcontextprotocol.io)\n[![Smithery](https://img.shields.io/badge/Smithery-Listed-purple)](https://smithery.ai/server/@prizmad/mcp-server)\n\nModel Context Protocol server for [Prizmad](https://prizmad.com). It turns any product URL — Amazon, Shopify, WooCommerce, custom store — into a platform-ready video ad in 3-8 minutes. **50+ avatars, ElevenLabs voiceover, 8 caption styles, 9 music styles, 3 CTA styles, 10 image-style presets, free-text prompt hints across image / video / music.** Output is 9:16 / 1:1 / 16:9 Full HD, ready for **TikTok, Instagram Reels, Facebook Ads, YouTube Shorts, Shopify, Amazon**. Full commercial rights included.\n\nThis server is the agent-driver surface — pick a template, attach product images, customise the look, render, and hand back a brand-safe link. Works with **Claude Desktop, Claude.ai, ChatGPT, Cursor, Zed, Continue, n8n, custom MCP SDK clients**.\n\n- **Remote MCP**: `https://prizmad.com/api/mcp`\n- **Transport**: streamable-http\n- **Auth**: OAuth 2.1 + PKCE + Dynamic Client Registration (the \"Connect\" button) **OR** API key Bearer **OR** OAuth client_credentials.\n- **npm**: `@prizmad/mcp-server`\n\n---\n\n## ⚡ Quickstart — pick your client\n\n### Claude Desktop / Claude.ai / ChatGPT / Cursor / Zed (Connect button)\n\n**Just add a custom connector with this URL** — the OAuth + DCR flow runs automatically, no install, no API key:\n\n```\nhttps://prizmad.com/api/mcp\n```\n\nIn Claude Desktop: *Settings → Connectors → Add custom connector → URL: `https://prizmad.com/api/mcp`*. The browser opens, you sign in to Prizmad, click *Authorize*, the connector wires itself up.\n\nManual config when needed:\n\n```json\n{\n  \"mcpServers\": {\n    \"prizmad\": {\n      \"transport\": \"streamable-http\",\n      \"url\": \"https://prizmad.com/api/mcp\"\n    }\n  }\n}\n```\n\nFor clients that can't drive OAuth, drop in an API key instead:\n\n```json\n{\n  \"mcpServers\": {\n    \"prizmad\": {\n      \"transport\": \"streamable-http\",\n      \"url\": \"https://prizmad.com/api/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer przmad_sk_live_...\" }\n    }\n  }\n}\n```\n\n### stdio bridge (`@prizmad/mcp-server`) — for stdio-only clients\n\n```json\n{\n  \"mcpServers\": {\n    \"prizmad\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@prizmad/mcp-server\"],\n      \"env\": { \"PRIZMAD_API_KEY\": \"przmad_sk_live_...\" }\n    }\n  }\n}\n```\n\nOr installed globally:\n\n```bash\nnpm install -g @prizmad/mcp-server\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"prizmad\": {\n      \"command\": \"prizmad-mcp\",\n      \"env\": { \"PRIZMAD_API_KEY\": \"przmad_sk_live_...\" }\n    }\n  }\n}\n```\n\n### `.cursor/mcp.json` snippet (project-scoped)\n\n```json\n{\n  \"mcpServers\": {\n    \"prizmad\": {\n      \"url\": \"https://prizmad.com/api/mcp\"\n    }\n  }\n}\n```\n\n---\n\n## 🛠 Available tools\n\n| Tool | Auth | What it does |\n|------|:----:|--------------|\n| `list_templates` | No | Full template catalog with features, durations, token costs. |\n| `list_avatars` | No | Built-in avatar presets with name, gender, age, recommended voice. |\n| `recommend_template` | No | Top-3 template suggestions from intent + voice / avatar / duration / budget constraints. **Use this before `create_video`** instead of guessing from the catalog. |\n| `list_my_videos` | Yes | Recent projects with `projectUrl` / `shareUrl` / `downloadUrl`. Find a videoId from a previous session, \"remix my last video\", etc. |\n| `upload_image` | Yes | Upload an image (URL or base64) — returns a prizmad.com-hosted URL ready for `productImages` or `avatarImageUrl`. |\n| `create_video` | Yes | Start a render. Returns `videoId`. Accepts caption / music / CTA / image style presets and free-text prompt hints. |\n| `get_video_status` | Yes | Snapshot status by default; `wait: true` blocks server-side and emits `notifications/progress` until terminal (up to 10 min) — preferred over polling. |\n| `get_download_url` | Yes | Authenticated download URL on prizmad.com for a completed video. |\n| `create_video_batch` | Yes | Launch 1-20 renders in parallel. Each item supports the **full** create_video parameter surface — perfect for A/B variant testing. |\n\n## 🎨 Creative customisation on `create_video`\n\nEach is optional; omit any field for a randomised pick at render time.\n\n| Param | Values |\n|---|---|\n| `captionStyle` | `classic`, `bold-impact`, `karaoke`, `pop`, `bounce`, `neon`, `typewriter`, `glow` |\n| `musicStyle` | `energetic`, `friendly`, `professional`, `luxury`, `funny`, `cinematic`, `lo-fi`, `hip-hop`, `acoustic` |\n| `ctaStyle` | `classic`, `blurred-photo`, `dark-solid` |\n| `imageStyle` | `warm-golden`, `bright-neutral`, `cool-diffused`, `window-light`, `earthy-ambient`, `studio-clean`, `moody-dramatic`, `pastel-soft`, `nordic-minimal`, `sunset-warm` |\n| `imagePromptHint` | Free-text steer for AI creatives (≤ 400 chars). |\n| `videoPromptHint` | Free-text steer for AI product video clips. |\n| `musicPromptHint` | Free-text steer for the music generator. |\n| `language`, `tone`, `voiceId`, `avatarPresetId`, `duration`, `script` | Standard. |\n\n## 🔗 Output URLs (what to share with the user)\n\nEvery status response carries three URL kinds, in priority order:\n\n| Field | Goes to |\n|---|---|\n| `projectUrl` | `https://prizmad.com/projects/<id>` — owner-only dashboard with player, remix, edit, asset library. **Primary link** for the signed-in user. |\n| `shareUrl` | `https://prizmad.com/share/<token>` — public share page. Use **only** when forwarding outside the account. |\n| `downloadUrl` | `https://prizmad.com/api/v1/videos/<id>/download` — authenticated mp4 stream proxied via prizmad.com. |\n\nThe raw Vercel Blob URL is **never** surfaced to the agent.\n\n## 🔐 Authentication\n\n| Method | When | Get it |\n|---|---|---|\n| **OAuth 2.1 Authorization Code + PKCE + DCR** | Interactive clients (Connect button) | Automatic — no setup |\n| **API key (Bearer)** | Local stdio bridge, scripts, dev | <https://prizmad.com/api-keys> |\n| OAuth 2.0 client_credentials | Headless server-to-server | [oauth skill](https://prizmad.com/.well-known/agent-skills/oauth/SKILL.md) |\n\nAPI video generation requires a **Pro plan**. UI generation works on any plan; the Pro gate exists only on programmatic access.\n\n## 🧠 Typical agent workflow\n\n```text\nrecommend_template ─► (optional upload_image) ─► create_video\n                                                  └─► get_video_status (wait: true)\n                                                           └─► projectUrl + downloadUrl\n```\n\nOnce connected you can ask your agent things like:\n\n> \"Make a 30-second energetic showcase ad for this Amazon product:\n> https://amazon.com/dp/B0EXAMPLE — moody-dramatic look, cinematic music.\"\n\nThe agent will pick a template, drop in the URL with the style hints, kick off the render, wait through the live progress notifications, and hand back a `https://prizmad.com/projects/<id>` link.\n\n## 🌐 Discovery & metadata\n\n- **Server card**: <https://prizmad.com/.well-known/mcp/server-card.json>\n- **OAuth metadata**: <https://prizmad.com/.well-known/oauth-authorization-server>\n- **Protected resource metadata** (RFC 9728): <https://prizmad.com/.well-known/oauth-protected-resource>\n- **JWKS**: <https://prizmad.com/.well-known/jwks.json>\n- **Agent skills index**: <https://prizmad.com/.well-known/agent-skills/index.json>\n- **OpenAPI**: <https://prizmad.com/openapi.json>\n- **API catalog (RFC 9727)**: <https://prizmad.com/.well-known/api-catalog>\n\n## 📦 Environment variables (stdio bridge only)\n\n| Variable | Required | Description |\n|---|:---:|---|\n| `PRIZMAD_API_KEY` | Yes | Your Prizmad API key |\n| `PRIZMAD_BASE_URL` | No | API base URL (default `https://prizmad.com`) |\n\n## 📚 Resources\n\n- [Prizmad](https://prizmad.com) — Main site\n- [API documentation](https://prizmad.com/api/docs) — Interactive API docs (Scalar)\n- [MCP server skill](https://prizmad.com/.well-known/agent-skills/mcp-server/SKILL.md) — full agent-facing reference\n- [OAuth skill](https://prizmad.com/.well-known/agent-skills/oauth/SKILL.md) — three auth flows in detail\n- [Privacy policy](./PRIVACY.md) · [Security policy](./SECURITY.md)\n\n## 🏷 Topics / categories\n\n`mcp` · `mcp-server` · `model-context-protocol` · `claude` · `chatgpt-apps` · `ai-agents` · `oauth` · `remote-mcp` · `ai-video` · `video-ads` · `ugc-ads` · `ad-creative` · `ai-avatars` · `voiceover` · `elevenlabs` · `tiktok` · `instagram-reels` · `youtube-shorts` · `shopify` · `amazon` · `marketing`\n\n## License\n\nMIT\n",
  "bytes": 8787,
  "sha": "8bb9642865a2764dfc4dc6de24f2377ad4b0f79273e34689c08e730edf8c7afa",
  "repo_slug": "prizmad/prizmad-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_prizmad_mcp_server_06720a84/readme"
}