Bring Video Search
to Claude Code
Learn how to connect Twelve Labs (Video Understanding) to Claude Code and start using 18 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.
Compatible with every major AI agent and IDE
What is the Twelve Labs (Video Understanding) MCP Server?
Connect Twelve Labs to your AI agent to unlock the full potential of video understanding. This server allows your agent to index video files, perform complex semantic searches, and generate deep analytical insights from visual and audio data.
What you can do
- Video Indexing — Create and manage indexes to organize your video library for rapid retrieval and analysis.
- Semantic Search — Query your video content using natural language to find specific moments, objects, or actions without manual tagging.
- Asset Management — Upload videos via URLs or multipart sessions and monitor their indexing status in real-time.
- Deep Analysis — Run synchronous or asynchronous analysis tasks to extract structured data from your video assets.
- Embeddings & Entities — Generate multimodal embeddings and manage entity collections for advanced machine learning workflows.
How it works
- Subscribe to this server
- Enter your Twelve Labs API Key
- Start querying your video data from Claude, Cursor, or any MCP-compatible client
Transform your video archives into searchable, actionable data. Your AI can now 'watch' and understand hours of footage in seconds.
Who is this for?
- Content Creators & Media Teams — quickly find b-roll or specific scenes across massive video libraries.
- Security & Operations — search through hours of footage for specific events or objects using natural language.
- Developers — integrate state-of-the-art video understanding into your AI workflows without building complex pipelines.
Built-in capabilities (18)
Analyze and segment videos asynchronously
Analyze and segment videos synchronously
Confirm a multipart upload
Upload content to create an asset
g., a person) within a collection. Create an entity
Create an entity collection
Create a new index
Create a multipart upload session
Delete an index
Create embeddings asynchronously
Create embeddings synchronously
Retrieve an index by ID
Retrieve an indexed asset
Index an uploaded asset
List all indexes
Report progress for a multipart upload
Search for moments in videos
Update an index name
Why Claude Code?
Claude Code registers Twelve Labs (Video Understanding) as an MCP server in a single terminal command. Once connected, Claude Code discovers all 18 tools at runtime and can call them headlessly. ideal for CI/CD pipelines, cron jobs, and automated workflows where Twelve Labs (Video Understanding) data drives decisions without human intervention.
- —
Single-command setup:
claude mcp addregisters the server instantly. no config files to edit or applications to restart - —
Terminal-native workflow means MCP tools integrate seamlessly into shell scripts, CI/CD pipelines, and automated DevOps tasks
- —
Claude Code runs headlessly, enabling unattended batch processing using Twelve Labs (Video Understanding) tools in cron jobs or deployment scripts
- —
Built by the same team that created the MCP protocol, ensuring first-class compatibility and the fastest adoption of new protocol features
Twelve Labs (Video Understanding) in Claude Code
Twelve Labs (Video Understanding) and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect Twelve Labs (Video Understanding) to Claude Code through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 4,000+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for Twelve Labs (Video Understanding) in Claude Code
The Twelve Labs (Video Understanding) MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 18 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in Claude Code only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
How Vinkius secures
Twelve Labs (Video Understanding) for Claude Code
Every tool call from Claude Code to the Twelve Labs (Video Understanding) MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
How do I list all my existing video indexes?
You can use the list_indexes tool. It will return a list of all indexes available in your Twelve Labs account, including their IDs and configuration.
Can I search for a specific moment inside my videos using text?
Yes! Use the search tool by providing an index_id and a search query. The AI will find the most relevant timestamps and video segments based on your description.
How do I add a new video to an index for analysis?
First, use create_asset with a public URL to upload the video. Then, use the index_asset tool with the resulting asset_id and your target index_id to start the processing.
How do I add an MCP server to Claude Code?
Run claude mcp add <name> --transport http "<url>" in your terminal. Claude Code registers the server and discovers all tools immediately.
Can Claude Code run MCP tools in headless mode?
Yes. Claude Code supports non-interactive execution, making it ideal for scripts, cron jobs, and CI/CD pipelines that need MCP tool access.
How do I list all connected MCP servers?
Run claude mcp in your terminal to see all registered servers and their status, or type /mcp inside an active Claude Code session.
Command not found: claude
Ensure Claude Code is installed globally: npm install -g @anthropic-ai/claude-code
Connection timeout
Check your internet connection and verify the Edge URL is reachable
Explore More MCP Servers
View all →
Dagster
6 toolsOrchestrate data pipelines via Dagster — monitor jobs, track runs, manage software-defined assets, and audit schedules directly from any AI agent.

crowd.dev (LFX CDP)
10 toolsEquip your AI agent to manage community members, activities, and organizations directly via the crowd.dev (LFX) API.

IPQualityScore (IPQS)
10 toolsDetect fraud, proxies, and malicious activity via IPQS API.

Serper
3 toolsFast, affordable Google Search API — get real-time SERP results, news, and images with 2,500 free searches per month.
