# vid2llm

> vid2llm is a paid MCP server for design and media. Turn public TikTok, YouTube, Instagram and X videos into text, paid per video. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI
- **Website:** https://vid2llm.dev
- **MCP Registry name:** dev.vid2llm/mcp
- **Categories:** design and media, news and media, AI models and LLM tooling
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "vid2llm-mcp"
      ],
      "env": {
        "VID2LLM_PRIVATE_KEY": "<VID2LLM_PRIVATE_KEY>",
        "VID2LLM_API_TOKEN": "<VID2LLM_API_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/vid2llm
