JSPM

@prizmad/mcp-server

2.0.2
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 105
  • Score
    100M100P100Q76928F
  • License MIT

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 for Claude Desktop / Claude.ai / ChatGPT / Cursor / Zed; stdio bridge for headless API-key flows.

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.

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

📦 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

🏷 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