MCP Quickstart

Get Tube Search running in your AI assistant in 3 steps.

1
Create an API Key
Go to Profile → API and click "Generate API Key". Copy the key (starts with tsk_). You'll need an MCP + API subscription.
2
Add to Your AI Client
Choose your client below and add the configuration.

Claude Desktop

Edit ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "tube-search": {
      "command": "npx",
      "args": ["-y", "tube-search-mcp"],
      "env": {
        "TUBE_API_KEY": "tsk_YOUR_KEY_HERE"
      }
    }
  }
}

Claude Code

Edit ~/.claude/mcp.json:

{
  "mcpServers": {
    "tube-search": {
      "command": "npx",
      "args": ["-y", "tube-search-mcp"],
      "env": {
        "TUBE_API_KEY": "tsk_YOUR_KEY_HERE"
      }
    }
  }
}

Claude Desktop & Claude Code (Remote URL)

Both Claude Desktop and Claude Code also support connecting directly via Remote URL — no npm package needed:

{
  "mcpServers": {
    "tube-search": {
      "type": "url",
      "url": "https://tube.archivarix.net/mcp",
      "headers": {
        "Authorization": "Bearer tsk_YOUR_KEY_HERE"
      }
    }
  }
}

VS Code

Create .vscode/mcp.json in your project:

{
  "servers": {
    "tube-search": {
      "command": "npx",
      "args": ["-y", "tube-search-mcp"],
      "env": {
        "TUBE_API_KEY": "tsk_YOUR_KEY_HERE"
      }
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "tube-search": {
      "command": "npx",
      "args": ["-y", "tube-search-mcp"],
      "env": {
        "TUBE_API_KEY": "tsk_YOUR_KEY_HERE"
      }
    }
  }
}
3
Test It
Restart your AI client and try asking: "Search for deleted videos from the channel @YouTube" or "Get subtitles for video dQw4w9WgXcQ".
If using the npm package, the first run may take a moment while npx downloads the package. Subsequent runs start instantly.

Next Steps

← Back to MCP Guide