vid2llm MCP Server

dev.vid2llm/mcpv0.3.0

Read public videos (TikTok, YouTube, Instagram, X) as text. Pay per video with x402.

Node.jsstdioofficial registry

context tax

pending

security

pending

cold start

pending

freshness

Active6d ago

Our reading of vid2llm, from the data

vid2llm is a images, video & audio MCP server, listed in the official MCP Registry.

We haven't measured its tool list yet, so its token cost is unknown.

Maintenance is active: the last public signal was 6 days ago (2026-10-12). For comparison, 73% of images, video & audio servers are active or maintained.

It runs locally on your machine over stdio and needs 2 secrets (VID2LLM_PRIVATE_KEY, VID2LLM_API_TOKEN); use a scoped, least-privilege key.

Install vid2llm MCP server

claude mcp add vid2llm -e VID2LLM_PRIVATE_KEY='<vid2llm-private-key>' -e VID2LLM_API_TOKEN='<vid2llm-api-token>' -- npx -y vid2llm-mcp

{
  "mcpServers": {
    "vid2llm": {
      "command": "npx",
      "args": [
        "-y",
        "vid2llm-mcp"
      ],
      "env": {
        "VID2LLM_PRIVATE_KEY": "<vid2llm-private-key>",
        "VID2LLM_API_TOKEN": "<vid2llm-api-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "vid2llm": {
      "command": "npx",
      "args": [
        "-y",
        "vid2llm-mcp"
      ],
      "env": {
        "VID2LLM_PRIVATE_KEY": "<vid2llm-private-key>",
        "VID2LLM_API_TOKEN": "<vid2llm-api-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "vid2llm": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "vid2llm-mcp"
      ],
      "env": {
        "VID2LLM_PRIVATE_KEY": "<vid2llm-private-key>",
        "VID2LLM_API_TOKEN": "<vid2llm-api-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "vid2llm": {
      "command": "npx",
      "args": [
        "-y",
        "vid2llm-mcp"
      ],
      "env": {
        "VID2LLM_PRIVATE_KEY": "<vid2llm-private-key>",
        "VID2LLM_API_TOKEN": "<vid2llm-api-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
VID2LLM_PRIVATE_KEY	—	yes	Private key (0x...) of the wallet that pays for videos in USDC on Base. Use a dedicated wallet holding a few dollars.
VID2LLM_API_TOKEN	—	yes	An access token, if you have been given one. Used instead of paying.
VID2LLM_MAX_PRICE	—	—	The most to pay for one video, e.g. $1 (the default).

Freshness

Active — last maintenance signal 6d ago. The newest of the signals below sets the band.

Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-10-12 · 6d ago · official registry · v0.3.0

How it compares in Images, Video & Audio

Against the most-starred images, video & audio servers we index. Token cost is per model turn, measured from each server's live tool list.

Server	Stars	Tools	Tokens / turn	Freshness	Runs
vid2llm (this)	—	—	not measured	Active	local
Screenpipe	21,982	—	not measured	Active	—
screenpipe	21,982	—	not measured	Active	local
FunASR	20,748	—	not measured	Active	local
Agent-Native Analytics	7,433	—	not measured	Active	hosted
Remove AI Watermarks	6,054	—	not measured	Active	local

All images, video & audio MCP servers

FAQ

›How do I install the vid2llm MCP server in Claude Code?

Run: claude mcp add vid2llm -e VID2LLM_PRIVATE_KEY='<vid2llm-private-key>' -e VID2LLM_API_TOKEN='<vid2llm-api-token>' -- npx -y vid2llm-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does vid2llm require an API key?

Yes. It expects VID2LLM_PRIVATE_KEY, VID2LLM_API_TOKEN, of which 2 are secrets.

›Can I use vid2llm as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is vid2llm in the official MCP registry?

Yes, as dev.vid2llm/mcp.

Sources and method

Official MCP Registry entry: updated 2026-10-12
Package registry (npm / PyPI): listed
Last checked against all sources: 2026-10-19

The description, packages and links come from the maintainer's own published metadata. Token cost, security signals, freshness and the reading above are MCPSkillHub's own measurements; see the methodology. Spot an error? Request a correction or claim the listing.