Skip to main content
Glama

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).

Related MCP server: moviefinder-mcp

Tools

Tool

Description

tabii_search_content

Search the catalog by original Turkish title (e.g. "gassal", "mevlana") โ€” language ("tr" default, "en", "es", "ar", "ur"), limit 1..10; id, slug, localized title, original title, type, year, URL per match

tabii_get_show

Full detail of one title โ€” show_id or slug (e.g. "gassal"); localized title, original title, type, year, genres, age restriction, seasons with episode titles + durations (capped at 60), cast, directors, writers, description, audio/subtitle languages, badges, trailer count, URL

tabii_homepage

Current homepage sections (exclusive content, series, movies, documentary, kids) with their titles โ€” language

tabii_live_channels

The 15 live TRT channels (TRT 1, TRT 2, TRT Belgesel, TRT Haber, TRT Spor, TRT ร‡ocuk, TRT World, ...) with watch URL and public HLS stream URL

tabii_get_person

One cast/crew member by numeric person id (e.g. Ahmet Kural is 6774) โ€” name, job title, filmography on tabii

tabii_health

Reachability probe (homepage + one public show) โ€” ok / blocked / error

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

Available Tools

6 tools
tabii_get_personA

One cast/crew member by numeric tabii person id (from a show's cast/directors/writers lists, e.g. Ahmet Kural is 6774). language: "tr" (default), "en", "es", "ar" or "ur". Returns name, job title and their filmography on tabii (title, original title, type, year, genres per show).

Inputs: person_id (required), language. Returns: result

tabii_get_showA

Full detail of one tabii title. Give show_id (numeric, from tabii_search_content) or slug (e.g. "gassal", "mevlana-celaleddin-i-rumi"). language: "tr" (default), "en", "es", "ar" or "ur". Returns localized title, original title, type, year, genres, age restriction, season count, seasons with episode titles + durations (capped at 60 episodes), cast, directors, writers, description, audio/subtitle languages, badges, trailer count and the tabii.com URL.

Inputs: slug, show_id, language. Returns: result

tabii_healthA

Check whether tabii.com is reachable right now.

Returns status ok (HTTP 200), blocked (HTTP 403/429 โ€” bot wall or rate limit) or error, plus the HTTP status and the probed URL. Two polite requests (homepage + one public show); it does not fetch any listings.

Inputs: no named parameters. Returns: result

tabii_homepageA

tabii's current homepage sections: exclusive content, series, movies, documentary and kids โ€” each with its titles (id, slug, localized title, short description). language: "tr" (default), "en", "es", "ar" or "ur". No arguments besides language.

Inputs: language. Returns: result

tabii_live_channelsA

The 15 live TRT channels on tabii (TRT 1, TRT 2, TRT Belgesel, TRT Haber, TRT Spor, TRT ร‡ocuk, TRT World, ...), each with id, title, slug, watch URL and the public HLS stream URL. language: "tr" (default), "en", "es", "ar" or "ur". No arguments besides language. Note: the streams are the site's public HLS URLs; actual playback may still need a tabii login for some channels.

Inputs: language. Returns: result

tabii_search_contentA

Search tabii's catalog by (original Turkish) title. query: a title or part of it, e.g. "gassal", "mevlana", "hobbit". language: "tr" (default), "en", "es", "ar" or "ur" โ€” the returned titles are localized to it. limit 1..10 (default 5). Returns id, slug, localized title, original title, type, year and tabii.com URL per match. Note: matching is against the original Turkish title/slug (the site's own search needs a login) and covers the 1,306 titles in the site's sitemaps โ€” some licensed titles (e.g. The Hobbit) are absent from the sitemaps and cannot be found this way; they are reachable by id via tabii_homepage's featured sections. English titles are shown on the matches but cannot be searched.

Inputs: query (required), limit, language. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    TDQS

    A4.3/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a clearly distinct resource: catalog search, single-title detail, homepage sections, live channels, person filmography, and a health probe. There is no meaningful overlap between title search and homepage browsing, or between show and person lookups.

    Naming Consistency4/5

    All names are snake_case with a consistent 'tabii_' prefix, and most follow a verb_noun pattern (search_content, get_show, get_person). A few are noun-only (homepage, live_channels, health), which is a minor deviation but still predictable and readable.

    Tool Count5/5

    Six tools is a well-scoped surface for a streaming-catalog server: search, detail, browse, live channels, people, and diagnostics. Each tool has a clear role and none feels redundant.

    Completeness4/5

    Core workflows (find a title, inspect it, browse homepage, list live channels, look up a person, verify availability) are covered. Gaps remain: search only matches original Turkish titles, some licensed titles are unreachable via search, and there is no genre/type browsing or episode-level retrieval.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      An MCP server that wraps The Movie Database (TMDB) API, enabling search for movies and TV shows, retrieval of movie details, recommendations, similar movies, trending content, streaming providers, and movie discovery.
      8
      -
    • F
      license
      A
      quality
      D
      maintenance
      An MCP server that wraps the TMDB API, enabling search of movies and TV shows, retrieval of details, trending titles, recommendations, and streaming provider information.
      8
      -
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for the OMDb API - search movies, series, and episodes from any MCP-compatible client.
      5
      MIT