# TwelveLabs MCP

> Index, search, and analyze video libraries with Pegasus and Marengo through MCP.

- **Category:** Editing & Post
- **Vendor:** TwelveLabs / Teraflop (official)
- **Pricing:** freemium
- **Verified:** 2026-06-28

## What it does

TwelveLabs' MCP server gives agents semantic video search and analysis: create indexes, upload or batch-index clips, search by natural language or image, summarize footage, generate chapters/highlights, and retrieve embeddings. For filmmakers this is the missing dailies-and-library brain — ask for the shot where a character enters frame, find matching B-roll, or produce structured notes from long generated cuts.

## Connect

- Claude Code: `claude mcp add twelvelabs -e TWELVELABS_API_KEY=YOUR_KEY -- npx -y --package=twelvelabs-mcp twelvelabs-mcp-stdio`
- Local: `npx -y --package=twelvelabs-mcp twelvelabs-mcp-stdio`

**Auth:** api_key (env `TWELVELABS_API_KEY`) — https://playground.twelvelabs.io

## Capabilities

`video-search` · `video-analysis` · `dailies-indexing` · `embeddings` · `metadata-extraction` · `entity-search`

## Sample tools

`create-index` · `start-video-indexing-task` · `search` · `async-analyse-video` · `create-entity` · `retrieve-video-embeddings`

## Field notes

npm twelvelabs-mcp 1.0.0, published May 2026, maintained by the `twelvelabs` npm account plus Teraflop. The stdio bin is `twelvelabs-mcp-stdio`; the explicit `--package=twelvelabs-mcp` npx form avoids npm confusing the package name with the bin name. Local file and folder uploads only work over stdio; hosted HTTP expects API-key headers and public/direct video URLs.

## Verification

- Status: Freshly checked (1 days old)
- Added: 2026-06-28
- Last verified: 2026-06-28
- Machine JSON: https://mcp.film/api/mcps/twelvelabs.json

## Links

- Site: https://www.twelvelabs.io
- Docs: https://www.npmjs.com/package/twelvelabs-mcp
- Repo: https://github.com/twelvelabs-io/twelvelabs-js

---

Structured data: https://mcp.film/api/mcps/twelvelabs.json · Directory: https://mcp.film
