Metadata-Version: 2.4
Name: aidevtube-mcp
Version: 0.1.1
Summary: Semantic search over a curated, multilingual corpus of AI & coding YouTube video summaries — MCP server for the AI YouTube Digest API.
Project-URL: Homepage, https://aidevtube.com
Project-URL: Get an API key, https://aidevtube.com
Project-URL: Repository, https://github.com/miraculix95/aidevtube-mcp
Project-URL: Issues, https://github.com/miraculix95/aidevtube-mcp/issues
Author: Bastian Brand
License: MIT
Keywords: ai,claude,cursor,digest,llm,mcp,model-context-protocol,rag,semantic-search,youtube
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: fastmcp>=2.0
Requires-Dist: httpx>=0.27
Description-Content-Type: text/markdown

# aidevtube-mcp

**Semantic search over the entire AI & coding YouTube landscape — right inside your LLM.**

`aidevtube-mcp` is the official MCP server for the [**AI YouTube Digest**](https://aidevtube.com) —
a continuously growing, topic-tagged, multilingual corpus of **per-video summaries** from ~40
hand-curated AI & coding YouTube channels (Nate Herk, Tech With Tim, Theo, NeuralNine, WorldofAI,
and many more), updated every week.

Stop scrubbing through hours of video. Ask your agent *"what did the AI-dev world say about Claude
Code agents this month?"* and get straight, sourced answers — searched by **meaning**, not keywords,
across the whole back-catalogue.

## Why it's useful

- 🔎 **Semantic search** (hybrid vector + Cohere rerank) — finds videos by what they're *about*, not just exact words.
- 🗓️ **Longitudinal** — a week-by-week map of the AI/coding discourse, not just today's hype. Pro keys search the **full archive**.
- 🏷️ **Topic & channel filters** — narrow to "Claude Code & Anthropic-Tooling", a specific creator, etc.
- 🌍 **Multilingual** — summaries in English, German and French.
- 🔌 **Drop-in** — works in Claude Code, Claude Desktop, Cursor, or any MCP client. There's also a plain REST API (`api.aidevtube.com`).

## Quick start

Add to your MCP client (Claude Desktop / Claude Code / Cursor):

```json
{
  "mcpServers": {
    "aidevtube": {
      "command": "uvx",
      "args": ["aidevtube-mcp"],
      "env": { "AIDEVTUBE_API_KEY": "adt_your_key_here" }
    }
  }
}
```

Or run it directly:

```bash
AIDEVTUBE_API_KEY=adt_… uvx aidevtube-mcp
```

**Get an API key:** subscribe to Pro at [aidevtube.com](https://aidevtube.com) (€/$5 per month, incl.
1,000 API calls/month) → **Account → API** → generate your key.

## Tools

| Tool | Description |
|------|-------------|
| `search(query, topics, channel, lang, limit)` | Semantic search. Empty `query` = browse newest by filters. |
| `list_topics()` | The canonical topic labels for the `topics` filter. |

`search` returns `{results: [{title, url, channel, topics, published_at, summary}], count, quota_remaining}`.

### Example

> *"Find recent videos about building autonomous coding agents."*

```
search(query="autonomous coding agents", lang="en", limit=5)
```

## Configuration

| Env var | |
|---------|--|
| `AIDEVTUBE_API_KEY` | Your Pro API key (required). |
| `AIDEVTUBE_API_BASE` | Override the API base (default `https://api.aidevtube.com`). |

## Links

- 🌐 Homepage & subscription: **https://aidevtube.com**
- 📦 Source: https://github.com/miraculix95/aidevtube-mcp

MIT licensed.
