fernsehserien-mcp
# fernsehserien-mcp ๐บ
mcp-name: io.github.mohammad-abbasi-sh/fernsehserien-mcp
Unofficial **read-only** MCP server for **[fernsehserien.de](https://www.fernsehserien.de)** โ German TV series from fernsehserien.de (free, no key, no login): search series, series details, episode guides and upcoming air dates. No key, no login.
> Built by Mohammad Abbasi as part of the "Germany MCP factory". Not affiliated with fernsehserien.de.
## For AI agents
Add to your MCP client config (stdio):
```json
{
"mcpServers": {
"fernsehserien": {
"command": "uvx",
"args": ["fernsehserien-mcp==0.1.0"]
}
}
}
```
Or run locally: `python -m fernsehserien_mcp.server` (needs `mcp<2`, `httpx`).
## Tools
| Tool | Description |
|------|-------------|
| `fs_search_series` | Search TV series by name โ `query`, `limit` 1..20 |
| `fs_series_detail` | Series detail page: description, seasons, links to episode guide / air dates / streams โ `series` (slug or fernsehserien.de URL) |
| `fs_episodes` | Episode guide for one season: episode number, title, runtime, airings โ `series` (slug or URL), `season` (number), `limit` 1..20 |
| `fs_air_dates` | Upcoming air dates (Sendetermine) for a series: date/time, channel, episode โ `series` (slug or URL), `limit` 1..20 |
| `fs_health` | Reachability probe (ok / blocked / error) โ one polite request |
## Development
```bash
python3 -m venv .venv && .venv/bin/pip install "mcp<2" httpx pytest
.venv/bin/pip install -e .
.venv/bin/python -m pytest tests/ -q
```
## License
MIT
---
Built by [Mohammad Abbasi](https://github.com/mohammad-abbasi-sh) โ [Almanibama](https://almanibama.ir) ยท [mabbasi.ir](https://mabbasi.ir)
TDQS
Scored across 5 tools
Each tool covers a distinct slice of the domain: a connectivity probe, a name search, a series detail lookup, a season episode listing, and an upcoming-air-dates feed. There is no realistic way to confuse fs_search_series with fs_series_detail or fs_episodes with fs_air_dates, since their inputs and outputs are clearly separated.
All names share a consistent fs_ prefix and snake_case, and the search/detail/episodes/air_dates suffixes are predictable. The only minor deviation is fs_health, which is a status noun rather than the verb_noun pattern used by the others.
Five tools is a tight, well-scoped set for a read-only scraping server, and each tool maps to a concrete user question (is the site up, find a show, show info, episode list, what's airing). Nothing appears padded or missing at the count level.
The core lifecycle for a TV-guide domain is covered: discovery via search, enrichment via detail, and two distinct scheduling views (episodes, upcoming air dates), with a health check for reliability. Gaps remain around browsing by date/channel across all series or looking up individual episode details, which agents would have to work around indirectly.