tube search mcp

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