Skip to main content
Glama
README.md
# 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

A3.8/5.0

Scored across 5 tools

Disambiguation5/5

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.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues