# 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-08-27

## 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](https://mcp.film/capabilities/video-search.md) · [video-analysis](https://mcp.film/capabilities/video-analysis.md) · [dailies-indexing](https://mcp.film/capabilities/dailies-indexing.md) · `embeddings` · [metadata-extraction](https://mcp.film/capabilities/metadata-extraction.md) · [entity-search](https://mcp.film/capabilities/entity-search.md)

## Sample tools

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

## Field notes

This is now the older half of TwelveLabs' MCP surface: the single-video tools. TwelveLabs' docs have moved the hosted copy of them off mcp.twelvelabs.io to mcp-alpic.twelvelabs.io — if you connected a hosted URL before roughly mid-2026, it is stale — and mcp.twelvelabs.io now serves the cross-video Jockey server instead (listed separately as `twelvelabs-jockey`). The docs name only the new host, not a full endpoint path, so `remote_url` stays null here; the stdio install below is the path that is actually documented end to end. npm twelvelabs-mcp is still 1.0.0, published May 12 2026 and untouched since — three and a half months without a release, so treat the tool list as frozen. Maintained by the `twelvelabs` npm account plus Teraflop; the linked repo is the JS SDK (18 stars, pushed Aug 19 2026), not the MCP server — no MCP source exists anywhere in the twelvelabs-io org, so there is nothing to read for the server itself. 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. For new setups, start with Jockey unless you specifically need per-video embeddings or index-level control.

## Verification

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

## Links

- Site: https://www.twelvelabs.io/?utm_source=mcp.film&utm_medium=referral&utm_campaign=directory&utm_content=twelvelabs%3Asite
- Docs: https://docs.twelvelabs.io/docs/advanced/model-context-protocol?utm_source=mcp.film&utm_medium=referral&utm_campaign=directory&utm_content=twelvelabs%3Adocs
- Repo: https://github.com/twelvelabs-io/twelvelabs-js

---

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