beyazperde-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
beyazperde-mcp 🇹🇷
mcp-name: io.github.mohammad-abbasi-sh/beyazperde-mcp
Unofficial read-only MCP server for Beyazperde (beyazperde.com) — Turkey's leading cinema portal (the Turkish AlloCiné). List the films currently in cinemas, search films by title, get one film's detail (synopsis, release date, duration, genres, director, cast, member/press ratings), list today's showtimes for a film in any of 85 cities, and read the latest film news.
Built by Mohammad Abbasi as part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with Beyazperde or Webedia.
Note: showtimes are for today only — the site's date parameter does not change the server response (date filtering is client-side). New films have no ratings yet (ratings: {}). The site is Turkish-language; titles, genres and synopses are returned in Turkish. Movie search uses the site's autocomplete JSON endpoint — the site's own search page renders no server-side results.
For AI agents
Add to your MCP client config (stdio):
{
"mcpServers": {
"beyazperde": {
"command": "uvx",
"args": ["beyazperde-mcp==0.1.0"]
}
}
}Or run locally: python -m beyazperde_mcp.server (needs mcp<2, httpx>=0.27).
Related MCP server: hepsiburada-mcp
Tools
Tool | Description |
| Films currently in cinemas — |
| Search films by title — |
| Detail of one film — |
| Today's showtimes for one film in a city — |
| Latest film news — |
| The 85 showtimes cities — geocode + name (e.g. "154167" İstanbul), including the 4 Northern-Cyprus cities |
| Check whether Beyazperde is reachable (ok / blocked / error) |
Example output (beyazperde_showtimes / Çirko, İstanbul, 2026-11-14):
{"film_id": "1000013643", "city": "İstanbul", "geocode": "154167",
"count": 30,
"cinemas": [{"cinema_id": "T0211", "name": "City’s Nişantaşı – CINEWAM Premium",
"address": "Tesvikiye Cad. No:192 K:6 34365 Sisli",
"showtimes": [{"date": "14 Kasım 2026", "version": "Türkçe Dublajlı",
"time": "11:00", "datetime": "2026-11-14T11:00:00+03:00"}]}]}How it works
Everything is plain HTTP GETs against beyazperde.com with a Chrome user-agent (no bot wall, no login, no API key — verified 2026-11-14). Now showing is /filmler/vizyondakiler/sinema-sayisi/ (li.mdl > div.card.entity-card cards); search is the autocomplete JSON endpoint /_/autocomplete/movie/<query> (only entity_type == "movie" kept); film detail is /filmler/film-<id>/ (og:title / og:description / og:image, .meta-body-info for date/duration/genres, .rating-item blocks for ratings); showtimes are /filmler/film-<id>/seanslar/civarinda-<geocode>/ (.theater-card blocks, identical (date, version, time) triples deduped — the page repeats times across duplicate version blocks); news is /haberler/filmler/ (deduplicated by id); cities are /sinemalar/ region links plus the 4 Northern-Cyprus entries from the embedded 85-city geocode map (parsed from the showtimes page's city selector, 2026-11-14). A wrong geocode returns the site's 404 page, so cities are validated before fetching. Requests are spaced ~0.5s apart; everything is read-only.
Install
uvx beyazperde-mcp==0.1.0 # run directly (needs uv)
# or
pip install beyazperde-mcp==0.1.0
beyazperde-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 fetched 2026-11-14); live tests hit beyazperde.com (structure/range assertions, no exact values). Tests green at build time (see repo for counts) plus an MCP stdio smoke test.
Roadmap
Showtimes for a chosen date (once the site's client-side date filtering is understood)
Coming-soon films (
/filmler/yakinda/)Trailer / video links per film
License
MIT — see LICENSE.
Built by Mohammad Abbasi — Almanibama · mabbasi.ir
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Upcoming theatre, concerts, stand-up, exhibitions and festivals in Türkiye. Read-only, no sign-in.
Turkey data API for AI agents: 40 tools + search/call for 230+ endpoints. Addresses (provinces, districts, postal codes, boundaries), validation (IBAN, tax ID/VKN, TCKN, phone, barcode), tax and salary calculators, Official Gazette, exchange rates, gold, crypto, economic indicators, prayer times, holidays and business days, weather, air quality, earthquakes, dam levels, fuel prices, EV charging, power outages, tolls, pharmacies on duty, football standings. Turkish JSON, free plan.
Read-only tools for current SofiaStage events, venues, cities, performers, and editorial.
Read-only Istanbul open city data: transport, parking, water, nearby services and datasets.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceProvides access to The Movie Database (TMDB) API for searching movies, retrieving movie details, cast information, and browsing current, upcoming, popular, and top-rated films, as well as searching for actors and directors.48 npm-
- AlicenseAqualityBmaintenanceEnables read-only product search, product-detail lookup, review retrieval, category browsing, and price statistics for a Turkish e-commerce marketplace.6MIT
- AlicenseAqualityBmaintenanceEnables read-only access to Turkish technology news and forum content, including latest articles, keyword search, full article text, section listings, and current hot forum topics.6MIT
- AlicenseAqualityBmaintenanceEnables read-only discovery and retrieval of Biletix.com event information, including trending and featured listings, keyword and city search, detailed event data with venue/price/availability, categories, and upcoming events by venue.6MIT