npm @prizmad/mcp-serverstreamable-httpMITupdated 4mo ago
Generate AI UGC video ads from any product URL — straight from your AI agent.
Prizmad 能做什么?
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
安装
把 Prizmad 添加到你的客户端。选择你正在使用的那个。
{
"servers": {
"mcp-server": {
"type": "http",
"url": "https://prizmad.com/api/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
claude mcp add mcp-server -- npx -y @prizmad/mcp-servercodex mcp add mcp-server -- npx -y @prizmad/mcp-serveramp mcp add mcp-server -- npx -y @prizmad/mcp-server{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@prizmad/mcp-server"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@prizmad/mcp-server"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@prizmad/mcp-server"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@prizmad/mcp-server"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@prizmad/mcp-server"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"mcp-server": {
"type": "local",
"command": "npx",
"args": [
"-y",
"@prizmad/mcp-server"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"mcp-server": {
"command": {
"path": "npx",
"args": [
"-y",
"@prizmad/mcp-server"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y @prizmad/mcp-serverRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
评分
39 / 100
不完整
- 文档25/25
- 维护19/25
- 可信度16/20
- 能力0/15
- 安装体验15/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 124 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 18 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
版本历史
| 版本 | 发布于 |
|---|---|
| 2.0.3最新 | 2026年4月30日 |
| 2.0.2 | 2026年4月30日 |
| 2.0.1 | 2026年4月30日 |