MCP Server

Connect your favorite AI tools — Claude Desktop, Cursor, VS Code, or any MCP-compatible application — directly to your Genvid account. Access all of Genvid's production tools through natural language without opening the web interface.

Overview

The Genvid MCP Server lets AI assistants work with your projects, assets, scenes, shots, and production data. Instead of switching between your AI tool and the Genvid web app, you can ask questions and take actions directly from your editor or chat interface.

For example, you can ask Claude Desktop to "list my projects," "get a summary of The Seeker," or "show me the shots in scene 1" — and it will pull live data from your Genvid account.

What You Can Do

Area	Examples
Browse Projects	List projects, search by name, view project details
Screenplay	Read screenplays, view scenes, check asset references
Assets	Browse characters, locations, and props with their reference images
Shots & Scenes	View shot details, scene breakdowns, storyboard status
Production	Check assignments, pipeline status, workflow progress
Analytics	View cost breakdowns by artist, asset, shot, or model
Generate Content	Create keyframes, dialog audio, videos, and asset images
Storyboard	Generate storyboards, approve shots, compare versions

Same Permissions Apply

The MCP server respects your Genvid account permissions. You can only access projects and perform actions that your role allows — the same as when using the web interface.

Get the Genvid Skill Pack

The Genvid skill pack teaches any MCP-capable agent — Claude Code, Cursor, and others — how to drive Genvid's governed boundary: screenplay breakdown, scene and shot design, storyboard composition, and provenance-bearing generation, out of the box.

Claude Code:

/plugin marketplace add genvid-holdings/agent-skills
/plugin install genvid-skills@genvid-skills

Other agents: clone github.com/genvid-holdings/agent-skills and point your agent at its skills/ folder.

Once the pack is installed, connect your agent to a live Genvid boundary — see Setting Up below.

Setting Up

Step 1: Get the Server URL

Your Genvid MCP server is available at:

Production: https://mcp.genvid.com

Step 2: Add to Your AI Tool

Add the Genvid server to your AI tool's MCP configuration. The setup varies by tool:

Claude Desktop

Claude Desktop connects to remote MCP servers through the Connectors feature:

Open Claude Desktop
Go to Settings (gear icon)
Navigate to Connectors → Add custom connector
Enter the URL: https://mcp.genvid.com
Follow the authentication prompt to sign in with your Genvid account

Cursor

Open Cursor Settings
Navigate to MCP Servers
Click Add Server
Enter:
- Name: Genvid
- Type: HTTP
- URL: https://mcp.genvid.com

VS Code (with Claude Code extension)

Open your project's .mcp.json file (create it if it doesn't exist)
Add the Genvid server:

{
  "mcpServers": {
    "genvid": {
      "type": "http",
      "url": "https://mcp.genvid.com"
    }
  }
}

Step 3: Authenticate

The first time your AI tool connects to Genvid, a browser window will open automatically:

Sign in with your Genvid account (Google sign-in or email/password)
You'll see a consent screen showing which application is requesting access
Click Allow to grant access
The browser will redirect back and your AI tool will confirm the connection

After authentication, you won't need to sign in again until your session expires (typically several hours).

Re-authentication

If your session expires, your AI tool will automatically open a browser window to sign in again. Just complete the sign-in and you'll be reconnected.

Using Genvid Tools

Once connected, you can ask your AI assistant to work with your Genvid data using natural language.

Browsing Projects

"List all my projects"

"Get a summary of project The Seeker"

"What's the production status of project 83?"

Working with Scenes and Shots

"Show me the scenes in project 65"

"Get details for scene 955 in project 65"

"List all shots in The Seeker"

Checking Analytics

"What's the cost breakdown by artist for project 65?"

"How much have we spent on The Seeker?"

Generating Content

"Generate a keyframe for shot 5 in project 65"

"Create dialog audio for shot 10"

Generation Costs

Generating keyframes, videos, dialog, and asset images consumes credits from your organization's balance. Check your budget before generating content in bulk.

Troubleshooting

"Needs authentication" error

Your session has expired. Your AI tool should automatically open a browser for re-authentication. If it doesn't:

Disconnect the Genvid server in your AI tool's MCP settings
Reconnect it — this will trigger a fresh authentication flow

Tools aren't loading

Make sure:

You're using the current URL: https://mcp.genvid.com (no path). If your tool was set up earlier with https://app.genvid.com/api/mcp/, update it to the new address.
The server type is set to http (not stdio)
Your Genvid account has an active subscription

"Access denied" on a tool

Your Genvid role doesn't have permission for that action. Contact your organization's admin to adjust your role if needed.

Browser doesn't open for authentication

Some AI tools may not automatically open the browser. Check your tool's MCP server status panel — there may be an Authenticate button you can click manually.

Managing Access

You can see and revoke every application you've connected to your Genvid account:

Open your Profile (top-right account menu)
Scroll to Connected Applications
Each connected app shows its name, when you authorized it, and a Revoke button

Revoking ends the app's active sessions immediately and stops it from refreshing, so its access stops working shortly after (within one session lifetime). You can re-authorize the app at any time by reconnecting it in your AI tool.

Related Features

Project Dashboard — View and manage projects in the web UI
Subscriptions & Billing — Manage your organization's credits and subscription