Connect the MCP Server

Add this URL to your client:

https://mcp.videodb.io/mcp

You need a VideoDB account. Sign up free at console.videodb.io - no credit card.

Claude

Works on web, desktop and mobile.

Open connector settings

Settings → Connectors → Add custom connector.On Team and Enterprise plans, an admin adds it under Organization settings → Connectors.

Paste the server URL

https://mcp.videodb.io/mcp

Click Connect

A VideoDB page opens in your browser.

If you’re not already signed in, it takes you to log in (or sign up) at console.videodb.io first. Click Authorize. The browser hands you back to Claude with the connector enabled.

Claude Code

claude mcp add --transport http videodb https://mcp.videodb.io/mcp

Run /mcp inside Claude Code to authorize, then confirm it registered:

claude mcp list

Cursor

Open Settings → Cursor Settings → MCP → Add new global MCP server and add:

{
  "mcpServers": {
    "videodb": {
      "url": "https://mcp.videodb.io/mcp"
    }
  }
}

Cursor opens console.videodb.io on first use. Log in and click Authorize there.

MCP Inspector

npx @modelcontextprotocol/inspector

Set the transport to Streamable HTTP, enter https://mcp.videodb.io/mcp, and connect.

Any other client

Add it as a remote server over Streamable HTTP with the same URL. There is nothing else to configure.

Verify It Works

Ask your client:

list my videodb collections

You get back your collections with their IDs and names.

Troubleshooting

Symptom	Fix
The VideoDB page never opens	Allow popups for the client, and check whether a corporate proxy blocks `mcp.videodb.io`.
Authorization fails after you log in	Sign out and back in at console.videodb.io, then reconnect.
Tools are missing after connecting	Disconnect and reconnect so the client re-lists the tools.
A long upload or index call returns `status: "processing"`	The job is still running. Re-check it with the read tool named in the response’s `retry_with` field.
The connection stopped working	Disconnect the connector and connect again.

Local Server

An older package, videodb-director-mcp, runs a local MCP server over stdio. Use it if your client only supports stdio. See Local MCP Server.

Start Here

Core Concepts

Ingest

Understand

Act

Automate

MCP Server

Open Source Frameworks

Claude

Claude Code

Cursor

MCP Inspector

Any other client

Verify It Works

Troubleshooting

Local Server

​Claude

​Claude Code

​Cursor

​MCP Inspector

​Any other client

​Verify It Works

​Troubleshooting

​Local Server

Claude

Claude Code

Cursor

MCP Inspector

Any other client

Verify It Works

Troubleshooting

Local Server