Prizmad

Generate AI UGC video ads from any product URL — straight from your AI agent.

npm version License: MIT Model Context Protocol Smithery

Model Context Protocol server for Prizmad. 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.

This 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.

• Remote MCP: https://prizmad.com/api/mcp
• Transport: streamable-http
• Auth: OAuth 2.1 + PKCE + Dynamic Client Registration (the "Connect" button) OR API key Bearer OR OAuth client_credentials.
• npm: @prizmad/mcp-server

---

⚡ Quickstart — pick your client

Claude Desktop / Claude.ai / ChatGPT / Cursor / Zed (Connect button)

Just add a custom connector with this URL — the OAuth + DCR flow runs automatically, no install, no API key:

https://prizmad.com/api/mcp

In 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.

Manual config when needed:

{
  "mcpServers": {
    "prizmad": {
      "transport": "streamable-http",
      "url": "https://prizmad.com/api/mcp"
    }
  }
}

For clients that can't drive OAuth, drop in an API key instead:

{
  "mcpServers": {
    "prizmad": {
      "transport": "streamable-http",
      "url": "https://prizmad.com/api/mcp",
      "headers": { "Authorization": "Bearer przmad_sk_live_..." }
    }
  }
}

stdio bridge (@prizmad/mcp-server) — for stdio-only clients

{
  "mcpServers": {
    "prizmad": {
      "command": "npx",
      "args": ["-y", "@prizmad/mcp-server"],
      "env": { "PRIZMAD_API_KEY": "przmad_sk_live_..." }
    }
  }
}

Or installed globally:

npm install -g @prizmad/mcp-server

{
  "mcpServers": {
    "prizmad": {
      "command": "prizmad-mcp",
      "env": { "PRIZMAD_API_KEY": "przmad_sk_live_..." }
    }
  }
}

.cursor/mcp.json snippet (project-scoped)

{
  "mcpServers": {
    "prizmad": {
      "url": "https://prizmad.com/api/mcp"
    }
  }
}

---

🛠 Available tools

Tool	Auth	What it does
list_templates	No	Full template catalog with features, durations, token costs.
list_avatars	No	Built-in avatar presets with name, gender, age, recommended voice.
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.
list_my_videos	Yes	Recent projects with projectUrl / shareUrl / downloadUrl. Find a videoId from a previous session, "remix my last video", etc.
upload_image	Yes	Upload an image (URL or base64) — returns a prizmad.com-hosted URL ready for productImages or avatarImageUrl.
create_video	Yes	Start a render. Returns videoId. Accepts caption / music / CTA / image style presets and free-text prompt hints.
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.
get_download_url	Yes	Authenticated download URL on prizmad.com for a completed video.
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.

🎨 Creative customisation on create_video

Each is optional; omit any field for a randomised pick at render time.

Param	Values
captionStyle	classic, bold-impact, karaoke, pop, bounce, neon, typewriter, glow
musicStyle	energetic, friendly, professional, luxury, funny, cinematic, lo-fi, hip-hop, acoustic
ctaStyle	classic, blurred-photo, dark-solid
imageStyle	warm-golden, bright-neutral, cool-diffused, window-light, earthy-ambient, studio-clean, moody-dramatic, pastel-soft, nordic-minimal, sunset-warm
imagePromptHint	Free-text steer for AI creatives (≤ 400 chars).
videoPromptHint	Free-text steer for AI product video clips.
musicPromptHint	Free-text steer for the music generator.
language, tone, voiceId, avatarPresetId, duration, script	Standard.

🔗 Output URLs (what to share with the user)

Every status response carries three URL kinds, in priority order:

Field	Goes to
projectUrl	https://prizmad.com/projects/<id> — owner-only dashboard with player, remix, edit, asset library. Primary link for the signed-in user.
shareUrl	https://prizmad.com/share/<token> — public share page. Use only when forwarding outside the account.
downloadUrl	https://prizmad.com/api/v1/videos/<id>/download — authenticated mp4 stream proxied via prizmad.com.

The raw Vercel Blob URL is never surfaced to the agent.

🔐 Authentication

Method	When	Get it
OAuth 2.1 Authorization Code + PKCE + DCR	Interactive clients (Connect button)	Automatic — no setup
API key (Bearer)	Local stdio bridge, scripts, dev	https://prizmad.com/api-keys
OAuth 2.0 client_credentials	Headless server-to-server	oauth skill

API video generation requires a Pro plan. UI generation works on any plan; the Pro gate exists only on programmatic access.

🧠 Typical agent workflow

recommend_template ─► (optional upload_image) ─► create_video
                                                  └─► get_video_status (wait: true)
                                                           └─► projectUrl + downloadUrl

Once connected you can ask your agent things like:

"Make a 30-second energetic showcase ad for this Amazon product: https://amazon.com/dp/B0EXAMPLE — moody-dramatic look, cinematic music."

The 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.

🌐 Discovery & metadata

• Server card: https://prizmad.com/.well-known/mcp/server-card.json
• OAuth metadata: https://prizmad.com/.well-known/oauth-authorization-server
• Protected resource metadata (RFC 9728): https://prizmad.com/.well-known/oauth-protected-resource
• JWKS: https://prizmad.com/.well-known/jwks.json
• Agent skills index: https://prizmad.com/.well-known/agent-skills/index.json
• OpenAPI: https://prizmad.com/openapi.json
• API catalog (RFC 9727): https://prizmad.com/.well-known/api-catalog

📦 Environment variables (stdio bridge only)

Variable	Required	Description
PRIZMAD_API_KEY	Yes	Your Prizmad API key
PRIZMAD_BASE_URL	No	API base URL (default https://prizmad.com)

📚 Resources

• Prizmad — Main site
• API documentation — Interactive API docs (Scalar)
• MCP server skill — full agent-facing reference
• OAuth skill — three auth flows in detail
• Privacy policy · Security policy

🏷 Topics / categories

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

License

MIT