Prizmad
Generate AI UGC video ads from any product URL — avatars, voiceover, OAuth Connect.
Open source Repository Open in the app JSON README (API)
About
Generate AI UGC video ads from any product URL — avatars, voiceover, OAuth Connect.
Details
- Kind
- MCP servers
- Topic
- Marketing & analytics
- Publisher
- com.prizmad
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 2.0.3
- Stars
- 1
- Last push
- 2026-04-30T07:29:24Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:01:19
- Updated
- 2026-08-29 03:01:19
- Origin id
com.prizmad/mcp-server
README
# Prizmad MCP Server
> **Generate AI UGC video ads from any product URL — straight from your AI agent.**
[](https://www.npmjs.com/package/@prizmad/mcp-server)
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)
[](https://smithery.ai/server/@prizmad/mcp-server)
Model Context Protocol server for [Prizmad](https://prizmad.com). 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:
```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. |
## 🔗 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](https://prizmad.com/.well-known/agent-skills/oauth/SKILL.md) |
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](https://prizmad.com) — Main site
- [API documentation](https://prizmad.com/api/docs) — Interactive API docs (Scalar)
- [MCP server skill](https://prizmad.com/.well-known/agent-skills/mcp-server/SKILL.md) — full agent-facing reference
- [OAuth skill](https://prizmad.com/.well-known/agent-skills/oauth/SKILL.md) — three auth flows in detail
- [Privacy policy](./PRIVACY.md) · [Security policy](./SECURITY.md)
## 🏷 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