tubescope MCP Client

Get tubescope's powerful YouTube analysis tools in Claude Desktop with zero installation required.

What is this?

This package connects Claude Desktop to tubescope's YouTube analysis tools. It provides instant access to:

• 📄 YouTube Transcript Extraction - Get transcripts from videos (single or batch)
• 🔍 Advanced Video Search - Search YouTube with powerful filters
• 🎣 Hook Analysis - Analyze viral video opening patterns
• 🖼️ Thumbnail Analysis - Extract and analyze thumbnail images
• 💬 Comment Analysis - Extract comments and replies from videos
• 📊 Channel Analytics - Comprehensive channel performance insights

Quick Start

1. Get Your API Key

Visit tubescopeai.com/api-keys to get your API key.

2. Configure Claude Desktop

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tubescope": {
      "command": "npx",
      "args": ["-y", "tubescope-mcp-client@latest"],
      "env": {
        "TUBESCOPE_API_KEY": "ytmcp_your_api_key_here"
      }
    }
  }
}

3. Restart Claude Desktop

That's it! You can now use tubescope tools in Claude Desktop.

Usage Examples

Extract a transcript:

Can you get the transcript for this YouTube video: https://www.youtube.com/watch?v=dQw4w9WgXcQ

Analyze video hooks:

Analyze the hooks from these viral videos to understand what makes them engaging:
- https://youtube.com/watch?v=abc123
- https://youtube.com/watch?v=def456

Search for videos:

Find the top 10 most popular coding tutorials uploaded in the last month

Analyze thumbnails:

Analyze the thumbnails from these videos and tell me what makes them clickable

How It Works

Claude Desktop ←→ tubescope-mcp-client ←→ tubescope Cloud

This thin client:

• ✅ Connects seamlessly to Claude Desktop
• ✅ Provides all tubescope YouTube tools
• ✅ Handles authentication automatically
• ✅ Updates automatically with @latest
• ❌ Does NOT store any data locally

Configuration Options

| Environment Variable | Default | Description | |---------------------|---------|-------------| | TUBESCOPE_API_KEY | (required) | Your API key from tubescopeai.com |

Troubleshooting

"API key not set" Error

• Get your API key from tubescopeai.com/api-keys
• Add it to your Claude Desktop config
• Restart Claude Desktop

"Invalid API key" Error

• Verify your API key starts with ytmcp_
• Check for typos in your config
• Generate a new key if needed

"Server unavailable" Error

• Check your internet connection
• Server may be temporarily down
• Try again in a few minutes

Connection Issues

• Ensure you're using the latest version: npx -y tubescope-mcp-client
• Check Claude Desktop logs for details
• Report issues via tubescopeai.com/support

Supported Plans

| Tool | Free | Pro | Business | Enterprise | |------|------|-----|----------|-----------| | Basic transcript extraction | ✅ | ✅ | ✅ | ✅ | | Video search | ✅ | ✅ | ✅ | ✅ | | Multiple transcripts | ❌ | ✅ | ✅ | ✅ | | Hook analysis | ❌ | ✅ | ✅ | ✅ | | Thumbnail analysis | ❌ | ✅ | ✅ | ✅ | | Title optimization | ❌ | ✅ | ✅ | ✅ | | Batch processing | ❌ | Limited | ✅ | ✅ |

Privacy & Security

• 🔒 API keys are passed via environment variables (secure)
• 🌐 All communication uses HTTPS encryption
• 💾 No local storage - thin client doesn't cache data
• 🚫 No tracking - we don't log personal information

Support

• 📖 Documentation: tubescopeai.com/docs
• 💬 Support: tubescopeai.com/support
• 📧 Email: [email protected]

License

MIT License