com.prizmad/mcp-server

Official

by prizmad · JavaScript

Prizmad

Generate AI UGC video ads from any product URL — avatars, voiceover, OAuth Connect.

Generates AI-powered UGC video ads with avatars and voiceovers from product URLs.

Topics

ad-creativeaiai-agentsai-avatarsai-videoanthropicchatgpt-appsclaudeclaude-mcpelevenlabsmcpmcp-servermodel-context-protocoloauthremote-mcpugcugc-adsvideo-adsvideo-generationvoiceover

README.md9 KBView on GitHub

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:

code

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:

json

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

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

json

{
  "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

json

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

Or installed globally:

bash

npm install -g @prizmad/mcp-server

json

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

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

json

{
  "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.

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

text

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

Install

Configuration

Environment variables

PRIZMAD_API_KEYrequiredsecret

Your Prizmad API key. Get one at https://prizmad.com/api-keys

PRIZMAD_BASE_URLdefault https://prizmad.com

Override base URL (defaults to https://prizmad.com).

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@prizmad/mcp-server@2.0.3"
      ],
      "env": {
        "PRIZMAD_API_KEY": "<YOUR_PRIZMAD_API_KEY>",
        "PRIZMAD_BASE_URL": "https://prizmad.com"
      }
    }
  }
}

Topics

Prizmad MCP Server

⚡ Quickstart — pick your client

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

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

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

🛠 Available tools

🎨 Creative customisation on create_video

🔗 Output URLs (what to share with the user)

🔐 Authentication

🧠 Typical agent workflow

🌐 Discovery & metadata

📦 Environment variables (stdio bridge only)

📚 Resources

🏷 Topics / categories

License

Install

Configuration

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

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

🎨 Creative customisation on `create_video`