mcp.film

mcp.film / Editing & Post / TwelveLabs MCP

TwelveLabs MCP

Officialby TwelveLabs / Teraflopfreemiumverified Aug 27, 2026

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

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
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "twelvelabs": {
      "command": "npx",
      "args": [
        "-y",
        "--package=twelvelabs-mcp",
        "twelvelabs-mcp-stdio"
      ],
      "env": {
        "TWELVELABS_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "twelvelabs": {
      "command": "npx",
      "args": [
        "-y",
        "--package=twelvelabs-mcp",
        "twelvelabs-mcp-stdio"
      ],
      "env": {
        "TWELVELABS_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}
Auth: api_key · env TWELVELABS_API_KEYhttps://playground.twelvelabs.io

Tools you'll see

create-indexstart-video-indexing-tasksearchasync-analyse-videocreate-entityretrieve-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.

Pairs well with