tabii-mcp 🇹🇷

mcp-name: io.github.mohammad-abbasi-sh/tabii-mcp

Unofficial read-only MCP server for tabii.com, TRT's streaming platform (launched 2023, 11M+ subscribers) — Turkish series, movies, documentaries, kids content and 15 live TRT channels. Catalog search by original Turkish title, full show details (seasons, episodes, cast, languages), live-channel HLS stream URLs, and cast/crew filmographies.

Built by Mohammad Abbasi as part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with tabii.com or TRT.

For AI agents

Add to your MCP client config (stdio):

{
  "mcpServers": {
    "tabii": {
      "command": "uvx",
      "args": ["tabii-mcp==0.1.0"]
    }
  }
}

Or run locally: python -m tabii_mcp.server (needs mcp<2, curl-cffi).

Tools

Example output (tabii_search_content / "gassal", language "en"):

{"id": 438813, "slug": "gassal", "title": "The Late Offices",
 "original_title": "Gassal", "content_type": "series", "made_year": 2024,
 "url": "https://www.tabii.com/en/detail/438813/gassal"}

How it works

tabii.com exposes a public catalog API that needs no login, no API key and no session token: eu1.tabii.com/apigateway/catalog/v1/public/shows/{id} and .../public/persons/{id} (the authenticated variants — search/v1, catalog/v1/show/{id} — return HTTP 401 without a Bearer session token and are not used). The homepage is server-rendered Next.js; its __NEXT_DATA__ JSON carries the featured sections and the 15 live channels with their public HLS URLs. Search scans the site's own sitemaps (EN + TR merged: 1,306 shows, 1,180 people — cached 6h) and resolves the top matches' localized titles through the public shows API. Two things are documented, not worked around: the sitemaps do not cover the whole catalog (some licensed titles, e.g. The Hobbit, and some originals are absent — they are still reachable by id, e.g. via the homepage sections), and genre/category browse pages are client-side shells fed by a login-gated endpoint, so no genre-browse tool is offered. Playback needs a logged-in Tabii Premium session and is out of scope — this server is catalog metadata only. Transport uses Chrome TLS impersonation (curl-cffi, rotation); requests are spaced ~0.8s apart; everything is read-only.

Install

uvx tabii-mcp==0.1.0        # run directly (needs uv)
# or
pip install tabii-mcp==0.1.0
tabii-mcp    # starts the MCP server on stdio

Tests

python -m venv .venv && .venv/bin/pip install -e .
.venv/bin/python -m unittest discover -s tests -v

Offline tests run on recorded fixtures (real pages/API responses fetched 2026-11-11); live tests hit tabii.com and the public API. Tests green at build time (see repo for counts) plus an MCP stdio smoke test.

Roadmap

• Genre browse if tabii ever publishes a session-free endpoint
• "New this week" / recently-added feed from the homepage sections
• Episode-level detail (per-episode description, audio/subtitle tracks)

License

MIT — see LICENSE.

Built by Mohammad Abbasi — Almanibama · mabbasi.ir