Package Exports
- @prizmad/mcp-server
- @prizmad/mcp-server/dist/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@prizmad/mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
Prizmad MCP Server
Generate AI UGC video ads from any product URL — straight from your AI agent.
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/mcpIn 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 + downloadUrlOnce 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