⚡ OdinMCP — Official OdinxD AI Video Studio MCP Server

Turn Claude, Cursor, Antigravity & Windsurf into an Autonomous 9:16 AI Video Production Studio.
Convierte Claude, Cursor, Antigravity y Windsurf en un Estudio Autónomo de Producción de Video Vertical 9:16 con IA.

🌐 Website • 📖 Interactive Docs & API v1 • 🔑 Get API Key • 🤖 Agent Manifest (/llms.txt)

1. Overview / ¿Qué es OdinMCP?

English:
OdinMCP (@odinxd/mcp-server) is the official Model Context Protocol (MCP) integration for OdinxD. It allows any MCP-compatible AI agent to plan, art-direct, upload local .mp4/.jpg assets, render studio-grade vertical 9:16 (1080×1920) videos in the cloud, monitor real-time progress, and download finished HD .mp4 files directly to your computer.

• 2 Connection Modes: Zero-install Remote Streamable HTTP (https://odinxd.com/api/mcp) or Local PC Bridge (npx -y github:odinxd-ai/OdinMCP) for seamless local file uploads & downloads.

• 6 Specialized Render Engines & 20 AI B-Roll Styles: ViralBeat 2.0, Hybrid AI B-Roll, Zero-Camera Faceless AI Ads (with 24 neural TTS voices), Real Estate Multi-Room Tours, E-Commerce UGC, Motion Stock, Maxy Overlay, and Fitness Talking-Head.

• 0-Charge Fail-Fast Protection: If any render fails or is blocked by AI safety filters, 0 renders are consumed and 100% of reserved AI credits are automatically refunded.

Español:
OdinMCP (@odinxd/mcp-server) es el servidor e integración oficial Model Context Protocol (MCP) de OdinxD. Permite a tus agentes de IA (Claude Desktop, Claude Code, Cursor, Antigravity, Windsurf) editar reels hablados a cámara, generar comerciales Faceless 100% desde texto, producir tours inmobiliarios inteligentes por estancia, subir archivos locales de tu ordenador automáticamente y descargar el .mp4 final en Full HD (1080×1920).

Related MCP server: video-studio-mcp

2. Table of Contents / Índice

1. Overview / ¿Qué es OdinMCP?

2. Render Modes & Live Video Previews / Modos de Render y Vistas Previas

3. Specialty AI B-Roll Showcases (Real Estate & UGC)

4. Step-by-Step Tutorial (0 to Video in 3 Min) / Tutorial Paso a Paso

5. Real-World Prompt & Tool Examples / Ejemplos Prácticos

6. Complete MCP Tools Reference (10 Tools)

7. Catalog of All 20 AI B-Roll Styles & 13 Real Estate Rooms

8. Golden Rules for AI Agents & Local Sandbox Security

3. Render Modes & Live Video Previews / Modos de Render y Vistas Previas

💡 Click any animated preview to open the HD .mp4 video with audio inside previews/videos/, or watch the full-length showcase on odinxd.com.
(Haz clic en cualquier vista previa animada para abrir el clip .mp4 con audio).

4. Specialty AI B-Roll Showcases / Estilos Especiales: Inmobiliario y UGC

OdinxD includes intelligent multi-reference AI B-Roll engines for Real Estate Agents (automatically matching the spoken script to the exact uploaded room photo) and E-Commerce Brands (integrating real product packaging into realistic UGC shots):

5. Step-by-Step Tutorial / Tutorial Paso a Paso en 3 Minutos

Step 1 — Generate Your Personal API Key / Obtén tu API Key

1. Sign in at https://odinxd.com/dashboard. (Works with Starter, Pro, or individual pay-as-you-go renders & AI credit packs).

2. Scroll to 🔌 OdinxD MCP Server & API Keys.

3. Click + Generate New API Key and copy your odx_live_... token.

Step 2 — Connect Your AI Client / Conecta tu Agente IA

Choose Mode A (Local PC Bridge — Recommended if your .mp4/.jpg files are on your computer) or Mode B (Remote Streamable HTTP — Zero install for cloud URLs & Faceless Ads).

💻 Mode A: Local PC Bridge (Uploads Local Files & Downloads Final .mp4 Automatically)

Requires Node.js >= 18. Zero external npm dependencies (~18 KB source).

Option A1 — Instant Clone & Run (Universal across all Node/npm versions, zero startup latency):

git clone https://github.com/odinxd-ai/OdinMCP.git

Then add to Claude Desktop (claude_desktop_config.json) / Cursor (mcp.json) / Antigravity / Windsurf:

{
  "mcpServers": {
    "odinxd": {
      "command": "node",
      "args": ["/absolute/path/to/OdinMCP/bin/odinxd-mcp.mjs"],
      "env": {
        "ODINXD_API_KEY": "odx_live_YOUR_KEY"
      }
    }
  }
}

Option A2 — Direct npx from GitHub (--allow-git=all supports npm v12+):

claude mcp add odinxd -e ODINXD_API_KEY=odx_live_YOUR_KEY -- npx --allow-git=all -y github:odinxd-ai/OdinMCP

{
  "mcpServers": {
    "odinxd": {
      "command": "npx",
      "args": ["--allow-git=all", "-y", "github:odinxd-ai/OdinMCP"],
      "env": {
        "ODINXD_API_KEY": "odx_live_YOUR_KEY"
      }
    }
  }
}

☁️ Mode B: Remote Streamable HTTP (Zero Local Code — Cloud URLs & Faceless Ads)

Claude Code (CLI):

claude mcp add --transport http odinxd https://odinxd.com/api/mcp \
  --header "Authorization: Bearer odx_live_YOUR_KEY"

Cursor / Antigravity / Windsurf (mcp.json):

{
  "mcpServers": {
    "odinxd": {
      "url": "https://odinxd.com/api/mcp",
      "headers": {
        "Authorization": "Bearer odx_live_YOUR_KEY"
      }
    }
  }
}

Claude Desktop via mcp-remote (claude_desktop_config.json):

{
  "mcpServers": {
    "odinxd": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://odinxd.com/api/mcp",
        "--header",
        "Authorization: Bearer odx_live_YOUR_KEY"
      ]
    }
  }
}

Step 3 — Ask Your Agent in Natural Language / Pídele tu Video en Lenguaje Natural

Once connected, verify by asking:

"Check my OdinxD quota and list the available AI B-Roll styles."
(Consulta mi saldo en OdinxD y dime qué estilos de B-Roll con IA están disponibles).

6. Real-World Examples / Ejemplos Prácticos de Uso

Example 1 — Real Estate Multi-Room Reel (Español / English)

Prompt to Claude / Cursor:

"Toma mi video limpio C:/Inmuebles/penthouse_aroll.mp4, mi foto de perfil C:/Inmuebles/agente.jpg y estas fotos del departamento: cocina.jpg, sala.jpg y terraza.jpg. Genera un reel en Modo Híbrido con estilo inmo_avatar_stock, tipografía Playfair Display y subtítulos kinetic_blur, y guárdalo en mi Escritorio cuando termine."

Underlying MCP Tool Call (render_hybrid_reel):

{
  "video_url": "C:/Inmuebles/penthouse_aroll.mp4",
  "ai_styles": ["inmo_avatar_stock", "inmo_tour"],
  "clips_count": 3,
  "clip_duration": 5,
  "typography": "Playfair Display",
  "subtitle_style": "kinetic_blur",
  "avatar_image": "C:/Inmuebles/agente.jpg",
  "inmo_photos": [
    { "url": "C:/Inmuebles/cocina.jpg", "room": "cocina" },
    { "url": "C:/Inmuebles/sala.jpg", "room": "sala" },
    { "url": "C:/Inmuebles/terraza.jpg", "room": "terraza" }
  ]
}

Example 2 — Zero-Camera Faceless AI Ad (create_faceless_ad)

{
  "product_name": "Aurum Cold Brew Concentrate",
  "description": "Specialty Colombian cold brew ready in 5 seconds. Zero sugar, 2x natural caffeine, smooth chocolate notes. 20% off starter kit today.",
  "faceless_mode": "commercial_narrated",
  "target_duration": 30,
  "lang": "en",
  "voice_id": "odin_pro_en",
  "subtitle_style": "kinetic_dinamic",
  "typography": "Montserrat",
  "bg_music": "minimal_luxury_122",
  "product_images": ["C:/Brand/bottle_front.png", "C:/Brand/pour_shot.jpg"]
}

Example 3 — Zero-AI-Credit Motion Graphics Reel (render_motion_stock)

{
  "video_url": "C:/Videos/saas_metrics_clean.mp4",
  "typography": "Space Grotesk",
  "subtitle_style": "kinetic_dinamic",
  "highlight_color": "#D4AF37"
}

7. Complete MCP Tools Reference / Referencia de Herramientas

8. Catalog of 20 AI B-Roll Styles / Catálogo de 20 Estilos IA y Estancias

Supported Real Estate Room IDs (inmo_photos[].room):
fachada_exterior, sala, comedor, cocina, habitacion_principal, habitacion_secundaria, bano, vestidor, terraza, jardin_piscina, estudio_oficina, lobby_amenidades, otro (auto-inferred from filenames like cocina.jpg or master_suite.png when using the Local Bridge!).

9. Golden Rules for AI Agents / Reglas de Oro y Seguridad

1. Single Clean A-Roll Video (video_url):
   OdinxD works exclusively with one continuous, clean base video (already trimmed without long silences, filler pauses, or spoken retakes) and does not concatenate multiple base videos into one timeline. If the user provides raw takes on their PC, the AI agent should first trim silences and concatenate takes locally using FFmpeg before invoking OdinxD.

2. Private Creator Faces Only on Avatar Styles (PROMINENT_PERSON_BLOCKED):
   avatar_stock, ugc_stock, and inmo_avatar_stock strictly accept photos of private creators or clients. Celebrity, politician, or famous podcaster faces are blocked by upstream generative safety filters. For commentary on public figures, always choose non-avatar styles (stock_hyperreal, cinematic_macro, scrapbook_polaroid, parallax_3d, vox_editorial).

3. Art Direction Defaults by Niche:

   • General / Creators: typography: "Montserrat", subtitle_style: "kinetic_dinamic"

   • Luxury Real Estate / High-Ticket: typography: "Playfair Display", subtitle_style: "kinetic_blur"

   • SaaS / AI / Tech: typography: "Space Grotesk", subtitle_style: "kinetic_dinamic"

   • Fitness / Direct Coaching: typography: "Bebas Neue", subtitle_style: "boxed_highlighter"

4. Hardened Local Bridge Sandbox (v2.0.1):

   • Zero third-party npm packages (100% auditable Node.js built-ins).

   • Blocks symbolic links (lstat), sensitive paths (.ssh, .aws, .git, .env), and non-multimedia extensions on upload.

   • Enforces https:// transport and .mp4-only output paths on wait_for_render.

License

Released under the MIT License © 2026 OdinxD.