vid2llm
Turn public TikTok, YouTube, Instagram and X videos into text, paid per video
- 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-mcpAdd 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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Claude Code Ultimate Guide
MCP serverMCP 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

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media