mackolik-mcp 0.1.0__tar.gz

mackolik_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,20 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write # required for PyPI trusted publishing (OIDC)
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

mackolik_mcp-0.1.0/.github/workflows/registry.yml

@@ -0,0 +1,61 @@
+name: Publish to MCP Registry
+
+# Official MCP Registry (registry.modelcontextprotocol.io) via GitHub OIDC.
+# No secret, no interactive login: the runner's OIDC token proves ownership
+# of the io.github.mohammad-abbasi-sh/* namespace.
+# Refs: https://github.com/modelcontextprotocol/registry
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write # required for OIDC -> MCP Registry
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Sync server.json version to tag
+        # Only sync when running on a version tag (v*). On workflow_dispatch
+        # (ref = refs/heads/main) keep the version committed in server.json.
+        run: |
+          VER=""
+          if [[ "$GITHUB_REF" == refs/tags/* ]]; then
+            TAG="${GITHUB_REF#refs/tags/}"
+            VER="${TAG#v}"
+          fi
+          if [ -n "$VER" ]; then
+            python3 - "$VER" << 'EOF'
+          import json, sys
+          ver = sys.argv[1]
+          d = json.load(open('server.json'))
+          d['version'] = ver
+          for pkg in d.get('packages', []):
+              pkg['version'] = ver
+          json.dump(d, open('server.json', 'w'), indent=2, ensure_ascii=False)
+          print('server.json version ->', ver)
+          EOF
+          else
+            echo "No version tag ($GITHUB_REF); keeping server.json version as-is"
+          fi
+
+      - name: Install mcp-publisher
+        run: |
+          curl -sL "https://github.com/modelcontextprotocol/registry/releases/download/v1.8.7/mcp-publisher_linux_amd64.tar.gz" -o /tmp/mcp-publisher.tar.gz
+          tar -xzf /tmp/mcp-publisher.tar.gz -C /tmp
+          sudo mv /tmp/mcp-publisher /usr/local/bin/mcp-publisher
+          mcp-publisher --version
+
+      - name: Validate server.json
+        run: mcp-publisher validate server.json
+
+      - name: Publish to MCP Registry (OIDC)
+        run: |
+          mcp-publisher login github-oidc
+          mcp-publisher publish server.json
+        # A registry outage must never break the release; re-run from Actions if needed.
+        continue-on-error: true

mackolik_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mohammad Abbasi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mackolik_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.5
+Name: mackolik-mcp
+Version: 0.1.0
+Summary: Unofficial read-only MCP server for mackolik.com live scores (live scores, results, fixtures, standings, match detail)
+Author: Mohammad Abbasi
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: curl-cffi>=0.7
+Requires-Dist: mcp<2
+Description-Content-Type: text/markdown
+
+# mackolik-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/mackolik-mcp
+
+Unofficial **read-only** MCP server for mackolik.com, Türkiye's #1 sports-scores app (~38M installs) — live scores, results, fixtures, league standings and match detail for football (and basketball) worldwide, with Turkish leagues first-class.
+
+> Built by Mohammad Abbasi as part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with mackolik.com. Built for Mackolik only — never Sahadan (same owner, same underlying data).
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "mackolik": {
+      "command": "uvx",
+      "args": ["mackolik-mcp"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m mackolik_mcp.server` (needs `mcp<2`, `curl-cffi`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `mackolik_live_scores` | Matches currently in play — `league` optional substring filter (e.g. "Süper Lig", "Premier Lig"), `limit` 1..50; minute, score, half-time, red cards, 1/X/2 odds |
+| `mackolik_results` | Finished matches for one date (default today) — `date` YYYY-MM-DD or DD/MM/YYYY, `league` filter, `limit` 1..50 |
+| `mackolik_fixtures` | Upcoming matches for one date (default today) — same params as results |
+| `mackolik_standings` | League standings — `league`: Tur (Türkiye Süper Lig), Eng (Premier Lig), Esp (LaLiga), Ita (Serie A), Ger (Bundesliga); rank, team, played, points, goal difference |
+| `mackolik_match_detail` | Full detail for one match by `match_id` (from the other tools) + optional `date` (the feed is per-day, so a past match needs its date) |
+
+Example output (`mackolik_live_scores` / 2026-11-07):
+
+```json
+{"total_live": 34, "matches": [
+  {"match_id": 4542744, "home_team": "Eyüpspor", "away_team": "Kocaelispor",
+   "league": "Süper Lig", "country": "Türkiye", "date": "07/11/2026",
+   "time": "13:30", "status": "live", "status_text": "17",
+   "score": "0-0", "odds_1": "3.46", "odds_x": "2.97", "odds_2": "1.78",
+   "url": "https://arsiv.mackolik.com/Futbol-Mac/4542744/eyupspor-kocaelispor"}, …]}
+```
+
+Example output (`mackolik_standings` / Tur):
+
+```json
+{"league": "Tur", "league_name": "Türkiye", "count": 9, "standings": [
+  {"rank": 1, "team": "Galatasaray", "played": 10, "points": 25,
+   "goal_difference": 11}, …]}
+```
+
+## How it works
+
+mackolik.com redirects to arsiv.mackolik.com (Akamai-fronted, no bot wall). The live data comes from the site's own JSON feed, `vd.mackolik.com/livedata`, which the site's JavaScript calls with `?group=0` (all of today, 836 matches on 2026-11-07) or `?date=DD/MM/YYYY` (1,370 matches for 07/11/2026) — no login, no API key. Match rows are arrays decoded against the site's own `livescore-go.js`: id, teams, status code, status text, score, half-time/red-card detail, kick-off time, 1/X/2 iddaa odds (display only), date, and league group (country, league, season). Status codes: 0/12 = not started, 1/3/5 = live (minute number in status_text — the site adds the `'` when rendering), 14/15/17 = basketball periods, 20 = extra time ("UZ"), 4/13 with "MS" = finished (Maç Sonu). A live/finished match with a blank score field is 0-0 (no goal scored yet). Standings come from the site's own widget handler (`Home/StandingHandler.aspx?league=Tur|Eng|Esp|Ita|Ger`). Transport uses Chrome TLS impersonation (`curl-cffi`, `chrome120`); requests are spaced ~0.8s apart; everything is read-only. Note: "Süper Lig" is also the league name in Greece, Switzerland, Serbia, Slovakia, India and Indonesia — filter by country via the league substring or check the `country` field.
+
+## Install
+
+```bash
+uvx mackolik-mcp        # run directly (needs uv)
+# or
+pip install mackolik-mcp
+mackolik-mcp    # starts the MCP server on stdio
+```
+
+## Tests
+
+```bash
+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 feed responses from 2026-11-07); live tests hit mackolik.com. 26/26 green at build time (14 offline + 12 live) plus an MCP stdio smoke test (34 live matches, Süper Lig leader Galatasaray 25 pts).
+
+## Roadmap
+
+- Goal scorers / match events (the detail page carries them for finished matches)
+- Basketball live scores as a first-class filter (sport field is already parsed)
+- Head-to-head / team form from the team pages
+
+## License
+
+MIT — see [LICENSE](LICENSE).

mackolik_mcp-0.1.0/README-fa.md

@@ -0,0 +1,85 @@
+# mackolik-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/mackolik-mcp
+
+سرور MCP غیررسمی و **فقط-خواندنی** برای mackolik.com، برنامهٔ شمارهٔ ۱ نتایج زندهٔ ورزشی ترکیه (~۳۸ میلیون نصب) — نتایج زنده، نتایج نهایی، برنامهٔ بازی‌ها، جدول لیگ‌ها و جزئیات مسابقه برای فوتبال (و بسکتبال) در سراسر جهان، با اولویت لیگ‌های ترکیه.
+
+> ساخته‌شده توسط محمد عباسی در چارچوب «کارخانهٔ MCP ترکیه» (خط تولید به سبک سپهر). وابسته به mackolik.com نیست. فقط برای Mackolik ساخته شده — هرگز Sahadan (همان مالک، همان دادهٔ زیرین).
+
+## برای ایجنت‌های هوش مصنوعی
+
+به پیکربندی MCP client خود اضافه کنید (stdio):
+
+```json
+{
+  "mcpServers": {
+    "mackolik": {
+      "command": "uvx",
+      "args": ["mackolik-mcp"]
+    }
+  }
+}
+```
+
+یا به‌صورت محلی اجرا کنید: `python -m mackolik_mcp.server` (نیازمند `mcp<2` و `curl-cffi`).
+
+## ابزارها
+
+| ابزار | توضیح |
+|------|-------|
+| `mackolik_live_scores` | بازی‌های در حال برگزاری — فیلتر اختیاری زیررشتهٔ `league` (مثلاً «Süper Lig»، «Premier Lig»)، `limit` ۱ تا ۵۰؛ دقیقه، نتیجه، نیمهٔ اول، کارت‌های قرمز، ضرایب ۱/X/۲ |
+| `mackolik_results` | بازی‌های تمام‌شدهٔ یک تاریخ (پیش‌فرض امروز) — `date` به‌صورت YYYY-MM-DD یا DD/MM/YYYY، فیلتر `league`، `limit` ۱ تا ۵۰ |
+| `mackolik_fixtures` | بازی‌های پیش‌روی یک تاریخ (پیش‌فرض امروز) — همان پارامترهای results |
+| `mackolik_standings` | جدول لیگ — `league`: Tur (سوپر لیگ ترکیه)، Eng (لیگ برتر)، Esp (لالیگا)، Ita (سری A)، Ger (بوندس‌لیگا)؛ رتبه، تیم، بازی، امتیاز، تفاضل گل |
+| `mackolik_match_detail` | جزئیات کامل یک مسابقه با `match_id` (از ابزارهای دیگر) + `date` اختیاری (فید روزانه است، پس برای بازی گذشته تاریخ لازم است) |
+
+خروجی نمونه (`mackolik_live_scores` / ۲۰۲۶-۱۱-۰۷):
+
+```json
+{"total_live": 34, "matches": [
+  {"match_id": 4542744, "home_team": "Eyüpspor", "away_team": "Kocaelispor",
+   "league": "Süper Lig", "country": "Türkiye", "date": "07/11/2026",
+   "time": "13:30", "status": "live", "status_text": "17",
+   "score": "0-0", "odds_1": "3.46", "odds_x": "2.97", "odds_2": "1.78",
+   "url": "https://arsiv.mackolik.com/Futbol-Mac/4542744/eyupspor-kocaelispor"}, …]}
+```
+
+خروجی نمونه (`mackolik_standings` / Tur):
+
+```json
+{"league": "Tur", "league_name": "Türkiye", "count": 9, "standings": [
+  {"rank": 1, "team": "Galatasaray", "played": 10, "points": 25,
+   "goal_difference": 11}, …]}
+```
+
+## نحوهٔ کار
+
+mackolik.com به arsiv.mackolik.com هدایت می‌شود (جلوِ Akamai، بدون دیوار ربات). دادهٔ زنده از فید JSON خود سایت می‌آید: `vd.mackolik.com/livedata` — جاوااسکریپت سایت آن را با `?group=0` (کل امروز، ۸۳۶ مسابقه در ۲۰۲۶-۱۱-۰۷) یا `?date=DD/MM/YYYY` (۱٬۳۷۰ مسابقه برای ۰۷/۱۱/۲۰۲۶) فرامی‌خواند؛ بدون ورود و کلید API. ردیف‌های مسابقه آرایه‌هایی‌اند که بر اساس فایل `livescore-go.js` خود سایت رمزگشایی شده‌اند: شناسه، تیم‌ها، کد وضعیت، متن وضعیت، نتیجه، جزئیات نیمهٔ اول/کارت قرمز، ساعت شروع، ضرایب ۱/X/۲ (فقط نمایشی)، تاریخ و گروه لیگ (کشور، لیگ، فصل). کدهای وضعیت: ۰/۱۲ = شروع‌نشده، ۱/۳/۵ = زنده (عدد دقیقه در status_text — سایت علامت `'` را هنگام نمایش اضافه می‌کند)، ۱۴/۱۵/۱۷ = وقت‌های بسکتبال، ۲۰ = وقت اضافه («UZ»)، ۴/۱۳ با «MS» = تمام‌شده (Maç Sonu). مسابقهٔ زنده/تمام‌شده با فیلد نتیجهٔ خالی ۰-۰ است (هنوز گلی زده نشده). جدول‌ها از هندلر ویجت خود سایت می‌آیند (`Home/StandingHandler.aspx?league=Tur|Eng|Esp|Ita|Ger`). انتقال با جعل TLS کروم انجام می‌شود (`curl-cffi`، `chrome120`)؛ درخواست‌ها با فاصلهٔ ‎~۰٫۸ ثانیه فرستاده می‌شوند؛ همه‌چیز فقط-خواندنی است. توجه: «Süper Lig» نام لیگ در یونان، سوئیس، صربستان، اسلواکی، هند و اندونزی هم هست — فیلد `country` را بررسی کنید.
+
+## نصب
+
+```bash
+uvx mackolik-mcp        # اجرای مستقیم (نیازمند uv)
+# یا
+pip install mackolik-mcp
+mackolik-mcp    # سرور MCP را روی stdio راه می‌اندازد
+```
+
+## تست‌ها
+
+```bash
+python -m venv .venv && .venv/bin/pip install -e .
+.venv/bin/python -m unittest discover -s tests -v
+```
+
+تست‌های آفلاین روی داده‌های ضبط‌شده اجرا می‌شوند (پاسخ‌های واقعی فید از ۲۰۲۶-۱۱-۰۷)؛ تست‌های زنده به mackolik.com وصل می‌شوند. در زمان ساخت ۲۶ از ۲۶ سبز بود (۱۴ آفلاین + ۱۲ زنده) به‌همراه یک تست دود MCP روی stdio (۳۴ مسابقهٔ زنده، صدرنشین سوپر لیگ گالاتاسرای با ۲۵ امتیاز).
+
+## نقشهٔ راه
+
+- گل‌زنان / رویدادهای مسابقه (صفحهٔ جزئیات برای بازی‌های تمام‌شده آن‌ها را دارد)
+- نتایج زندهٔ بسکتبال به‌عنوان فیلتر درجه‌یک (فیلد sport همین حالا تجزیه می‌شود)
+- بازی‌های روبه‌رو / فرم تیم از صفحه‌های تیم
+
+## مجوز
+
+MIT — ببینید [LICENSE](LICENSE).

mackolik_mcp-0.1.0/README-tr.md

@@ -0,0 +1,85 @@
+# mackolik-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/mackolik-mcp
+
+mackolik.com için resmi olmayan **salt okunur** MCP sunucusu — Türkiye'nin 1 numaralı canlı skor uygulaması (~38 milyon indirme): dünya genelinde futbol (ve basketbol) için canlı skorlar, sonuçlar, fikstürler, puan durumları ve maç detayları; Türkiye ligleri öncelikli.
+
+> Mohammad Abbasi tarafından "Turkey MCP factory" (Sepehr tarzı hat) kapsamında geliştirildi. mackolik.com ile bağlantısı yoktur. Yalnızca Mackolik için geliştirildi — Sahadan asla (aynı sahip, aynı veri).
+
+## Yapay zekâ ajanları için
+
+MCP istemci yapılandırmanıza ekleyin (stdio):
+
+```json
+{
+  "mcpServers": {
+    "mackolik": {
+      "command": "uvx",
+      "args": ["mackolik-mcp"]
+    }
+  }
+}
+```
+
+Veya yerel çalıştırın: `python -m mackolik_mcp.server` (`mcp<2`, `curl-cffi` gerekir).
+
+## Araçlar
+
+| Araç | Açıklama |
+|------|----------|
+| `mackolik_live_scores` | Şu an oynanan maçlar — `league` isteğe bağlı alt dize filtresi (örn. "Süper Lig", "Premier Lig"), `limit` 1..50; dakika, skor, ilk yarı, kırmızı kartlar, 1/X/2 oranları |
+| `mackolik_results` | Bir tarihte biten maçlar (varsayılan bugün) — `date` YYYY-MM-DD veya DD/MM/YYYY, `league` filtresi, `limit` 1..50 |
+| `mackolik_fixtures` | Bir tarihte oynanacak maçlar (varsayılan bugün) — results ile aynı parametreler |
+| `mackolik_standings` | Lig puan durumu — `league`: Tur (Türkiye Süper Lig), Eng (Premier Lig), Esp (LaLiga), Ita (Serie A), Ger (Bundesliga); sıra, takım, oynanan, puan, averaj |
+| `mackolik_match_detail` | Bir maçın tüm detayı — `match_id` (diğer araçlardan) + isteğe bağlı `date` (akış günlük olduğu için geçmiş maçın tarihi gerekir) |
+
+Örnek çıktı (`mackolik_live_scores` / 2026-11-07):
+
+```json
+{"total_live": 34, "matches": [
+  {"match_id": 4542744, "home_team": "Eyüpspor", "away_team": "Kocaelispor",
+   "league": "Süper Lig", "country": "Türkiye", "date": "07/11/2026",
+   "time": "13:30", "status": "live", "status_text": "17",
+   "score": "0-0", "odds_1": "3.46", "odds_x": "2.97", "odds_2": "1.78",
+   "url": "https://arsiv.mackolik.com/Futbol-Mac/4542744/eyupspor-kocaelispor"}, …]}
+```
+
+Örnek çıktı (`mackolik_standings` / Tur):
+
+```json
+{"league": "Tur", "league_name": "Türkiye", "count": 9, "standings": [
+  {"rank": 1, "team": "Galatasaray", "played": 10, "points": 25,
+   "goal_difference": 11}, …]}
+```
+
+## Nasıl çalışıyor?
+
+mackolik.com, arsiv.mackolik.com'a yönlendirir (Akamai ön yüzü, bot duvarı yok). Canlı veriler sitenin kendi JSON akışından gelir: `vd.mackolik.com/livedata` — sitenin JavaScript'i `?group=0` (bugünün tamamı, 2026-11-07'de 836 maç) veya `?date=DD/MM/YYYY` (07/11/2026 için 1.370 maç) ile çağırır; giriş ve API anahtarı gerekmez. Maç satırları, sitenin kendi `livescore-go.js` dosyasına göre çözümlenen dizilerdir: id, takımlar, durum kodu, durum metni, skor, ilk yarı/kırmızı kart detayı, başlama saati, 1/X/2 iddaa oranları (yalnızca bilgi amaçlı), tarih ve lig grubu (ülke, lig, sezon). Durum kodları: 0/12 = başlamadı, 1/3/5 = canlı (dakika sayısı status_text'te — site `'` işaretini render ederken ekler), 14/15/17 = basketbol periyotları, 20 = uzatma ("UZ"), 4/13 ve "MS" = bitti (Maç Sonu). Skoru boş olan canlı/bitmiş maç 0-0'dır (henüz gol yok). Puan durumu sitenin kendi widget işleyicisinden gelir (`Home/StandingHandler.aspx?league=Tur|Eng|Esp|Ita|Ger`). Aktarım Chrome TLS kimliğine bürünme kullanır (`curl-cffi`, `chrome120`); istekler ~0,8 sn arayla yapılır; her şey salt okunurdur. Not: "Süper Lig" aynı zamanda Yunanistan, İsviçre, Sırbistan, Slovakya, Hindistan ve Endonezya'da da lig adıdır — `country` alanını kontrol edin.
+
+## Kurulum
+
+```bash
+uvx mackolik-mcp        # doğrudan çalıştır (uv gerekir)
+# veya
+pip install mackolik-mcp
+mackolik-mcp    # MCP sunucusunu stdio üzerinde başlatır
+```
+
+## Testler
+
+```bash
+python -m venv .venv && .venv/bin/pip install -e .
+.venv/bin/python -m unittest discover -s tests -v
+```
+
+Çevrimdışı testler kayıtlı örnek verilerle çalışır (2026-11-07'den gerçek akış yanıtları); canlı testler mackolik.com'a bağlanır. Derleme anında 26/26 yeşil (14 çevrimdışı + 12 canlı) ve bir MCP stdio duman testi (34 canlı maç, Süper Lig lideri Galatasaray 25 puan).
+
+## Yol haritası
+
+- Gol atanlar / maç olayları (detay sayfası biten maçlarda bunları taşır)
+- Basketbol canlı skorları birinci sınıf filtre olarak (sport alanı zaten ayrıştırılıyor)
+- Takım sayfalarından karşılıklı maçlar / form durumu
+
+## Lisans
+
+MIT — bkz. [LICENSE](LICENSE).

mackolik_mcp-0.1.0/README.md

@@ -0,0 +1,85 @@
+# mackolik-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/mackolik-mcp
+
+Unofficial **read-only** MCP server for mackolik.com, Türkiye's #1 sports-scores app (~38M installs) — live scores, results, fixtures, league standings and match detail for football (and basketball) worldwide, with Turkish leagues first-class.
+
+> Built by Mohammad Abbasi as part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with mackolik.com. Built for Mackolik only — never Sahadan (same owner, same underlying data).
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "mackolik": {
+      "command": "uvx",
+      "args": ["mackolik-mcp"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m mackolik_mcp.server` (needs `mcp<2`, `curl-cffi`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `mackolik_live_scores` | Matches currently in play — `league` optional substring filter (e.g. "Süper Lig", "Premier Lig"), `limit` 1..50; minute, score, half-time, red cards, 1/X/2 odds |
+| `mackolik_results` | Finished matches for one date (default today) — `date` YYYY-MM-DD or DD/MM/YYYY, `league` filter, `limit` 1..50 |
+| `mackolik_fixtures` | Upcoming matches for one date (default today) — same params as results |
+| `mackolik_standings` | League standings — `league`: Tur (Türkiye Süper Lig), Eng (Premier Lig), Esp (LaLiga), Ita (Serie A), Ger (Bundesliga); rank, team, played, points, goal difference |
+| `mackolik_match_detail` | Full detail for one match by `match_id` (from the other tools) + optional `date` (the feed is per-day, so a past match needs its date) |
+
+Example output (`mackolik_live_scores` / 2026-11-07):
+
+```json
+{"total_live": 34, "matches": [
+  {"match_id": 4542744, "home_team": "Eyüpspor", "away_team": "Kocaelispor",
+   "league": "Süper Lig", "country": "Türkiye", "date": "07/11/2026",
+   "time": "13:30", "status": "live", "status_text": "17",
+   "score": "0-0", "odds_1": "3.46", "odds_x": "2.97", "odds_2": "1.78",
+   "url": "https://arsiv.mackolik.com/Futbol-Mac/4542744/eyupspor-kocaelispor"}, …]}
+```
+
+Example output (`mackolik_standings` / Tur):
+
+```json
+{"league": "Tur", "league_name": "Türkiye", "count": 9, "standings": [
+  {"rank": 1, "team": "Galatasaray", "played": 10, "points": 25,
+   "goal_difference": 11}, …]}
+```
+
+## How it works
+
+mackolik.com redirects to arsiv.mackolik.com (Akamai-fronted, no bot wall). The live data comes from the site's own JSON feed, `vd.mackolik.com/livedata`, which the site's JavaScript calls with `?group=0` (all of today, 836 matches on 2026-11-07) or `?date=DD/MM/YYYY` (1,370 matches for 07/11/2026) — no login, no API key. Match rows are arrays decoded against the site's own `livescore-go.js`: id, teams, status code, status text, score, half-time/red-card detail, kick-off time, 1/X/2 iddaa odds (display only), date, and league group (country, league, season). Status codes: 0/12 = not started, 1/3/5 = live (minute number in status_text — the site adds the `'` when rendering), 14/15/17 = basketball periods, 20 = extra time ("UZ"), 4/13 with "MS" = finished (Maç Sonu). A live/finished match with a blank score field is 0-0 (no goal scored yet). Standings come from the site's own widget handler (`Home/StandingHandler.aspx?league=Tur|Eng|Esp|Ita|Ger`). Transport uses Chrome TLS impersonation (`curl-cffi`, `chrome120`); requests are spaced ~0.8s apart; everything is read-only. Note: "Süper Lig" is also the league name in Greece, Switzerland, Serbia, Slovakia, India and Indonesia — filter by country via the league substring or check the `country` field.
+
+## Install
+
+```bash
+uvx mackolik-mcp        # run directly (needs uv)
+# or
+pip install mackolik-mcp
+mackolik-mcp    # starts the MCP server on stdio
+```
+
+## Tests
+
+```bash
+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 feed responses from 2026-11-07); live tests hit mackolik.com. 26/26 green at build time (14 offline + 12 live) plus an MCP stdio smoke test (34 live matches, Süper Lig leader Galatasaray 25 pts).
+
+## Roadmap
+
+- Goal scorers / match events (the detail page carries them for finished matches)
+- Basketball live scores as a first-class filter (sport field is already parsed)
+- Head-to-head / team form from the team pages
+
+## License
+
+MIT — see [LICENSE](LICENSE).

mackolik_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mackolik-mcp"
+version = "0.1.0"
+description = "Unofficial read-only MCP server for mackolik.com live scores (live scores, results, fixtures, standings, match detail)"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+dependencies = [
+    "mcp<2",
+    "curl-cffi>=0.7",
+]
+authors = [{ name = "Mohammad Abbasi" }]
+
+[project.scripts]
+mackolik-mcp = "mackolik_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mackolik_mcp"]

mackolik_mcp-0.1.0/server.json

@@ -0,0 +1 @@
+{"$schema":"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json","description":"Unofficial read-only MCP server for mackolik.com live scores, results, fixtures, standings.","name":"io.github.mohammad-abbasi-sh/mackolik-mcp","packages":[{"identifier":"mackolik-mcp","registryBaseUrl":"https://pypi.org","registryType":"pypi","transport":{"type":"stdio"},"version":"0.1.0"}],"repository":{"source":"github","url":"https://github.com/mohammad-abbasi-sh/mackolik-mcp"},"title":"mackolik.com Live Scores","version":"0.1.0","websiteUrl":"https://github.com/mohammad-abbasi-sh/mackolik-mcp"}

mackolik_mcp-0.1.0/src/mackolik_mcp/__init__.py

@@ -0,0 +1 @@
+"""mackolik_mcp — unofficial read-only MCP server for mackolik.com."""

mackolik_mcp-0.1.0/src/mackolik_mcp/http.py

@@ -0,0 +1,82 @@
+"""HTTP layer for mackolik_mcp.
+
+mackolik.com redirects to arsiv.mackolik.com (Akamai-fronted, no
+bot wall — plain 200). The live-scores data comes from the site's
+own JSON feed, vd.mackolik.com/livedata, which the site's JS
+(livescore-go.js) calls with ?group=<id> (0 = all) or
+?date=DD/MM/YYYY — no login, no API key. Standings come from the
+site's own handler, arsiv.mackolik.com/Home/StandingHandler.aspx
+?league=Tur|Eng|Esp|Ita|Ger (the homepage standings widget calls
+exactly this). The transport uses curl-cffi chrome120
+impersonation, the same proven pattern as the other
+Turkey-factory servers. Requests are kept gentle (one at a time,
+~0.8s apart) and read-only.
+
+Verified live 2026-11-07: livedata?group=0 -> 288KB JSON, 836
+matches for the day; livedata?date=07/11/2026 -> 471KB JSON;
+StandingHandler Tur -> 10-row Süper Lig table.
+"""
+from __future__ import annotations
+
+import time
+from urllib.parse import quote
+
+from curl_cffi import requests as _r
+
+VD_BASE = "https://vd.mackolik.com/livedata"
+ARSIV_BASE = "https://arsiv.mackolik.com"
+TIMEOUT = 30.0
+MIN_INTERVAL = 0.8  # seconds between requests — be polite
+
+_HEADERS = {
+    "Accept-Language": "tr-TR,tr;q=0.9,en;q=0.8",
+    "Accept": "application/json, text/html, */*",
+    "Referer": "https://arsiv.mackolik.com/Canli-Sonuclar",
+}
+
+_last_fetch = 0.0
+
+
+class MackolikError(RuntimeError):
+    pass
+
+
+def _get(url: str) -> str:
+    global _last_fetch
+    wait = MIN_INTERVAL - (time.monotonic() - _last_fetch)
+    if wait > 0:
+        time.sleep(wait)
+    try:
+        resp = _r.get(url, impersonate="chrome120", headers=_HEADERS, timeout=TIMEOUT)
+    except Exception as e:
+        raise MackolikError(f"network error fetching {url}: {e}") from e
+    finally:
+        _last_fetch = time.monotonic()
+    if resp.status_code == 403:
+        raise MackolikError(
+            "mackolik.com refused the request (HTTP 403, bot wall) — try again later"
+        )
+    if resp.status_code == 429:
+        raise MackolikError(
+            "mackolik.com rate-limited the request (HTTP 429) — try again later"
+        )
+    if resp.status_code == 404:
+        raise MackolikError(f"page not found (HTTP 404): {url}")
+    if resp.status_code != 200:
+        raise MackolikError(f"unexpected HTTP {resp.status_code} fetching {url}")
+    return resp.text
+
+
+def fetch_livedata_group(group: int = 0) -> str:
+    """Live feed for a group (0 = all matches, live + today)."""
+    return _get(f"{VD_BASE}?group={group}")
+
+
+def fetch_livedata_date(date_tr: str) -> str:
+    """Live feed for one date, DD/MM/YYYY (the site's own format)."""
+    return _get(f"{VD_BASE}?date={quote(date_tr, safe='')}")
+
+
+def fetch_standings(league: str) -> str:
+    """Standings widget HTML for Tur|Eng|Esp|Ita|Ger."""
+    return _get(f"{ARSIV_BASE}/Home/StandingHandler.aspx?league={quote(league)}")