Skip to content
MCP server

vid2llm

Turn public TikTok, YouTube, Instagram and X videos into text, paid per video

Runs locallyStatus and history
Pricing
Paid
Platforms
API, CLI
Runs
Locally
Version
0.3.0
Listing updated
1 day ago

About vid2llm

vid2llm is a paid MCP server for design and media. It runs locally on your machine and is started by your AI client.

vid2llm exists because an agent cannot watch a video. Given a link, it downloads the public video, transcribes the audio and returns one markdown document with the author, description, stats and a timestamped transcript. An optional visuals mode adds on-screen text and a description of what is shown, which suits screen recordings and videos with burned-in captions.

There is no account or API key. Each request is paid individually with the x402 protocol in USDC on Base, starting at one cent for audio only and about seven cents with visuals according to the site, billed per started minute. The agent sees the exact price first and pays nothing if the video cannot be read. The npm package adds a watch_video tool that spends from a wallet you fund, capped by a maximum price you set.

It reads public videos up to 15 minutes, plus other public pages and direct video files when robots.txt allows it, and nothing behind a login.

Install

Run in a terminal

claude mcp add mcp --env VID2LLM_PRIVATE_KEY='<VID2LLM_PRIVATE_KEY>' --env VID2LLM_API_TOKEN='<VID2LLM_API_TOKEN>' -- npx -y vid2llm-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "stdio",
      "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

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • VID2LLM_PRIVATE_KEYPrivate key (0x...) of the wallet that pays for videos in USDC on Base. Use a dedicated wallet holding a few dollars.
  • VID2LLM_API_TOKENAn access token, if you have been given one. Used instead of paying.
  • VID2LLM_MAX_PRICEThe most to pay for one video, e.g. $1 (the default).

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

watch_video
Fetch a public video and return its details and a timestamped transcript as markdown

What it does

Video to markdown
Returns author, description, stats and a timestamped transcript.
Optional visuals
Adds on-screen text and a description of what is shown.
x402 payments
Pays per video in USDC with no sign-up.
Spending cap
A configurable maximum price limits spend per video.
Direct URL access
Agents with an x402 client can call it by prefixing the video link.
Multiple platforms
Reads TikTok, YouTube including Shorts, Instagram Reels and X.

Good for

  • Let an agent summarise a YouTube explainer
  • Pull the transcript of a TikTok for research
  • Read a screen-recorded demo including on-screen text
  • Fact-check what was said in a short public clip

Pricing

Paid

Pay per video via x402: from about $0.01 audio only, $0.07 with visuals

Prices change. Check vid2llm.dev before you buy.

vid2llm FAQ

What does it cost?

The site lists audio only from $0.01 and with visuals $0.07, billed per started minute, and nothing is charged if the video cannot be read.

Do I need an account?

No. There is no account or API key; payment is made per request with x402.

What can it read?

Public videos up to 15 minutes on TikTok, YouTube, Instagram and X, plus some public pages when robots.txt allows it.

How do I add it to Claude Code?

Run `claude mcp add vid2llm` with the VID2LLM_PRIVATE_KEY variable and `npx -y vid2llm-mcp`.

Is vid2llm free?

No. vid2llm is a paid product.

How do I add vid2llm to Claude Code?

Run this command in your terminal: claude mcp add mcp --env VID2LLM_PRIVATE_KEY='<VID2LLM_PRIVATE_KEY>' --env VID2LLM_API_TOKEN='<VID2LLM_API_TOKEN>' -- npx -y vid2llm-mcp

What are the best alternatives to vid2llm?

The closest alternatives to vid2llm are HyperFrames by HeyGen, ffmpeg-skill, Claude Code Ultimate Guide, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

Alternatives to vid2llm

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media