mcp server
tube-search-mcp
MCP server for Archivarix Tube Search — search archived YouTube videos via AI assistants
Set up
Runs on your computer. Pick your agent and operating system.
Before you start
- Node.js 20 or newer
{
"mcpServers": {
"tube-search-mcp": {
"command": "npx",
"args": [
"-y",
"tube-search-mcp"
],
"env": {
"TUBE_API_KEY": "<your TUBE_API_KEY>"
}
}
}
}same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12
Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs
README
synced Oct 17, 2026tube-search-mcp
MCP server for Archivarix Tube Search — search archived YouTube videos via AI assistants.
Search over 1 billion YouTube videos indexed since 2005. Find deleted videos, metadata, thumbnails, and subtitles.
Quick Start
npx tube-search-mcp --api-key tsk_YOUR_KEY
Or with environment variable:
export TUBE_API_KEY=tsk_YOUR_KEY
npx tube-search-mcp
Get your API key at tube.archivarix.net (Profile → API Keys).
Configuration
Claude Desktop
Add to ~/.claude/claude_desktop_config.json:
{
"mcpServers": {
"tube-search": {
"command": "npx",
"args": ["-y", "tube-search-mcp"],
"env": {
"TUBE_API_KEY": "tsk_YOUR_KEY"
}
}
}
}
Claude Code
Add to ~/.claude/mcp.json:
{
"mcpServers": {
"tube-search": {
"command": "npx",
"args": ["-y", "tube-search-mcp"],
"env": {
"TUBE_API_KEY": "tsk_YOUR_KEY"
}
}
}
}
VS Code
Add to .vscode/mcp.json in your project:
{
"servers": {
"tube-search": {
"command": "npx",
"args": ["-y", "tube-search-mcp"],
"env": {
"TUBE_API_KEY": "tsk_YOUR_KEY"
}
}
}
}
Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"tube-search": {
"command": "npx",
"args": ["-y", "tube-search-mcp"],
"env": {
"TUBE_API_KEY": "tsk_YOUR_KEY"
}
}
}
}
Available Tools
| Tool | Description |
|---|---|
search_channel | Find all archived videos from a YouTube channel |
search_videos | Full-text search across video titles and descriptions |
get_video | Get metadata for a specific video by ID |
get_subtitles | Get transcript as readable plain text |
get_summary | Get AI-generated video summary |
generate_summary | Generate a new AI summary for a video |
browse_summaries | Browse summaries by tag, channel, or language |
get_video_status_history | View status change history of a video |
get_usage | Check your current API usage and limits |
Resources
| URI | Description |
|---|---|
tube://video/{videoId} | Video metadata |
tube://channel/{channelId} | Channel info |
tube://subtitles/{videoId} | Transcript as plain text |
tube://summary/{videoId} | AI-generated summary |
tube://tags | Popular summary tags |
Prompts
| Prompt | Description |
|---|---|
research_video | Comprehensive video analysis workflow |
channel_overview | Channel research and statistics |
find_deleted | Discover and analyze deleted videos |
Environment Variables
| Variable | Description | Default |
|---|---|---|
TUBE_API_KEY | API key (required) | — |
TUBE_MCP_URL | Custom MCP endpoint | https://tube.archivarix.net/mcp |
How It Works
This package acts as a stdio-to-HTTP proxy. It connects to the remote Archivarix Tube Search MCP server via Streamable HTTP and exposes the same tools, resources, and prompts over stdio transport for local AI clients.
AI Client ←(stdio)→ tube-search-mcp ←(HTTP)→ tube.archivarix.net/mcp
Documentation
Full documentation: tube.archivarix.net/guide/mcp
License
MIT