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/mcpContinue → 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/mcp2. Sign in
Run
/mcpin Claude Code → videodb → Authenticate → Log in → Authorize3. 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 videodb2. Click Authorize in the browser
pi prints the number of tools it signed in to.
3. Check it
pi mcp listvideodb 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
| 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. |
| Antigravity doesn't show videodb after you edit the config | Quit the app fully and reopen it. Reloading the window isn't enough. |
pi mcp list says needs sign-in | Run 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 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.
Use VideoDB in your agent
VideoDB lets an AI agent watch, search and clip video.
-
Claude Code
claude mcp add --transport http videodb https://mcp.videodb.io/mcp -
Cursor or any MCP client Add the remote MCP server and log in once:
https://mcp.videodb.io/mcp
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.