---

An intelligent Model Context Protocol (MCP) server that turns AI assistants into YouTube research powerhouses. Go beyond simple video searches—synthesize knowledge across multiple videos, extract structured concepts, and conduct deep research with AI-native tools.

!Production Ready

---

✨ What Makes This Different

$3

| Feature | anaisbetts | kimtaeyoon83 | ZubeidHendricks | yutu (Go) | YouTube MCP Tools |
| --- | --- | --- | --- | --- | --- |
| Transcripts | ✅ | ✅ | ✅ | ✅ | ✅ Multi-strategy fallback |
| Video metadata | ❌ | ❌ | ✅ | ✅ | ✅ Full |
| Channel analytics | ❌ | ❌ | ✅ | ✅ | ✅ Full |
| Playlist support | ❌ | ❌ | ✅ | ✅ | ✅ Full |
| Semantic chunking | ❌ | ❌ | ❌ | ❌ | ✅ Unique |
| Concept extraction | ❌ | ❌ | ❌ | ❌ | ✅ Unique |
| Multi-video synthesis | ❌ | ❌ | ❌ | ❌ | ✅ Unique |
| Research workflows | ❌ | ❌ | ❌ | ❌ | ✅ Unique |
| Learning path generation | ❌ | ❌ | ❌ | ❌ | ✅ Unique |
| Flashcard generation | ❌ | ❌ | ❌ | ❌ | ✅ Unique |
| Content repurposing | ❌ | ❌ | ❌ | ❌ | ✅ Unique |
| Smart caching | ❌ | ❌ | ⚠️ Basic | ❌ | ✅ Full LRU + TTL |
| Rate limiting | ❌ | ❌ | ❌ | ❌ | ✅ Quota-aware |

> The first YouTube MCP with an intelligence layer — we don't just fetch data, we understand it.

$3

| Traditional YouTube API | YouTube MCP Tools |
| --- | --- |
| Returns raw video data | Returns structured knowledge |
| Single video queries | Multi-video synthesis |
| Text search only | Semantic concept extraction |
| Manual transcript parsing | AI-ready chunked content |
| No cross-video analysis | Research synthesis with citations |
| No rate limiting | Smart quota management |
| Raw errors | Graceful error handling & recovery |

---

🚀 Quick Start

$3

``bash


Install globally

npm install -g youtube-mcp-tools

Or use directly with npx (no install needed)

npx youtube-mcp-tools
`

$3

Add to your VS Code settings.json:

`json
{
"mcp": {
"servers": {
"youtube": {
"command": "npx",
"args": ["-y", "youtube-mcp-tools"],
"env": {
"YOUTUBE_API_KEY": "your_api_key"
}
}
}
}
}
`

$3

Add to claude_desktop_config.json:

`json
{
"mcpServers": {
"youtube": {
"command": "npx",
"args": ["-y", "youtube-mcp-tools"],
"env": {
"YOUTUBE_API_KEY": "your_api_key"
}
}
}
}
`

---

🧠 Intelligence Layer

The magic happens in the intelligence layer—purpose-built for AI agents:

$3

> "Compare how these 5 videos explain React Server Components"
> → Returns consensus points, controversies, unique insights, and citations

$3

> "What concepts does this tutorial cover?"
> → Returns structured topics with difficulty levels, prerequisites, and relationships

$3

> "Prepare this 2-hour lecture for analysis"
> → Returns AI-optimized chunks respecting sentence boundaries and context

---

🛠️ Tools Overview

40 powerful tools + 3 MCP resources organized by capability:

| Category | Count | Highlights |
| --- | --- | --- |
| 🔍 Search & Discovery | 4 | Search, date filtering, related videos, trending |
| 📺 Channel Intelligence | 5 | Stats, analytics, popular videos, playlists |
| 🎬 Video Analysis | 6 | Details, comparison, comments, batch operations |
| 📝 Transcripts | 4 | Full captions, search, chunking, retrieval |
| 🧠 AI Intelligence | 5 | Deep analysis, concept extraction, research synthesis |
| 📚 Learning Tools | 5 | Flashcards, quizzes, learning paths, study guides, watch history |
| 🎨 Creator Tools | 2 | Content repurposing, gap analysis |
| 👤 User Preferences | 1 | Personalized recommendations, trusted/excluded channels |
| 🔮 Semantic Search | 5 | Vector embeddings, similarity search, clustering |
| 🔴 Live & Trending | 3 | Live streams, trending by region, categories |
| 📦 MCP Resources | 3 | Cache stats, quota status, preferences (zero cost) |

📖 Full Tool Reference → | 📚 Examples → | 🎬 Demo Guide →

---

🛡️ Production Ready

Built for reliability in production environments:

| Feature | Description |
| --- | --- |
| Rate Limiting | Smart quota management tracks API usage and prevents exhaustion |
| Graceful Shutdown | Clean termination with SIGINT/SIGTERM signal handling |
| Input Validation | Zod-based schema validation for all tool inputs |
| Config Validation | Fail-fast startup with clear error messages for missing config |
| Secure Logging | Automatic redaction of API keys and sensitive data |
| Error Recovery | Wrapped API calls with typed error handling |
| LRU Caching | Intelligent caching for transcripts and analysis results |
| ESLint | TypeScript-aware linting for code quality |

---

🎯 Use Cases

$3

- Synthesize knowledge from multiple educational videos
- Generate flashcards and quizzes from any tutorial
- Extract structured learning paths with prerequisites
- Compare teaching approaches across instructors

$3

- Analyze competitor content strategies
- Track trending topics in your niche
- Identify content gaps and opportunities
- Benchmark channel performance

$3

- Repurpose videos into blog posts, tweets, newsletters
- Generate podcast show notes from interviews
- Create short-form scripts from long content
- Plan content strategy with gap analysis

$3

- Build YouTube-powered research assistants
- Create automated content summarization pipelines
- Develop knowledge base builders from video content

---

🏗️ Architecture

`text
┌───────────────────────────────────────────────┐
│ MCP Protocol │
├───────────────────────────────────────────────┤
│ Tools (40) │ Prompts (5) │ Resources (3) │
├──────────────┴───────────────┴────────────────┤
│ Intelligence Layer │
│ ┌─────────┐ ┌──────────┐ ┌───────────┐ │
│ │ Chunker │ │ Analyzer │ │ Synthesis │ │
│ ├─────────┤ ├──────────┤ ├───────────┤ │
│ │ Quiz │ │ Learning │ │ Repurpose │ │
│ │Generator│ │ Path │ │ Content │ │
│ ├─────────┤ ├──────────┤ ├───────────┤ │
│ │ Watch │ │ Content │ │Flashcards │ │
│ │ History │ │ Gaps │ │ │ │
│ └─────────┘ └──────────┘ └───────────┘ │
├───────────────────────────────────────────────┤
│ Semantic Search Layer │
│ ┌─────────┐ ┌──────────┐ ┌───────────┐ │
│ │Embedding│ │ Vector │ │ Clustering│ │
│ │ Service │ │ Store │ │ (k-means)│ │
│ └─────────┘ └──────────┘ └───────────┘ │
├───────────────────────────────────────────────┤
│ Production Infrastructure │
│ ┌─────────┐ ┌──────────┐ ┌───────────┐ │
│ │ Rate │ │ Graceful │ │ Input │ │
│ │ Limiter │ │ Shutdown │ │ Validator │ │
│ └─────────┘ └──────────┘ └───────────┘ │
├───────────────────────────────────────────────┤
│ Cache Layer (LRU + Vectors) │
├───────────────────────────────────────────────┤
│ YouTube Data API v3 + Transcripts │
└───────────────────────────────────────────────┘
`

---

📈 Roadmap

- [x] Phase 1: Core YouTube API integration (18 tools)
- [x] Phase 2: Intelligence layer (analysis, synthesis)
- [x] Phase 3: Learning tools (flashcards, quizzes, learning paths)
- [x] Phase 4: Creator tools (content gaps, repurposing)
- [x] Phase 5: Personal insights (watch history analysis)
- [x] Phase 6: Semantic search & embeddings
- [ ] Phase 7: Knowledge graph & entity extraction
- [ ] Phase 8: Real-time streaming analysis

📋 Full Project Plan → | 🔮 Vision →

---

🔧 Development

`bash


Development mode with hot reload

npm run dev

Run tests

npm test

Build for production

npm run build
`

---

📊 API Quota Guide

YouTube Data API quota: 10,000 units/day

| Operation | Cost | Notes |
| --- | --- | --- |
| Search | 100 units | Use date ranges to narrow results |
| Video details | 1 unit | Batch up to 50 with video_list |
| Channel info | 1 unit | |
| Comments | 1 unit | |
| Transcripts | 0 units | Free! Use liberally |

💡 Pro Tip: Transcripts are quota-free. Use youtube_transcript and youtube_transcript_search` for deep content analysis without burning quota.

---

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

---

📄 License

MIT © 2026 Fabio Caversan

---

Built with 🧠 by Alex • Transforming how AI agents understand video content

_{© 2026 Fabio Caversan • Think. Build. Deploy.}