VideoDB

VideoDB lets an AI agent watch, search and clip video. Works in Claude, ChatGPT, Claude Code, Cursor and any MCP client.

Hosted MCP Server

npx add-mcp 'https://mcp.videodb.io/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Connect the MCP Server

Add the hosted VideoDB MCP Server to Claude, Claude Code, ChatGPT, Cursor, Antigravity, pi, or any MCP client

[card] Add to Claude

One click from the Claude plugin directory

[card] Add to ChatGPT

One click from the VideoDB plugin page in ChatGPT

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.


Pick your client. The video and steps below change with it.

[tab] Claude

1. Add a custom connector

Customize → Connectors → Add → Add custom connector

2. Name it VideoDB and paste the server URL

https://mcp.videodb.io/mcp

Continue → Add

3. Approve in the browser

Continue connecting → Log in → Authorize → Open Claude

Or add it in one click from the Claude directory.

[tab] Claude Code

1. Add the server

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

2. Sign in

Run /mcp in Claude Code → videodb → Authenticate → Log in → Authorize

3. Check it

claude mcp list

[tab] ChatGPT

1. Install the plugin

Plugins → Search videodb → VideoDB → Install plugin

2. Approve in the browser

Log in → Authorize

3. Try it

Try now → Ask about a video

[tab] Cursor

1. Add a global MCP server

Settings → Cursor Settings → MCP → Add new global MCP server

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

2. Approve in the browser

Cursor opens VideoDB on first use: Log in → Authorize

[tab] Antigravity

1. Add VideoDB to the config file

Customizations → Installed → MCP Servers → Copy Config File Path

MCP Servers is at the bottom. Open that file and add:

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

2. Restart Antigravity and sign in

MCP Servers → Authenticate → Log in → Authorize

3. Paste the code

Copy to Clipboard → Paste in Antigravity → Submit

4. Try it

New Conversation → Ask about a video

[tab] pi

1. Add the server

pi mcp add videodb --url https://mcp.videodb.io/mcp
pi mcp login videodb

2. Click Authorize in the browser

pi prints the number of tools it signed in to.

3. Check it

pi mcp list

videodb shows as connected.


Other clients

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

To test the server on its own, run MCP Inspector:

npx @modelcontextprotocol/inspector

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


Verify It Works

Ask your client:

list my videodb collections

You get back your collections with their IDs and names.


Troubleshooting

SymptomFix
The VideoDB page never opensAllow popups for the client, and check whether a corporate proxy blocks mcp.videodb.io.
Authorization fails after you log inSign out and back in at console.videodb.io, then reconnect.
Tools are missing after connectingDisconnect and reconnect so the client re-lists the tools.
Antigravity doesn't show videodb after you edit the configQuit the app fully and reopen it. Reloading the window isn't enough.
pi mcp list says needs sign-inRun pi mcp login videodb.
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 workingDisconnect 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.

Use VideoDB in your agent

VideoDB lets an AI agent watch, search and clip video.

Free to start: $20 of credits, no credit card. Steps for every client

This documentation is built and hosted on Mintlify, a developer documentation platform.