@prizmad/mcp-server

v2.0.3

Published

2 months ago

Model Context Protocol (MCP) server for Prizmad — generate AI UGC video ads from any product URL. Tools for recommend_template, upload_image, create_video, get_video_status (with live progress), create_video_batch, list_my_videos. OAuth 2.1 Connect flow f

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/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

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme