Back to Browse

Tff MCP Server

Developer ToolsLow Risk8.3MCP RegistryLocal
Free

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

8.3
Low Risk8.3Low Risk

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.

HTTP Network Access

Connects to external APIs or services over the internet.

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 GitHub

From 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

ToolDescription
tff_list_leaguesThe 18 covered leagues (slug, Turkish name, TFF page id, multi-group flag, top-scorers availability)
tff_standingsLeague 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_fixturesFixtures 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_detailFull 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_scorersTop 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!