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