tabii-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tabii-mcp Search tabii for Gassal and show me its cast and episode list"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Search the catalog by original Turkish title (e.g. "gassal", "mevlana") โ |
| Full detail of one title โ |
| Current homepage sections (exclusive content, series, movies, documentary, kids) with their titles โ |
| 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 |
| One cast/crew member by numeric person id (e.g. Ahmet Kural is 6774) โ name, job title, filmography on tabii |
| 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 stdioTests
python -m venv .venv && .venv/bin/pip install -e .
.venv/bin/python -m unittest discover -s tests -vOffline 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 toolstabii_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
Scored across 6 tools
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.
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.
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.
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
Related MCP Connectors
Unlock a world of television with the TV Maze MCP server. Effortlessly search for shows by name or
Trakt MCP โ TV/movie metadata + watch tracking signals
TVMaze MCP โ TV show metadata, episodes, schedules (no auth)
Movie and series ranking as MCP tools: top titles, search, lookup by IMDb id. Free, no key.
Related MCP Servers
- FlicenseAqualityDmaintenanceAn 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-
- FlicenseAqualityDmaintenanceAn 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-
- AlicenseAqualityDmaintenanceMCP server for the OMDb API - search movies, series, and episodes from any MCP-compatible client.5MIT
- AlicenseAqualityAmaintenancePython MCP server for TMDB search, Stremio library management, and Android TV playback/control over native ADB.56MIT