Server data from the Official MCP Registry
Unofficial read-only MCP server for tff.org: league standings, fixtures and match details.
About
Unofficial read-only MCP server for tff.org: league standings, fixtures and match details.
Security Report
Valid MCP server (1 strong, 4 medium validity signals). 4 known CVEs in dependencies Imported from the Official MCP Registry. Trust signals: trusted author (37/37 approved). 1 finding(s) downgraded by scanner intelligence.
8 files analyzed · 5 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"tff-mcp": {
"command": "uvx",
"args": [
"tff-mcp==0.1.1"
]
}
}
}Some servers take additional arguments. See the repository for details.
Documentation
View on GitHubFrom the project's GitHub README.
tff-mcp 🇹🇷
mcp-name: io.github.mohammad-abbasi-sh/tff-mcp
Unofficial read-only MCP server for tff.org, the Turkish Football Federation (TFF) — league standings (puan cetveli), fixtures and results (fikstür), full match details, and top scorers (gol krallığı) for 18 Turkish leagues, from the Süper Lig down to the youth development leagues.
Built by Mohammad Abbasi as part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with tff.org or the TFF.
For AI agents
Add to your MCP client config (stdio):
{
"mcpServers": {
"tff": {
"command": "uvx",
"args": ["tff-mcp==0.1.1"]
}
}
}
Or run locally: python -m tff_mcp.server (needs mcp<2, curl-cffi).
Tools
| Tool | Description |
|---|---|
tff_list_leagues | The 18 covered leagues (slug, Turkish name, TFF page id, multi-group flag, top-scorers availability) |
tff_standings | League standings — league slug (default "trendyol-super-lig"); group for multi-group leagues: index ("0"), group id, or name ("Kırmızı", "Beyaz", "01"); rank, team, played/won/drawn/lost, goals for/against, goal difference, points |
tff_fixtures | Fixtures and results — league slug; week to filter to one match-week; group for multi-group leagues; home/away, score (null when not yet played), status ("played"/"scheduled"), TFF match id and match-detail URL |
tff_match_detail | Full detail of one match — mac_id (as returned by tff_fixtures, e.g. "317874"); teams and score, date/time, stadium, league/season, match code, the officiating team (referee, assistants, VAR/AVAR, observer, representative), goals with minutes, both starting XIs |
tff_top_scorers | Top scorers — league: "trendyol-super-lig" (default), "trendyol-1-lig", "nesine-2-lig" or "nesine-3-lig" (the four leagues with a TFF scorers page); limit 1..50 |
Example output (tff_match_detail / Gaziantep FK 0–2 Kasımpaşa, 6 Nov 2026):
{"home": "GAZİANTEP FUTBOL KULÜBÜ A.Ş.", "away": "KASIMPAŞA A.Ş.",
"score_home": 0, "score_away": 2, "date": "6.11.2026", "time": "20:00",
"stadium": "GAZİANTEP STADYUMU - GAZİANTEP - ŞEHİTKAMİL",
"league": "Trendyol Süper Lig Adnan Süvari Sezonu (Profesyonel Takım)",
"match_code": "1091",
"officials": [{"name": "ÜMİT ÖZTÜRK", "role": "Hakem"},
{"name": "ERKAN ENGİN", "role": "VAR"}],
"goals": [{"player": "HARIS HAJRADINOVIC", "minute": 3, "type": "F"},
{"player": "ADRIAN DAWID BENEDYCZAK", "minute": 21, "type": "P"}]}
How it works
tff.org serves its league pages fully server-rendered — no login, no API key, no session cookies. Standings live in <table class="s-table"> (header O G B M A Y AV P); fixtures in <table class="fiksturListesiTable"> ("N.Hafta" headers, match rows with home club link, score link pageID=29&macId=..., away club link — unplayed matches show " - "). Multi-group leagues (Nesine 2. Lig, Nesine 3. Lig, BAL, women's and youth leagues) expose their groups as ?pageID=<id>&grupID=<n> links. Match details carry the teams in lnkTakim1/lnkTakim2, scores in MacDetaySayi spans, league/season in lblOrganizasyonAdi, match code in lblKod, date/time in lblTarih, the stadium as text between the code and the date, officials as NAME(ROLE) pairs, goals as "NAME,3.dk (F)" entries, and the starting XIs in the grdTakim1/2_rptKadrolar repeaters. Top scorers come from the rptGolKralligi repeater (pages 821/822/823/824). The site is legacy ASP.NET served as windows-1254, decoded explicitly. One site feature is documented, not faked: the weekly referees page (pageID=600) lists the 2./3. Lig rounds with EMPTY referee columns until appointments are announced close to match day — so referee data comes from the match-detail page instead. Transport uses Chrome TLS impersonation (curl-cffi, chrome120); requests are spaced ~0.8s apart; everything is read-only.
Install
uvx tff-mcp==0.1.1 # run directly (needs uv)
# or
pip install tff-mcp==0.1.1
tff-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 fetched 2026-11-09); live tests hit tff.org. 37/37 green at build time (20 offline + 17 live) plus an MCP stdio smoke test.
Roadmap
- Disciplinary decisions (PFDK/AFDK pages) and suspended players (pageID=633)
- Club pages (pageID=28&kulupID=...) — squad lists
- National-team matches (pageID=425)
License
MIT — see LICENSE.
Built by Mohammad Abbasi — Almanibama · mabbasi.ir
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
