chore: Bump version to 0.1.2 for clean PyPI release

- Update pyproject.toml with PyPI metadata
- Add GitHub Actions workflow for automated publishing
- Bump version to 0.1.1
- Add proper classifiers and keywords for PyPI
- Configure build system with setuptools

.dockerignore

@@ -0,0 +1,186 @@
+# flyctl launch added from .gitignore
+# Byte-compiled / optimized / DLL files
+**/__pycache__
+**/*.py[cod]
+**/*$py.class
+
+# C extensions
+**/*.so
+
+# Distribution / packaging
+**/.Python
+**/build
+**/develop-eggs
+**/dist
+**/downloads
+**/eggs
+**/.eggs
+**/lib
+**/lib64
+**/parts
+**/sdist
+**/var
+**/wheels
+**/share/python-wheels
+**/*.egg-info
+**/.installed.cfg
+**/*.egg
+**/MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+**/*.manifest
+**/*.spec
+
+# Installer logs
+**/pip-log.txt
+**/pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+**/htmlcov
+**/.tox
+**/.nox
+**/.coverage
+**/.coverage.*
+**/.cache
+**/nosetests.xml
+**/coverage.xml
+**/*.cover
+**/*.py,cover
+**/.hypothesis
+**/.pytest_cache
+**/cover
+
+# Translations
+**/*.mo
+**/*.pot
+
+# Django stuff:
+**/*.log
+**/local_settings.py
+**/db.sqlite3
+**/db.sqlite3-journal
+
+# Flask stuff:
+**/instance
+**/.webassets-cache
+
+# Scrapy stuff:
+**/.scrapy
+
+# Sphinx documentation
+**/docs/_build
+
+# PyBuilder
+**/.pybuilder
+**/target
+
+# Jupyter Notebook
+**/.ipynb_checkpoints
+
+# IPython
+**/profile_default
+**/ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+**/.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+**/__pypackages__
+
+# Celery stuff
+**/celerybeat-schedule
+**/celerybeat.pid
+
+# SageMath parsed files
+**/*.sage.py
+
+# Environments
+**/.env
+**/.venv
+**/env
+**/venv
+**/ENV
+**/env.bak
+**/venv.bak
+
+# Spyder project settings
+**/.spyderproject
+**/.spyproject
+
+# Rope project settings
+**/.ropeproject
+
+# mkdocs documentation
+site
+
+# mypy
+**/.mypy_cache
+**/.dmypy.json
+**/dmypy.json
+
+# Pyre type checker
+**/.pyre
+
+# pytype static type analyzer
+**/.pytype
+
+# Cython debug symbols
+**/cython_debug
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+**/.DS_Store
+**/hello.py
+
+**/*.html
+**/fast-mcp-docs.md
+
+# Debug and test files
+**/debug_*
+**/test_*
+**/CLAUDE.md
+
+# ASGI/Deployment files
+**/ssl
+**/*.pem
+**/*.key
+**/*.crt
+
+# Docker volumes
+**/redis-data
+
+# Production logs
+**/logs/*.log.*
+**/Dockerfile
+**/Dockerfile
+fly.toml

.env.example

@@ -0,0 +1,100 @@
+# OAuth Configuration for Clerk + Google
+# Copy this file to .env and fill in your actual values
+
+# =============================================================================
+# AUTHENTICATION SETTINGS
+# =============================================================================
+
+# Enable/disable authentication (set to "true" to enable OAuth)
+ENABLE_AUTH=false
+
+# =============================================================================
+# CLERK CONFIGURATION
+# =============================================================================
+
+# Clerk API keys (get from https://dashboard.clerk.com/)
+CLERK_SECRET_KEY=sk_test_your_secret_key_here
+CLERK_PUBLISHABLE_KEY=pk_test_your_publishable_key_here
+
+# OAuth Redirect URLs
+CLERK_OAUTH_REDIRECT_URL=http://localhost:8000/auth/callback
+CLERK_FRONTEND_URL=http://localhost:3000
+
+# Clerk domain issuer (usually auto-configured)
+CLERK_ISSUER=https://your-clerk-domain.clerk.accounts.dev
+CLERK_DOMAIN=your-clerk-domain
+
+# =============================================================================
+# GOOGLE OAUTH SETTINGS
+# =============================================================================
+# Note: Google OAuth is configured through Clerk dashboard
+# You need to:
+# 1. Go to Clerk Dashboard > Social Connections
+# 2. Enable Google provider
+# 3. Add your Google OAuth client ID and secret
+# 4. Configure redirect URIs in Google Console
+
+# =============================================================================
+# STRIPE CONFIGURATION (for payments/subscriptions)
+# =============================================================================
+
+STRIPE_SECRET=sk_test_your_stripe_secret_key_here
+STRIPE_WEBHOOK_SECRET=whsec_your_webhook_secret_here
+
+# =============================================================================
+# SERVER CONFIGURATION
+# =============================================================================
+
+# CORS origins (comma-separated list)
+ALLOWED_ORIGINS=http://localhost:3000,http://localhost:8000,https://yourdomain.com
+
+# Server settings
+HOST=0.0.0.0
+PORT=8000
+LOG_LEVEL=info
+
+# Base URL for the application (used for OAuth callbacks and API URLs)
+BASE_URL=http://localhost:8000
+
+# =============================================================================
+# MCP SERVER SETTINGS
+# =============================================================================
+
+# Additional MCP server configuration can go here
+# For example, rate limiting, feature flags, etc.
+
+# Example: Rate limiting
+# MAX_REQUESTS_PER_MINUTE=60
+# BURST_CAPACITY=20
+
+# =============================================================================
+# USAGE INSTRUCTIONS
+# =============================================================================
+
+# 1. Copy this file to .env:
+#    cp .env.example .env
+
+# 2. Get Clerk credentials:
+#    - Sign up at https://clerk.com/
+#    - Create a new application
+#    - Go to API Keys tab
+#    - Copy Secret Key and Publishable Key
+
+# 3. Configure Google OAuth in Clerk:
+#    - In Clerk Dashboard, go to Social Connections
+#    - Enable Google provider
+#    - Get Google OAuth credentials from Google Console
+#    - Add redirect URI: http://localhost:8000/auth/callback
+
+# 4. Update OAuth URLs:
+#    - Set CLERK_OAUTH_REDIRECT_URL to your callback URL
+#    - Set CLERK_FRONTEND_URL to your frontend application URL
+
+# 5. Enable authentication:
+#    - Set ENABLE_AUTH=true
+
+# 6. Test the OAuth flow:
+#    - Start server: uvicorn asgi_app:app --reload
+#    - Visit: http://localhost:8000/auth/login
+#    - Complete OAuth flow with Google
+#    - Check: http://localhost:8000/auth/user

.github/workflows/publish.yml

@@ -0,0 +1,37 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:  # Manual trigger for testing
+
+jobs:
+  pypi-publish:
+    name: Upload release to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/yargi-mcp
+    permissions:
+      id-token: write  # IMPORTANT: this permission is mandatory for trusted publishing
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build
+    
+    - name: Build package
+      run: python -m build
+    
+    - name: Publish package to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        password: ${{ secrets.PYPI_API_TOKEN }}
+        skip-existing: true

.gitignore

@@ -160,4 +160,33 @@ cython_debug/
 #.idea/
 .DS_Store
 hello.py
-*.toml
+
+*.html
+fast-mcp-docs.md
+
+# Debug and test files
+debug_*
+test_*
+CLAUDE.md
+
+# ASGI/Deployment files
+ssl/
+*.pem
+*.key
+*.crt
+
+# Docker volumes
+redis-data/
+
+# Production logs
+logs/*.log.*
+
+# Remove these lines - we need deployment files in git:
+# Dockerfile - NEEDED for SaaS deployment
+# fly.toml - NEEDED for Fly.io deployment  
+# .github/workflows/fly-deploy.yml - NEEDED for GitHub Actions
+
+GEMINI.md
+fly.toml
+scripts/deploy-flyio.sh
+docs/DEPLOYMENT_FLYIO.md

Dockerfile

@@ -0,0 +1,29 @@
+# -------- BASE IMAGE (includes Chromium & deps) ----------------------------
+FROM mcr.microsoft.com/playwright/python:v1.52.0-noble
+
+# -------- Runtime setup ----------------------------------------------------
+WORKDIR /app
+
+# Copy dependency manifests first for layer-cache
+COPY pyproject.toml poetry.lock* requirements*.txt* ./
+
+# Fast, deterministic install with `uv`
+RUN pip install --no-cache-dir uv && \
+    uv pip install --system --no-cache-dir .[asgi,saas]
+
+# Copy application source
+COPY . .
+
+# -------- Environment ------------------------------------------------------
+ENV PYTHONUNBUFFERED=1
+ENV ENABLE_AUTH=true
+ENV PORT=8000
+
+# -------- Health check -----------------------------------------------------
+HEALTHCHECK --interval=30s --timeout=10s --start-period=10s --retries=3 \
+  CMD python -c "import httpx, os, sys; r=httpx.get(f'http://localhost:{os.getenv(\"PORT\",\"8000\")}/health'); sys.exit(0 if r.status_code==200 else 1)"
+
+EXPOSE 8000
+
+# -------- Entrypoint -------------------------------------------------------
+CMD ["uvicorn", "asgi_app:app", "--host", "0.0.0.0", "--port", "8000", "--proxy-headers"]

Procfile

@@ -0,0 +1 @@
+web: uvicorn asgi_app:app --host 0.0.0.0 --port $PORT

README.md

@@ -2,150 +2,162 @@
 
 [![Star History Chart](https://api.star-history.com/svg?repos=saidsurucu/yargi-mcp&type=Date)](https://www.star-history.com/#saidsurucu/yargi-mcp&Date)
 
-Bu proje, çeşitli Türk hukuk kaynaklarına (Yargıtay, Danıştay, Emsal Kararlar, Uyuşmazlık Mahkemesi ve Anayasa Mahkemesi - Norm Denetimi ile Bireysel Başvuru Kararları) erişimi kolaylaştıran bir [FastMCP](https://gofastmcp.com/) sunucusu oluşturur. Bu sayede, bu kaynaklardan veri arama ve belge getirme işlemleri, Model Context Protocol (MCP) destekleyen LLM (Büyük Dil Modeli) uygulamaları (örneğin Claude Desktop) ve diğer istemciler tarafından araç (tool) olarak kullanılabilir hale gelir.
+Bu proje, çeşitli Türk hukuk kaynaklarına (Yargıtay, Danıştay, Emsal Kararlar, Uyuşmazlık Mahkemesi, Anayasa Mahkemesi - Norm Denetimi ile Bireysel Başvuru Kararları, Kamu İhale Kurulu Kararları, Rekabet Kurumu Kararları ve Sayıştay Kararları) erişimi kolaylaştıran bir [FastMCP](https://gofastmcp.com/) sunucusu oluşturur. Bu sayede, bu kaynaklardan veri arama ve belge getirme işlemleri, Model Context Protocol (MCP) destekleyen LLM (Büyük Dil Modeli) uygulamaları (örneğin Claude Desktop veya [5ire](https://5ire.app)) ve diğer istemciler tarafından araç (tool) olarak kullanılabilir hale gelir.
 
 ![örnek](./ornek.png)
 
 🎯 **Temel Özellikler**
 
 * Çeşitli Türk hukuk veritabanlarına programatik erişim için standart bir MCP arayüzü.
+* **Kapsamlı Mahkeme Daire/Kurul Filtreleme:** 79 farklı daire/kurul filtreleme seçeneği
+* **Dual/Triple API Desteği:** Her mahkeme için birden fazla API kaynağı ile maksimum kapsama
+* **Kapsamlı Tarih Filtreleme:** Tüm Bedesten API araçlarında ISO 8601 formatında tarih aralığı filtreleme
+* **Kesin Cümle Arama:** Tüm Bedesten API araçlarında çift tırnak ile tam cümle arama desteği
 * Aşağıdaki kurumların kararlarını arama ve getirme yeteneği:
-    * **Yargıtay:** Detaylı kriterlerle karar arama ve karar metinlerini Markdown formatında getirme.
-    * **Danıştay:** Anahtar kelime bazlı ve detaylı kriterlerle karar arama; karar metinlerini Markdown formatında getirme.
+    * **Yargıtay:** Detaylı kriterlerle karar arama ve karar metinlerini Markdown formatında getirme. **Dual API** (Ana + Bedesten) + **52 Daire/Kurul Filtreleme** + **Tarih & Kesin Cümle Arama** (Hukuk/Ceza Daireleri, Genel Kurullar)
+    * **Danıştay:** Anahtar kelime bazlı ve detaylı kriterlerle karar arama; karar metinlerini Markdown formatında getirme. **Triple API** (Keyword + Detailed + Bedesten) + **27 Daire/Kurul Filtreleme** + **Tarih & Kesin Cümle Arama** (İdari Daireler, Vergi/İdare Kurulları, Askeri Yüksek İdare Mahkemesi)
+    * **Yerel Hukuk Mahkemeleri:** Bedesten API ile yerel hukuk mahkemesi kararlarına erişim + **Tarih & Kesin Cümle Arama**
+    * **İstinaf Hukuk Mahkemeleri:** Bedesten API ile istinaf mahkemesi kararlarına erişim + **Tarih & Kesin Cümle Arama**
+    * **Kanun Yararına Bozma (KYB):** Bedesten API ile olağanüstü kanun yoluna erişim + **Tarih & Kesin Cümle Arama**
     * **Emsal (UYAP):** Detaylı kriterlerle emsal karar arama ve karar metinlerini Markdown formatında getirme.
     * **Uyuşmazlık Mahkemesi:** Form tabanlı kriterlerle karar arama ve karar metinlerini (URL ile erişilen) Markdown formatında getirme.
     * **Anayasa Mahkemesi (Norm Denetimi):** Kapsamlı kriterlerle norm denetimi kararlarını arama; uzun karar metinlerini (5.000 karakterlik) sayfalanmış Markdown formatında getirme.
     * **Anayasa Mahkemesi (Bireysel Başvuru):** Kapsamlı kriterlerle bireysel başvuru "Karar Arama Raporu" oluşturma ve listedeki kararların metinlerini (5.000 karakterlik) sayfalanmış Markdown formatında getirme.
+    * **KİK (Kamu İhale Kurulu):** Çeşitli kriterlerle Kurul kararlarını arama; uzun karar metinlerini (varsayılan 5.000 karakterlik) sayfalanmış Markdown formatında getirme.
+    * **Rekabet Kurumu:** Çeşitli kriterlerle Kurul kararlarını arama; karar metinlerini Markdown formatında getirme.
+    * **Sayıştay:** 3 karar türü ile kapsamlı denetim kararlarına erişim + **8 Daire Filtreleme** + **Tarih Aralığı & İçerik Arama** (Genel Kurul yorumlayıcı kararları, Temyiz Kurulu itiraz kararları, Daire ilk derece denetim kararları)
+
 * Karar metinlerinin daha kolay işlenebilmesi için Markdown formatına çevrilmesi.
 * Claude Desktop uygulaması ile `fastmcp install` komutu kullanılarak kolay entegrasyon.
+* Yargı MCP artık [5ire](https://5ire.app) gibi Claude Desktop haricindeki MCP istemcilerini de destekliyor!
+---
+🚀 **Claude Haricindeki Modellerle Kullanmak İçin Çok Kolay Kurulum (Örnek: 5ire için)**
 
-📋 **Ön Gereksinimler**
+Bu bölüm, Yargı MCP aracını 5ire gibi Claude Desktop dışındaki MCP istemcileriyle kullanmak isteyenler içindir.
 
-* **Python Sürümü:** Python 3.10 veya daha yeni bir sürümünün sisteminizde kurulu olması gerekmektedir. Python'ı [python.org](https://www.python.org/) adresinden indirebilirsiniz.
-* **Paket Yöneticisi:** `pip` (Python ile birlikte gelir) veya tercihen `uv` ([Astral](https://astral.sh/uv) tarafından geliştirilen hızlı Python paket yöneticisi).
+* **Python Kurulumu:** Sisteminizde Python 3.11 veya üzeri kurulu olmalıdır. Kurulum sırasında "**Add Python to PATH**" (Python'ı PATH'e ekle) seçeneğini işaretlemeyi unutmayın. [Buradan](https://www.python.org/downloads/) indirebilirsiniz.
+* **Git Kurulumu (Windows):** Bilgisayarınıza [git](https://git-scm.com/downloads/win) yazılımını indirip kurun. "Git for Windows/x64 Setup" seçeneğini indirmelisiniz.
+* **`uv` Kurulumu:**
+    * **Windows Kullanıcıları (PowerShell):** Bir CMD ekranı açın ve bu kodu çalıştırın: `powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"`
+    * **Mac/Linux Kullanıcıları (Terminal):** Bir Terminal ekranı açın ve bu kodu çalıştırın: `curl -LsSf https://astral.sh/uv/install.sh | sh`
+* **Microsoft Visual C++ Redistributable (Windows):** Bazı Python paketlerinin doğru çalışması için gereklidir. [Buradan](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170) indirip kurun.
+* İşletim sisteminize uygun [5ire](https://5ire.app) MCP istemcisini indirip kurun.
+* 5ire'ı açın. **Workspace -> Providers** menüsünden kullanmak istediğiniz LLM servisinin API anahtarını girin.
+* **Tools** menüsüne girin. **+Local** veya **New** yazan butona basın.
+    * **Tool Key:** `yargimcp`
+    * **Name:** `Yargı MCP`
+    * **Command:**
+        ```
+        uvx --from git+https://github.com/saidsurucu/yargi-mcp yargi-mcp
+        ```
+    * **Save** butonuna basarak kaydedin.
+![5ire ayarları](./5ire-settings.png)
+* Şimdi **Tools** altında **Yargı MCP**'yi görüyor olmalısınız. Üstüne geldiğinizde sağda çıkan butona tıklayıp etkinleştirin (yeşil ışık yanmalı).
+* Artık Yargı MCP ile konuşabilirsiniz.
 
-⚙️ **Kurulum Adımları (Claude Desktop Entegrasyonu Odaklı)**
+---
+⚙️ **Claude Desktop Manuel Kurulumu**
 
-Claude Desktop uygulamasına yükleme yapabilmek için öncelikle `uv` (önerilir) ve `fastmcp` komut satırı araçlarını kurmanız, ardından proje dosyalarını almanız gerekmektedir.
 
-**1. `uv` Kurulumu (Önerilir)**
-
-* **macOS ve Linux için:**
-    ```bash
-    curl -LsSf [https://astral.sh/uv/install.sh](https://astral.sh/uv/install.sh) | sh
-    ```
-* **Windows için (PowerShell kullanarak):**
-    ```powershell
-    powershell -c "irm [https://astral.sh/uv/install.ps1](https://astral.sh/uv/install.ps1) | iex"
-    ```
-* Kurulumdan sonra, `uv` komutunun sisteminiz tarafından tanınması için terminalinizi yeniden başlatmanız veya `PATH` ortam değişkeninizi güncellemeniz gerekebilir. `uv --version` komutu ile kurulumu doğrulayabilirsiniz.
-
-**2. `fastmcp` Komut Satırı Aracının (CLI) Kurulumu**
-
-* **`uv` kullanarak (önerilir):**
-    ```bash
-    uv pip install fastmcp
-    ```
-* **`pip` kullanarak (alternatif):**
-    ```bash
-    pip install fastmcp
-    ```
-    `fastmcp --version` komutu ile kurulumu doğrulayabilirsiniz.
-
-**3. Proje Dosyalarını Alın**
-
-Bu Yargı MCP sunucusunun kaynak kodlarını bilgisayarınıza indirin:
-```bash
-git clone https://github.com/saidsurucu/yargi-mcp.git
-cd yargi-mcp
-```
-Bu README.md dosyasının ve `mcp_server_main.py` script'inin bulunduğu dizine `cd` komutu ile geçmiş olacaksınız.
-
-**4. Sunucuya Özel Bağımlılıkların Bilinmesi**
-
-Bu sunucunun (`mcp_server_main.py`) çalışması için aşağıdaki Python kütüphanelerine ihtiyacı vardır. Bu kütüphaneler `fastmcp install` sırasında `--with` parametreleriyle belirtilecektir:
-
-```text
-# requirements.txt
-fastmcp
-httpx
-beautifulsoup4
-markitdown
-pydantic
-aiohttp
-```
-(Eğer sunucuyu bağımsız olarak geliştirmek veya test etmek isterseniz, projenizin kök dizininde bir sanal ortam oluşturup – örn: `uv venv` & `source .venv/bin/activate` – bu bağımlılıkları `uv pip install -r requirements.txt` komutuyla kurabilirsiniz.)
-
-🚀 **Claude Desktop Entegrasyonu (`fastmcp install` ile - Önerilen)**
-
-Yukarıdaki kurulum adımlarını tamamladıktan sonra, bu sunucuyu Claude Desktop uygulamasına kalıcı bir araç olarak eklemenin en kolay yolu `fastmcp install` komutunu kullanmaktır:
-
-1.  Terminalde `mcp_server_main.py` dosyasının bulunduğu `yargi-mcp` dizininde olduğunuzdan emin olun.
-2.  Aşağıdaki komutu çalıştırın:
-
-    ```bash
-    fastmcp install mcp_server_main.py \
-        --name "Yargı MCP" \
-        --with httpx \
-        --with beautifulsoup4 \
-        --with markitdown \
-        --with pydantic \
-        --with aiohttp
-    ```
-
-    * `--name "Yargı MCP"`: Araç Claude Desktop'ta bu isimle görünecektir.
-    * `--with ...`: Sunucunun çalışması için gereken Python bağımlılıklarını belirtir.
-
-    Bu komut, `uv` kullanarak sunucunuz için izole bir Python ortamı oluşturacak, belirtilen bağımlılıkları kuracak ve aracı Claude Desktop uygulamasına kaydedecektir.
-
-⚙️ **Claude Desktop Manuel Kurulumu (Yapılandırma Dosyası ile - Alternatif)**
-
-1.  **Claude Desktop Ayarları**'nı açın.
-2.  **Developer** sekmesine gidin ve **Edit Config** düğmesine tıklayın.
-3.  Açılan `claude_desktop_config.json` dosyasını bir metin düzenleyici ile açın.
-4.  `mcpServers` nesnesine aşağıdaki JSON bloğunu ekleyin:
+1.  **Ön Gereksinimler:** Python, `uv`, (Windows için) Microsoft Visual C++ Redistributable'ın sisteminizde kurulu olduğundan emin olun. Detaylı bilgi için yukarıdaki "5ire için Kurulum" bölümündeki ilgili adımlara bakabilirsiniz.
+2.  Claude Desktop **Settings -> Developer -> Edit Config**.
+3.  Açılan `claude_desktop_config.json` dosyasına `mcpServers` altına ekleyin:
 
     ```json
     {
       "mcpServers": {
-        // ... (varsa diğer sunucu tanımlamalarınız) ...
-
+        // ... (varsa diğer sunucularınız) ...
         "Yargı MCP": {
-          "command": "uv",
+          "command": "uvx",
           "args": [
-            "run",
-            "--with", "httpx",
-            "--with", "beautifulsoup4",
-            "--with", "markitdown",
-            "--with", "pydantic",
-            "--with", "aiohttp",
-            "--with", "fastmcp",
-            "fastmcp", "run", 
-            "/TAM/PROJE/YOLUNUZ/yargi-mcp/mcp_server_main.py" 
+            "--from", "git+https://github.com/saidsurucu/yargi-mcp",
+            "yargi-mcp"
           ]
         }
       }
     }
     ```
-    * **Önemli:** `/TAM/PROJE/YOLUNUZ/yargi-mcp/mcp_server_main.py` kısmını, `mcp_server_main.py` dosyasının sisteminizdeki **tam ve doğru yolu** ile değiştirmeyi unutmayın.
-5.  Claude Desktop'ı yeniden başlatın.
+4.  Claude Desktop'ı kapatıp yeniden başlatın.
+
+---
+🌟 **Gemini CLI ile Kullanım**
+
+Yargı MCP'yi Gemini CLI ile kullanmak için:
+
+1. **Ön Gereksinimler:** Python, `uv`, (Windows için) Microsoft Visual C++ Redistributable'ın sisteminizde kurulu olduğundan emin olun. Detaylı bilgi için yukarıdaki "5ire için Kurulum" bölümündeki ilgili adımlara bakabilirsiniz.
+
+2. **Gemini CLI ayarlarını yapılandırın:**
+   
+   Gemini CLI'ın ayar dosyasını düzenleyin:
+   - **macOS/Linux:** `~/.gemini/settings.json`
+   - **Windows:** `%USERPROFILE%\.gemini\settings.json`
+   
+   Aşağıdaki `mcpServers` bloğunu ekleyin:
+   ```json
+   {
+     "theme": "Default",
+     "selectedAuthType": "###",
+     "mcpServers": {
+       "yargi_mcp": {
+         "command": "uvx",
+         "args": [
+           "--from",
+           "git+https://github.com/saidsurucu/yargi-mcp",
+           "yargi-mcp"
+         ]
+       }
+     }
+   }
+   ```
+   
+   **Yapılandırma açıklamaları:**
+   - `"yargi_mcp"`: Sunucunuz için yerel bir isim
+   - `"command"`: `uvx` komutu (uv'nin paket çalıştırma aracı)
+   - `"args"`: GitHub'dan doğrudan Yargı MCP'yi çalıştırmak için gerekli argümanlar
+
+3. **Kullanım:**
+   - Gemini CLI'ı başlatın
+   - Yargı MCP araçları otomatik olarak kullanılabilir olacaktır
+   - Örnek komutlar:
+     - "Yargıtay'ın mülkiyet hakkı ile ilgili son kararlarını ara"
+     - "Danıştay'ın imar planı iptaline ilişkin kararlarını bul"
+     - "Anayasa Mahkemesi'nin ifade özgürlüğü kararlarını getir"
 
 🛠️ **Kullanılabilir Araçlar (MCP Tools)**
 
 Bu FastMCP sunucusu aşağıdaki temel araçları sunar:
 
-* **Yargıtay Araçları:**
-    * `search_yargitay_detailed(search_query: YargitayDetailedSearchRequest) -> CompactYargitaySearchResult`: Yargıtay kararlarını detaylı kriterlerle arar.
-    * `get_yargitay_document_markdown(document_id: str) -> YargitayDocumentMarkdown`: Belirli bir Yargıtay kararının metnini Markdown formatında getirir.
+### **Yargıtay Araçları (Dual API + 52 Daire Filtreleme)**
+* **Ana API:**
+    * `search_yargitay_detailed(arananKelime, birimYrgKurulDaire, ...)`: Yargıtay kararlarını detaylı kriterlerle arar. **52 daire/kurul seçeneği** (Hukuk/Ceza Daireleri 1-23, Genel Kurullar, Başkanlar Kurulu)
+    * `get_yargitay_document_markdown(id: str)`: Belirli bir Yargıtay kararının metnini Markdown formatında getirir.
+* **Bedesten API (Alternatif):**
+    * `search_yargitay_bedesten(phrase, birimAdi, kararTarihiStart, kararTarihiEnd, ...)`: Bedesten API ile Yargıtay kararlarını arar. **Aynı 52 daire filtreleme** + **Tarih Filtreleme** + **Kesin Cümle Arama** (`"\"mülkiyet kararı\""`)
+    * `get_yargitay_bedesten_document_markdown(documentId: str)`: Bedesten'den karar metni (HTML/PDF → Markdown)
 
-* **Danıştay Araçları:**
-    * `search_danistay_by_keyword(search_query: DanistayKeywordSearchRequest) -> CompactDanistaySearchResult`: Danıştay kararlarını anahtar kelimelerle arar.
-    * `search_danistay_detailed(search_query: DanistayDetailedSearchRequest) -> CompactDanistaySearchResult`: Danıştay kararlarını detaylı kriterlerle arar.
-    * `get_danistay_document_markdown(document_id: str) -> DanistayDocumentMarkdown`: Belirli bir Danıştay kararının metnini Markdown formatında getirir.
+### **Danıştay Araçları (Triple API + 27 Daire Filtreleme)**
+* **Ana API'lar:**
+    * `search_danistay_by_keyword(andKelimeler, orKelimeler, ...)`: Danıştay kararlarını anahtar kelimelerle arar.
+    * `search_danistay_detailed(daire, esasYil, ...)`: Danıştay kararlarını detaylı kriterlerle arar.
+    * `get_danistay_document_markdown(id: str)`: Belirli bir Danıştay kararının metnini Markdown formatında getirir.
+* **Bedesten API (Alternatif):**
+    * `search_danistay_bedesten(phrase, birimAdi, kararTarihiStart, kararTarihiEnd, ...)`: Bedesten API ile Danıştay kararlarını arar. **27 daire/kurul seçeneği** + **Tarih Filtreleme** + **Kesin Cümle Arama** (`"\"idari işlem\""`) (1-17. Daireler, Vergi/İdare Kurulları, Askeri Mahkemeler)
+    * `get_danistay_bedesten_document_markdown(documentId: str)`: Bedesten'den karar metni
+
+### **Diğer Mahkemeler (Bedesten API + Gelişmiş Arama)**
+* **Yerel Hukuk Mahkemeleri:**
+    * `search_yerel_hukuk_bedesten(phrase, kararTarihiStart, kararTarihiEnd, ...)`: Yerel hukuk mahkemesi kararlarını arar + **Tarih & Kesin Cümle Arama** (`"\"sözleşme ihlali\""`)
+    * `get_yerel_hukuk_bedesten_document_markdown(documentId: str)`: Karar metni
+* **İstinaf Hukuk Mahkemeleri:**
+    * `search_istinaf_hukuk_bedesten(phrase, kararTarihiStart, kararTarihiEnd, ...)`: İstinaf mahkemesi kararlarını arar + **Tarih & Kesin Cümle Arama** (`"\"temyiz incelemesi\""`)
+    * `get_istinaf_hukuk_bedesten_document_markdown(documentId: str)`: Karar metni
+* **Kanun Yararına Bozma (KYB):**
+    * `search_kyb_bedesten(phrase, kararTarihiStart, kararTarihiEnd, ...)`: Olağanüstü kanun yolu kararlarını arar + **Tarih & Kesin Cümle Arama** (`"\"kanun yararına bozma\""`)
+    * `get_kyb_bedesten_document_markdown(documentId: str)`: Karar metni
 
 * **Emsal Karar Araçları:**
     * `search_emsal_detailed_decisions(search_query: EmsalSearchRequest) -> CompactEmsalSearchResult`: Emsal (UYAP) kararlarını detaylı kriterlerle arar.
-    * `get_emsal_document_markdown(document_id: str) -> EmsalDocumentMarkdown`: Belirli bir Emsal kararının metnini Markdown formatında getirir.
+    * `get_emsal_document_markdown(id: str) -> EmsalDocumentMarkdown`: Belirli bir Emsal kararının metnini Markdown formatında getirir.
 
 * **Uyuşmazlık Mahkemesi Araçları:**
     * `search_uyusmazlik_decisions(search_params: UyusmazlikSearchRequest) -> UyusmazlikSearchResponse`: Uyuşmazlık Mahkemesi kararlarını çeşitli form kriterleriyle arar.
@@ -159,6 +171,82 @@ Bu FastMCP sunucusu aşağıdaki temel araçları sunar:
     * `search_anayasa_bireysel_basvuru_report(search_query: AnayasaBireyselReportSearchRequest) -> AnayasaBireyselReportSearchResult`: AYM Bireysel Başvuru "Karar Arama Raporu" oluşturur.
     * `get_anayasa_bireysel_basvuru_document_markdown(document_url_path: str, page_number: Optional[int] = 1) -> AnayasaBireyselBasvuruDocumentMarkdown`: Belirli bir AYM Bireysel Başvuru kararını URL path'inden alır ve 5.000 karakterlik sayfalanmış Markdown içeriğini getirir.
 
+* **KİK (Kamu İhale Kurulu) Araçları:**
+    * `search_kik_decisions(search_query: KikSearchRequest) -> KikSearchResult`: KİK (Kamu İhale Kurulu) kararlarını arar. 
+    * `get_kik_document_markdown(karar_id: str, page_number: Optional[int] = 1) -> KikDocumentMarkdown`: Belirli bir KİK kararını, Base64 ile encode edilmiş `karar_id`'sini kullanarak alır ve 5.000 karakterlik sayfalanmış Markdown içeriğini getirir.
+* **Rekabet Kurumu Araçları:**
+    * `search_rekabet_kurumu_decisions(KararTuru: Literal[...], ...) -> RekabetSearchResult`: Rekabet Kurumu kararlarını arar. `KararTuru` için kullanıcı dostu isimler kullanılır (örn: "Birleşme ve Devralma").
+    * `get_rekabet_kurumu_document(karar_id: str, page_number: Optional[int] = 1) -> RekabetDocument`: Belirli bir Rekabet Kurumu kararını `karar_id` ile alır. Kararın PDF formatındaki orijinalinden istenen sayfayı ayıklar ve Markdown formatında döndürür.
+
+
+---
+
+* **Sayıştay Araçları (3 Karar Türü + 8 Daire Filtreleme):**
+    * `search_sayistay_genel_kurul(karar_no, karar_tarih_baslangic, karar_tamami, ...)`: Sayıştay Genel Kurul (yorumlayıcı) kararlarını arar. **Tarih aralığı** (2006-2024) + **İçerik arama** (400 karakter)
+    * `search_sayistay_temyiz_kurulu(ilam_dairesi, kamu_idaresi_turu, temyiz_karar, ...)`: Temyiz Kurulu (itiraz) kararlarını arar. **8 Daire filtreleme** + **Kurum türü** + **Konu sınıflandırması**
+    * `search_sayistay_daire(yargilama_dairesi, web_karar_metni, hesap_yili, ...)`: Daire (ilk derece denetim) kararlarını arar. **8 Daire filtreleme** + **Hesap yılı** + **İçerik arama**
+    * `get_sayistay_genel_kurul_document_markdown(decision_id: str)`: Genel Kurul kararının tam metnini Markdown formatında getirir
+    * `get_sayistay_temyiz_kurulu_document_markdown(decision_id: str)`: Temyiz Kurulu kararının tam metnini Markdown formatında getirir  
+    * `get_sayistay_daire_document_markdown(decision_id: str)`: Daire kararının tam metnini Markdown formatında getirir
+
+
+---
+
+### **📊 Kapsamlı İstatistikler**
+- **Toplam Mahkeme/Kurum:** 12 farklı hukuki kurum
+- **Toplam MCP Tool:** 36+ arama ve belge getirme aracı  
+- **Daire/Kurul Filtreleme:** 87 farklı seçenek (52 Yargıtay + 27 Danıştay + 8 Sayıştay)
+- **Tarih Filtreleme:** 5 Bedesten API aracında ISO 8601 formatında tam tarih aralığı desteği
+- **Kesin Cümle Arama:** 5 Bedesten API aracında çift tırnak ile tam cümle arama (`"\"mülkiyet kararı\""` formatı)
+- **API Kaynağı:** Dual/Triple API desteği ile maksimum kapsama
+- **Tam Türk Adalet Sistemi:** Yerel mahkemelerden en yüksek mahkemelere kadar
+
+**🏛️ Desteklenen Mahkeme Hiyerarşisi:**
+```
+Yerel Mahkemeler → İstinaf → Yargıtay/Danıştay → Anayasa Mahkemesi
+     ↓              ↓            ↓                    ↓
+Bedesten API   Bedesten API   Dual/Triple API   Norm+Bireysel API
++ Tarih + Kesin + Tarih + Kesin + Daire + Tarih   + Gelişmiş
+  Cümle Arama    Cümle Arama   + Kesin Cümle     Arama
+```
+
+**⚖️ Kapsamlı Filtreleme Özellikleri:**
+- **Daire Filtreleme:** 79 seçenek (52 Yargıtay + 27 Danıştay)
+  - **Yargıtay:** 52 seçenek (1-23 Hukuk, 1-23 Ceza, Genel Kurullar, Başkanlar Kurulu)
+  - **Danıştay:** 27 seçenek (1-17 Daireler, İdare/Vergi Kurulları, Askeri Mahkemeler)
+- **Tarih Filtreleme:** 5 Bedesten API aracında ISO 8601 formatı (YYYY-MM-DDTHH:MM:SS.000Z)
+  - Tek tarih, tarih aralığı, tek taraflı filtreleme desteği
+  - Yargıtay, Danıştay, Yerel Hukuk, İstinaf Hukuk, KYB kararları
+- **Kesin Cümle Arama:** 5 Bedesten API aracında çift tırnak formatı
+  - Normal arama: `"mülkiyet kararı"` (kelimeler ayrı ayrı)
+  - Kesin arama: `"\"mülkiyet kararı\""` (tam cümle olarak)
+  - Daha kesin sonuçlar için hukuki terimler ve kavramlar
+
+---
+
+🌐 **Web Service / ASGI Deployment**
+
+Yargı MCP artık web servisi olarak da çalıştırılabilir! ASGI desteği sayesinde:
+
+- **Web API olarak erişim**: HTTP endpoint'leri üzerinden MCP araçlarına erişim
+- **Cloud deployment**: Heroku, Railway, Google Cloud Run, AWS Lambda desteği
+- **Docker desteği**: Production-ready Docker container
+- **FastAPI entegrasyonu**: REST API ve interaktif dokümantasyon
+
+**Hızlı başlangıç:**
+```bash
+# ASGI dependencies yükle
+pip install yargi-mcp[asgi]
+
+# Web servisi olarak başlat
+python run_asgi.py
+# veya
+uvicorn asgi_app:app --host 0.0.0.0 --port 8000
+```
+
+Detaylı deployment rehberi için: [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md)
+
+---
 
 📜 **Lisans**
 

__main__.py

@@ -0,0 +1,7 @@
+#!/usr/bin/env python3
+"""Entry point for yargi-mcp package."""
+
+from mcp_server_main import main
+
+if __name__ == "__main__":
+    main()

anayasa_mcp_module/bireysel_client.py

@@ -232,7 +232,7 @@ class AnayasaBireyselBasvuruApiClient:
         markdown_text = None
         temp_file_path = None
         try:
-            md_converter = MarkItDown(enable_plugins=False) 
+            md_converter = MarkItDown() 
             with tempfile.NamedTemporaryFile(mode="w", delete=False, suffix=".html", encoding="utf-8") as tmp_file:
                 if not html_input_for_markdown.strip().lower().startswith(("<html", "<!doctype")):
                     tmp_file.write(f"<html><head><meta charset=\"UTF-8\"></head><body>{html_input_for_markdown}</body></html>")

anayasa_mcp_module/client.py

@@ -51,26 +51,26 @@ class AnayasaMahkemesiApiClient:
             for kw in params.keywords_any: query_params.append(("HerhangiBirKelimeAra[]", kw))
         if params.keywords_exclude:
             for kw in params.keywords_exclude: query_params.append(("BulunmayanKelimeAra[]", kw))
-        if params.period and params.period.value: query_params.append(("Donemler_id", params.period.value))
+        if params.period and params.period.value and params.period.value != "ALL": query_params.append(("Donemler_id", params.period.value))
         if params.case_number_esas: query_params.append(("EsasNo", params.case_number_esas))
         if params.decision_number_karar: query_params.append(("KararNo", params.decision_number_karar))
         if params.first_review_date_start: query_params.append(("IlkIncelemeTarihiIlk", params.first_review_date_start))
         if params.first_review_date_end: query_params.append(("IlkIncelemeTarihiSon", params.first_review_date_end))
         if params.decision_date_start: query_params.append(("KararTarihiIlk", params.decision_date_start))
         if params.decision_date_end: query_params.append(("KararTarihiSon", params.decision_date_end))
-        if params.application_type and params.application_type.value: query_params.append(("BasvuruTurler_id", params.application_type.value))
+        if params.application_type and params.application_type.value and params.application_type.value != "ALL": query_params.append(("BasvuruTurler_id", params.application_type.value))
         if params.applicant_general_name: query_params.append(("BasvuranGeneller_id", params.applicant_general_name))
         if params.applicant_specific_name: query_params.append(("BasvuranOzeller_id", params.applicant_specific_name))
         if params.attending_members_names:
             for name in params.attending_members_names: query_params.append(("Uyeler_id[]", name))
         if params.rapporteur_name: query_params.append(("Raportorler_id", params.rapporteur_name))
-        if params.norm_type and params.norm_type.value: query_params.append(("NormunTurler_id", params.norm_type.value))
+        if params.norm_type and params.norm_type.value and params.norm_type.value != "ALL": query_params.append(("NormunTurler_id", params.norm_type.value))
         if params.norm_id_or_name: query_params.append(("NormunNumarasiAdlar_id", params.norm_id_or_name))
         if params.norm_article: query_params.append(("NormunMaddeNumarasi", params.norm_article))
         if params.review_outcomes:
             for outcome_enum_val in params.review_outcomes:
-                if outcome_enum_val.value: query_params.append(("IncelemeTuruKararSonuclar_id[]", outcome_enum_val.value))
-        if params.reason_for_final_outcome and params.reason_for_final_outcome.value:
+                if outcome_enum_val.value and outcome_enum_val.value != "ALL": query_params.append(("IncelemeTuruKararSonuclar_id[]", outcome_enum_val.value))
+        if params.reason_for_final_outcome and params.reason_for_final_outcome.value and params.reason_for_final_outcome.value != "ALL":
             query_params.append(("KararSonucununGerekcesi", params.reason_for_final_outcome.value))
         if params.basis_constitution_article_numbers:
             for article_no in params.basis_constitution_article_numbers: query_params.append(("DayanakHukmu[]", article_no))
@@ -78,9 +78,9 @@ class AnayasaMahkemesiApiClient:
         if params.official_gazette_date_end: query_params.append(("ResmiGazeteTarihiSon", params.official_gazette_date_end))
         if params.official_gazette_number_start: query_params.append(("ResmiGazeteSayisiIlk", params.official_gazette_number_start))
         if params.official_gazette_number_end: query_params.append(("ResmiGazeteSayisiSon", params.official_gazette_number_end))
-        if params.has_press_release and params.has_press_release.value: query_params.append(("BasinDuyurusu", params.has_press_release.value))
-        if params.has_dissenting_opinion and params.has_dissenting_opinion.value: query_params.append(("KarsiOy", params.has_dissenting_opinion.value))
-        if params.has_different_reasoning and params.has_different_reasoning.value: query_params.append(("FarkliGerekce", params.has_different_reasoning.value))
+        if params.has_press_release and params.has_press_release.value and params.has_press_release.value != "ALL": query_params.append(("BasinDuyurusu", params.has_press_release.value))
+        if params.has_dissenting_opinion and params.has_dissenting_opinion.value and params.has_dissenting_opinion.value != "ALL": query_params.append(("KarsiOy", params.has_dissenting_opinion.value))
+        if params.has_different_reasoning and params.has_different_reasoning.value and params.has_different_reasoning.value != "ALL": query_params.append(("FarkliGerekce", params.has_different_reasoning.value))
         
         if params.page_to_fetch and params.page_to_fetch > 1:
             query_params.append(("page", str(params.page_to_fetch)))
@@ -224,7 +224,7 @@ class AnayasaMahkemesiApiClient:
         markdown_text = None
         temp_file_path = None
         try:
-            md_converter = MarkItDown(enable_plugins=False) 
+            md_converter = MarkItDown() 
             with tempfile.NamedTemporaryFile(mode="w", delete=False, suffix=".html", encoding="utf-8") as tmp_file:
                 # Ensure the content is wrapped in basic HTML structure if it's not already
                 if not html_input_for_markdown.strip().lower().startswith(("<html", "<!doctype")):

anayasa_mcp_module/models.py

@@ -6,23 +6,23 @@ from enum import Enum
 
 # --- Enums (AnayasaDonemEnum, AnayasaBasvuruTuruEnum, etc. - same as before) ---
 class AnayasaDonemEnum(str, Enum):
-    TUMU = ""
+    TUMU = "ALL"
     DONEM_1961 = "1"
     DONEM_1982 = "2"
 
 class AnayasaBasvuruTuruEnum(str, Enum):
-    TUMU = ""
+    TUMU = "ALL"
     IPTAL = "1"
     ITIRAZ = "2"
     DIGER = "3"
 
 class AnayasaVarYokEnum(str, Enum):
-    TUMU = ""
+    TUMU = "ALL"
     YOK = "0"
     VAR = "1"
 
 class AnayasaNormTuruEnum(str, Enum):
-    TUMU = ""
+    TUMU = "ALL"
     ANAYASA = "1"
     ANAYASA_DEGISTIREN_KANUN = "2"
     CUMHURBASKANLIGI_KARARNAMESI = "14"
@@ -40,7 +40,7 @@ class AnayasaNormTuruEnum(str, Enum):
     YONETMELIK = "13"
 
 class AnayasaIncelemeSonucuEnum(str, Enum):
-    TUMU = ""
+    TUMU = "ALL"
     ESAS_ACILMAMIS_SAYILMA = "1"
     ESAS_IPTAL = "2"
     ESAS_KARAR_YER_OLMADIGI = "3"
@@ -52,7 +52,7 @@ class AnayasaIncelemeSonucuEnum(str, Enum):
     KANUN_6216_M43_4_IPTAL = "12"
 
 class AnayasaSonucGerekcesiEnum(str, Enum):
-    TUMU = ""
+    TUMU = "ALL"
     ANAYASAYA_AYKIRI_DEGIL = "29"
     ANAYASAYA_ESAS_YONUNDEN_AYKIRILIK = "1"
     ANAYASAYA_ESAS_YONUNDEN_UYGUNLUK = "2"

asgi_app.py

@@ -0,0 +1,333 @@
+"""
+ASGI application for Yargı MCP Server
+
+This module provides ASGI/HTTP access to the Yargı MCP server,
+allowing it to be deployed as a web service with FastAPI wrapper
+for Stripe webhook integration.
+
+Usage:
+    uvicorn asgi_app:app --host 0.0.0.0 --port 8000
+"""
+
+import os
+from fastapi import FastAPI, Request, HTTPException
+from fastapi.responses import JSONResponse
+from fastapi.exception_handlers import http_exception_handler
+from starlette.middleware import Middleware
+from starlette.middleware.cors import CORSMiddleware
+from starlette.responses import Response
+
+# Import the fully configured MCP app with all tools
+from mcp_server_main import app as mcp_server
+
+# Import Stripe webhook router
+from stripe_webhook import router as stripe_router
+
+# Import MCP Auth HTTP adapter
+from mcp_auth_http_adapter import router as mcp_auth_router
+
+# OAuth configuration from environment variables
+CLERK_ISSUER = os.getenv("CLERK_ISSUER", "https://accounts.yargimcp.com")
+BASE_URL = os.getenv("BASE_URL", "https://yargimcp.com")
+
+# Configure CORS middleware
+cors_origins = os.getenv("ALLOWED_ORIGINS", "*").split(",")
+custom_middleware = [
+    Middleware(
+        CORSMiddleware,
+        allow_origins=cors_origins,
+        allow_credentials=True,
+        allow_methods=["GET", "POST", "OPTIONS"],
+        allow_headers=["Content-Type", "Authorization", "X-Request-ID"],
+    ),
+]
+
+# Create MCP Starlette sub-application first
+mcp_app = mcp_server.http_app(
+    path="/",
+    middleware=custom_middleware
+)
+
+# Create FastAPI wrapper application with MCP app's lifespan
+app = FastAPI(
+    title="Yargı MCP Server",
+    description="MCP server for Turkish legal databases with OAuth authentication",
+    version="0.1.0",
+    middleware=custom_middleware,
+    lifespan=mcp_app.lifespan  # Critical: Get lifespan from mcp_app, not mcp_server
+)
+
+# Add Stripe webhook router to FastAPI
+app.include_router(stripe_router, prefix="/api")
+
+# Add MCP Auth HTTP adapter to FastAPI (replaces old OAuth router)
+app.include_router(mcp_auth_router)
+
+# Custom 401 exception handler for MCP spec compliance
+@app.exception_handler(401)
+async def custom_401_handler(request: Request, exc: HTTPException):
+    """Custom 401 handler that adds WWW-Authenticate header as required by MCP spec"""
+    response = await http_exception_handler(request, exc)
+    
+    # Add WWW-Authenticate header pointing to protected resource metadata
+    # as required by RFC 9728 Section 5.1 and MCP Authorization spec
+    response.headers["WWW-Authenticate"] = (
+        'Bearer '
+        'error="invalid_token", '
+        'error_description="The access token is missing or invalid", '
+        f'resource="{BASE_URL}/.well-known/oauth-protected-resource"'
+    )
+    
+    return response
+
+# Mount MCP app as sub-application
+app.mount("/mcp", mcp_app)
+
+# Add POST handler for /mcp to forward to mounted app
+@app.post("/mcp")
+async def mcp_post_handler(request: Request):
+    """Forward POST /mcp requests to mounted MCP app"""
+    # Forward to the mounted app by calling it directly
+    async def receive():
+        return await request.receive()
+    
+    # Create a new scope for the mounted app
+    scope = request.scope.copy()
+    scope["path"] = "/"  # Root path for the mounted app
+    scope["path_info"] = "/"
+    
+    # Capture response
+    response_parts = {"status": 200, "headers": [], "body": b""}
+    
+    async def send(message):
+        if message["type"] == "http.response.start":
+            response_parts["status"] = message["status"]
+            response_parts["headers"] = message["headers"]
+        elif message["type"] == "http.response.body":
+            response_parts["body"] += message.get("body", b"")
+    
+    # Call the mounted MCP app
+    await mcp_app(scope, receive, send)
+    
+    # Return the response
+    from starlette.responses import Response
+    
+    # Convert ASGI headers to dict
+    headers = {}
+    for name, value in response_parts["headers"]:
+        headers[name.decode()] = value.decode()
+    
+    return Response(
+        content=response_parts["body"],
+        status_code=response_parts["status"],
+        headers=headers
+    )
+
+
+# FastAPI health check endpoint
+@app.get("/health")
+async def health_check():
+    """Health check endpoint for monitoring"""
+    return JSONResponse({
+        "status": "healthy",
+        "service": "Yargı MCP Server",
+        "version": "0.1.0",
+        "tools_count": len(mcp_server._tool_manager._tools),
+        "auth_enabled": os.getenv("ENABLE_AUTH", "false").lower() == "true"
+    })
+
+# FastAPI root endpoint
+@app.get("/")
+async def root():
+    """Root endpoint with service information"""
+    return JSONResponse({
+        "service": "Yargı MCP Server",
+        "description": "MCP server for Turkish legal databases with OAuth authentication",
+        "endpoints": {
+            "mcp": "/mcp",
+            "health": "/health",
+            "status": "/status",
+            "stripe_webhook": "/api/stripe/webhook",
+            "oauth_login": "/auth/login",
+            "oauth_callback": "/auth/callback",
+            "oauth_google": "/auth/google/login",
+            "user_info": "/auth/user"
+        },
+        "supported_databases": [
+            "Yargıtay (Court of Cassation)",
+            "Danıştay (Council of State)", 
+            "Emsal (Precedent)",
+            "Uyuşmazlık Mahkemesi (Court of Jurisdictional Disputes)",
+            "Anayasa Mahkemesi (Constitutional Court)",
+            "Kamu İhale Kurulu (Public Procurement Authority)",
+            "Rekabet Kurumu (Competition Authority)",
+            "Sayıştay (Court of Accounts)",
+            "Bedesten API (Multiple courts)"
+        ],
+        "authentication": {
+            "enabled": os.getenv("ENABLE_AUTH", "false").lower() == "true",
+            "type": "OAuth 2.0 via Clerk",
+            "issuer": os.getenv("CLERK_ISSUER", "https://clerk.accounts.dev"),
+            "providers": ["google"],
+            "flow": "authorization_code"
+        }
+    })
+
+# OAuth 2.0 Authorization Server Metadata proxy (for MCP clients that can't reach Clerk directly)
+@app.get("/.well-known/oauth-authorization-server")
+async def oauth_authorization_server():
+    """OAuth 2.0 Authorization Server Metadata proxy to Clerk"""
+    return JSONResponse({
+        "issuer": CLERK_ISSUER,
+        "authorization_endpoint": f"{BASE_URL}/auth/login",
+        "token_endpoint": f"{BASE_URL}/auth/callback", 
+        "jwks_uri": f"{CLERK_ISSUER}/.well-known/jwks.json",
+        "response_types_supported": ["code"],
+        "grant_types_supported": ["authorization_code", "refresh_token"],
+        "token_endpoint_auth_methods_supported": ["client_secret_basic", "none"],
+        "scopes_supported": ["read", "search", "openid", "profile", "email"],
+        "subject_types_supported": ["public"],
+        "id_token_signing_alg_values_supported": ["RS256"],
+        "claims_supported": ["sub", "iss", "aud", "exp", "iat", "email", "name"],
+        "code_challenge_methods_supported": ["S256"],
+        "service_documentation": f"{BASE_URL}/mcp",
+        "registration_endpoint": f"{BASE_URL}/auth/register",
+        "resource_documentation": f"{BASE_URL}/mcp"
+    })
+
+# MCP endpoint info for GET requests (ChatGPT compatibility)
+@app.get("/mcp")
+async def mcp_info():
+    """MCP endpoint information for discovery"""
+    return JSONResponse({
+        "mcp_server": True,
+        "name": "Yargı MCP Server",
+        "version": "0.1.0",
+        "description": "MCP server for Turkish legal databases",
+        "protocol": "mcp/1.0",
+        "transport": "http",
+        "authentication_required": True,
+        "authentication": {
+            "type": "oauth2",
+            "authorization_url": f"{BASE_URL}/auth/login",
+            "token_url": f"{BASE_URL}/auth/callback",
+            "scopes": ["read", "search"],
+            "provider": "clerk"
+        },
+        "endpoints": {
+            "mcp_protocol": "/mcp",
+            "discovery": "/mcp/discovery",
+            "well_known": "/.well-known/mcp",
+            "health": "/health",
+            "oauth_login": "/auth/login"
+        },
+        "capabilities": {
+            "tools": True,
+            "resources": True,
+            "prompts": False
+        },
+        "tools_count": len(mcp_server._tool_manager._tools),
+        "usage": {
+            "note": "This is an MCP server. Use POST to /mcp/ with proper MCP protocol headers.",
+            "headers_required": [
+                "Content-Type: application/json",
+                "Accept: application/json, text/event-stream",
+                "Authorization: Bearer <token>",
+                "X-Session-ID: <session-id>"
+            ]
+        }
+    })
+
+# OAuth 2.0 Protected Resource Metadata (RFC 9728) - MCP Spec Required
+@app.get("/.well-known/oauth-protected-resource")
+async def oauth_protected_resource():
+    """OAuth 2.0 Protected Resource Metadata as required by MCP spec"""
+    return JSONResponse({
+        "resource": BASE_URL,
+        "authorization_servers": [
+            BASE_URL
+        ],
+        "scopes_supported": ["read", "search"],
+        "bearer_methods_supported": ["header"],
+        "resource_documentation": f"{BASE_URL}/mcp",
+        "resource_policy_uri": f"{BASE_URL}/privacy"
+    })
+
+# Standard well-known discovery endpoint
+@app.get("/.well-known/mcp")
+async def well_known_mcp():
+    """Standard MCP discovery endpoint"""
+    return JSONResponse({
+        "mcp_server": {
+            "name": "Yargı MCP Server",
+            "version": "0.1.0",
+            "endpoint": f"{BASE_URL}/mcp",
+            "authentication": {
+                "type": "oauth2",
+                "authorization_url": f"{BASE_URL}/auth/login",
+                "scopes": ["read", "search"]
+            },
+            "capabilities": ["tools", "resources"],
+            "tools_count": len(mcp_server._tool_manager._tools)
+        }
+    })
+
+# MCP Discovery endpoint for ChatGPT integration
+@app.get("/mcp/discovery")
+async def mcp_discovery():
+    """MCP Discovery endpoint for ChatGPT and other MCP clients"""
+    return JSONResponse({
+        "name": "Yargı MCP Server",
+        "description": "MCP server for Turkish legal databases",
+        "version": "0.1.0",
+        "protocol": "mcp",
+        "transport": "http",
+        "endpoint": "/mcp",
+        "authentication": {
+            "type": "oauth2",
+            "authorization_url": "/auth/login",
+            "token_url": "/auth/callback",
+            "scopes": ["read", "search"],
+            "provider": "clerk"
+        },
+        "capabilities": {
+            "tools": True,
+            "resources": True,
+            "prompts": False
+        },
+        "tools_count": len(mcp_server._tool_manager._tools),
+        "contact": {
+            "url": BASE_URL,
+            "email": "support@yargi-mcp.dev"
+        }
+    })
+
+# FastAPI status endpoint
+@app.get("/status")
+async def status():
+    """Status endpoint with detailed information"""
+    tools = []
+    for tool in mcp_server._tool_manager._tools.values():
+        tools.append({
+            "name": tool.name,
+            "description": tool.description[:100] + "..." if len(tool.description) > 100 else tool.description
+        })
+    
+    return JSONResponse({
+        "status": "operational",
+        "tools": tools,
+        "total_tools": len(tools),
+        "transport": "streamable_http",
+        "architecture": "FastAPI wrapper + MCP Starlette sub-app",
+        "auth_status": "enabled" if os.getenv("ENABLE_AUTH", "false").lower() == "true" else "disabled"
+    })
+
+# Alternative: SSE transport (for compatibility)
+sse_app = mcp_server.http_app(
+    path="/sse", 
+    transport="sse",
+    middleware=custom_middleware
+)
+
+# Export for uvicorn
+__all__ = ["app", "sse_app"]

bedesten_mcp_module/__init__.py

@@ -0,0 +1 @@
+# bedesten_mcp_module/__init__.py

bedesten_mcp_module/client.py

@@ -0,0 +1,183 @@
+# bedesten_mcp_module/client.py
+
+import httpx
+import base64
+from typing import Optional
+import logging
+from markitdown import MarkItDown
+import tempfile
+import os
+
+from .models import (
+    BedestenSearchRequest, BedestenSearchResponse,
+    BedestenDocumentRequest, BedestenDocumentResponse,
+    BedestenDocumentMarkdown, BedestenDocumentRequestData
+)
+
+logger = logging.getLogger(__name__)
+
+class BedestenApiClient:
+    """
+    API Client for Bedesten (bedesten.adalet.gov.tr) - Alternative legal decision search system.
+    Currently used for Yargıtay decisions, but can be extended for other court types.
+    """
+    BASE_URL = "https://bedesten.adalet.gov.tr"
+    SEARCH_ENDPOINT = "/emsal-karar/searchDocuments"
+    DOCUMENT_ENDPOINT = "/emsal-karar/getDocumentContent"
+    
+    def __init__(self, request_timeout: float = 60.0):
+        self.http_client = httpx.AsyncClient(
+            base_url=self.BASE_URL,
+            headers={
+                "Accept": "*/*",
+                "Accept-Language": "tr-TR,tr;q=0.9,en-US;q=0.8,en;q=0.7",
+                "AdaletApplicationName": "UyapMevzuat",
+                "Content-Type": "application/json; charset=utf-8",
+                "Origin": "https://mevzuat.adalet.gov.tr",
+                "Referer": "https://mevzuat.adalet.gov.tr/",
+                "Sec-Fetch-Dest": "empty",
+                "Sec-Fetch-Mode": "cors",
+                "Sec-Fetch-Site": "same-site",
+                "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36"
+            },
+            timeout=request_timeout
+        )
+    
+    async def search_documents(self, search_request: BedestenSearchRequest) -> BedestenSearchResponse:
+        """
+        Search for documents using Bedesten API.
+        Currently supports: YARGITAYKARARI, DANISTAYKARARI, YERELHUKMAHKARARI, etc.
+        """
+        logger.info(f"BedestenApiClient: Searching documents with phrase: {search_request.data.phrase}")
+        
+        try:
+            response = await self.http_client.post(
+                self.SEARCH_ENDPOINT, 
+                json=search_request.model_dump()
+            )
+            response.raise_for_status()
+            response_json = response.json()
+            
+            # Parse and return the response
+            return BedestenSearchResponse(**response_json)
+            
+        except httpx.RequestError as e:
+            logger.error(f"BedestenApiClient: HTTP request error during search: {e}")
+            raise
+        except Exception as e:
+            logger.error(f"BedestenApiClient: Error processing search response: {e}")
+            raise
+    
+    async def get_document_as_markdown(self, document_id: str) -> BedestenDocumentMarkdown:
+        """
+        Get document content and convert to markdown.
+        Handles both HTML (text/html) and PDF (application/pdf) content types.
+        """
+        logger.info(f"BedestenApiClient: Fetching document for markdown conversion (ID: {document_id})")
+        
+        try:
+            # Prepare request
+            doc_request = BedestenDocumentRequest(
+                data=BedestenDocumentRequestData(documentId=document_id)
+            )
+            
+            # Get document
+            response = await self.http_client.post(
+                self.DOCUMENT_ENDPOINT,
+                json=doc_request.model_dump()
+            )
+            response.raise_for_status()
+            response_json = response.json()
+            doc_response = BedestenDocumentResponse(**response_json)
+            
+            # Decode base64 content
+            content_bytes = base64.b64decode(doc_response.data.content)
+            mime_type = doc_response.data.mimeType
+            
+            logger.info(f"BedestenApiClient: Document mime type: {mime_type}")
+            
+            # Convert to markdown based on mime type
+            if mime_type == "text/html":
+                html_content = content_bytes.decode('utf-8')
+                markdown_content = self._convert_html_to_markdown(html_content)
+            elif mime_type == "application/pdf":
+                markdown_content = self._convert_pdf_to_markdown(content_bytes)
+            else:
+                logger.warning(f"Unsupported mime type: {mime_type}")
+                markdown_content = f"Unsupported content type: {mime_type}. Unable to convert to markdown."
+            
+            return BedestenDocumentMarkdown(
+                documentId=document_id,
+                markdown_content=markdown_content,
+                source_url=f"{self.BASE_URL}/document/{document_id}",
+                mime_type=mime_type
+            )
+            
+        except httpx.RequestError as e:
+            logger.error(f"BedestenApiClient: HTTP error fetching document {document_id}: {e}")
+            raise
+        except Exception as e:
+            logger.error(f"BedestenApiClient: Error processing document {document_id}: {e}")
+            raise
+    
+    def _convert_html_to_markdown(self, html_content: str) -> Optional[str]:
+        """Convert HTML to Markdown using MarkItDown"""
+        if not html_content:
+            return None
+            
+        temp_file_path = None
+        try:
+            md_converter = MarkItDown()
+            
+            # Write HTML to temp file
+            with tempfile.NamedTemporaryFile(mode="w", delete=False, suffix=".html", encoding="utf-8") as tmp:
+                tmp.write(html_content)
+                temp_file_path = tmp.name
+            
+            # Convert
+            result = md_converter.convert(temp_file_path)
+            markdown_content = result.text_content
+            
+            logger.info("Successfully converted HTML to Markdown")
+            return markdown_content
+            
+        except Exception as e:
+            logger.error(f"Error converting HTML to Markdown: {e}")
+            return f"Error converting HTML content: {str(e)}"
+        finally:
+            if temp_file_path and os.path.exists(temp_file_path):
+                os.remove(temp_file_path)
+    
+    def _convert_pdf_to_markdown(self, pdf_bytes: bytes) -> Optional[str]:
+        """Convert PDF to Markdown using MarkItDown"""
+        if not pdf_bytes:
+            return None
+            
+        temp_file_path = None
+        try:
+            # MarkItDown supports PDF with markitdown[pdf]
+            md_converter = MarkItDown()
+            
+            # Write PDF to temp file
+            with tempfile.NamedTemporaryFile(mode="wb", delete=False, suffix=".pdf") as tmp:
+                tmp.write(pdf_bytes)
+                temp_file_path = tmp.name
+            
+            # Convert
+            result = md_converter.convert(temp_file_path)
+            markdown_content = result.text_content
+            
+            logger.info("Successfully converted PDF to Markdown")
+            return markdown_content
+            
+        except Exception as e:
+            logger.error(f"Error converting PDF to Markdown: {e}")
+            return f"Error converting PDF content: {str(e)}. The document may be corrupted or in an unsupported format."
+        finally:
+            if temp_file_path and os.path.exists(temp_file_path):
+                os.remove(temp_file_path)
+    
+    async def close_client_session(self):
+        """Close HTTP client session"""
+        await self.http_client.aclose()
+        logger.info("BedestenApiClient: HTTP client session closed.")

bedesten_mcp_module/models.py

@@ -0,0 +1,152 @@
+# bedesten_mcp_module/models.py
+
+from pydantic import BaseModel, Field
+from typing import List, Optional, Dict, Any, Literal, Union
+from datetime import datetime
+
+# Import YargitayBirimEnum for chamber filtering
+from yargitay_mcp_module.models import YargitayBirimEnum
+
+# Danıştay Chamber/Board Options
+DanistayBirimEnum = Literal[
+    "ALL",  # "ALL" for all chambers
+    # Main Councils
+    "Büyük Gen.Kur.",  # Grand General Assembly
+    "İdare Dava Daireleri Kurulu",  # Administrative Cases Chambers Council
+    "Vergi Dava Daireleri Kurulu",  # Tax Cases Chambers Council
+    "İçtihatları Birleştirme Kurulu",  # Precedents Unification Council
+    "İdari İşler Kurulu",  # Administrative Affairs Council
+    "Başkanlar Kurulu",  # Presidents Council
+    # Chambers
+    "1. Daire", "2. Daire", "3. Daire", "4. Daire", "5. Daire",
+    "6. Daire", "7. Daire", "8. Daire", "9. Daire", "10. Daire",
+    "11. Daire", "12. Daire", "13. Daire", "14. Daire", "15. Daire",
+    "16. Daire", "17. Daire",
+    # Military High Administrative Court
+    "Askeri Yüksek İdare Mahkemesi",
+    "Askeri Yüksek İdare Mahkemesi Daireler Kurulu",
+    "Askeri Yüksek İdare Mahkemesi Başsavcılığı",
+    "Askeri Yüksek İdare Mahkemesi 1. Daire",
+    "Askeri Yüksek İdare Mahkemesi 2. Daire", 
+    "Askeri Yüksek İdare Mahkemesi 3. Daire"
+]
+
+# Search Request Models
+class BedestenSearchData(BaseModel):
+    pageSize: int = Field(..., description="""Number of results per page.
+        Range: 1-100 results per page
+        Recommended: 10-50 for balanced performance
+        Higher values for comprehensive analysis""")
+    pageNumber: int = Field(..., description="""Page number to retrieve (1-indexed).
+        Start with 1 for first page
+        Calculate total pages from response.data.total / pageSize
+        Navigate: pageNumber=2 gets next set of results""")
+    itemTypeList: List[str] = Field(..., description="""Court type filter - determines which court decisions to search:
+        • ["YARGITAYKARARI"]: Court of Cassation (Yargıtay) - supreme court civil/criminal decisions
+        • ["DANISTAYKARAR"]: Council of State (Danıştay) - administrative court decisions
+        • ["YERELHUKUK"]: Local Civil Courts (Yerel Hukuk Mahkemeleri) - first instance civil decisions
+        • ["ISTINAFHUKUK"]: Civil Courts of Appeals (İstinaf Hukuk Mahkemeleri) - appellate court decisions
+        • ["KYB"]: Extraordinary Appeal (Kanun Yararına Bozma) - extraordinary appeal decisions
+        Note: Use single-item list for specific court type targeting""")
+    phrase: str = Field(..., description="""Search phrase/keyword with advanced search support:
+        • Regular search: "mülkiyet kararı" - searches words separately
+        • Exact phrase: "\"mülkiyet kararı\"" - searches exact phrase (more precise)
+        • Legal concepts: "\"idari işlem\"", "\"sözleşme ihlali\"", "\"tazminat davası\""
+        • Empty string: searches all documents (use with filters)
+        Exact phrases significantly reduce false positives for precise legal research""")
+    birimAdi: Optional[Union[YargitayBirimEnum, DanistayBirimEnum]] = Field(None, description="""
+        Chamber/Department (Daire) filter (optional). Available options depend on itemTypeList:
+        
+        For YARGITAYKARARI - Court of Cassation (52 options):
+        - None/null for ALL chambers
+        - 'Civil General Assembly (Hukuk Genel Kurulu)', '1st Civil Chamber (1. Hukuk Dairesi)' through '23rd Civil Chamber (23. Hukuk Dairesi)'
+        - 'Criminal General Assembly (Ceza Genel Kurulu)', '1st Criminal Chamber (1. Ceza Dairesi)' through '23rd Criminal Chamber (23. Ceza Dairesi)'  
+        - 'Civil Chambers Presidents Board (Hukuk Daireleri Başkanlar Kurulu)', 'Criminal Chambers Presidents Board (Ceza Daireleri Başkanlar Kurulu)'
+        - 'Grand General Assembly (Büyük Genel Kurulu)'
+        
+        For DANISTAYKARAR - Council of State (27 options):
+        - None/null for ALL chambers
+        - 'Grand General Assembly (Büyük Gen.Kur.)', 'Administrative Cases Chambers Council (İdare Dava Daireleri Kurulu)', 'Tax Cases Chambers Council (Vergi Dava Daireleri Kurulu)'
+        - '1st Chamber (1. Daire)' through '17th Chamber (17. Daire)'
+        - 'Precedents Unification Council (İçtihatları Birleştirme Kurulu)', 'Administrative Affairs Council (İdari İşler Kurulu)', 'Presidents Council (Başkanlar Kurulu)'
+        - Military courts: 'Military High Administrative Court (Askeri Yüksek İdare Mahkemesi)' variants
+    """)
+    kararTarihiStart: Optional[str] = Field(None, description="""Decision start date (Karar Tarihi Başlangıç) filter (optional).
+        Format: YYYY-MM-DDTHH:MM:SS.000Z (ISO 8601 with Z timezone)
+        Examples:
+        • "2024-01-01T00:00:00.000Z" - from beginning of 2024
+        • "2023-06-15T00:00:00.000Z" - from June 15, 2023
+        • "2024-03-01T00:00:00.000Z" - from March 1, 2024
+        Use with kararTarihiEnd for date range, or alone for "from date" filtering""")
+    kararTarihiEnd: Optional[str] = Field(None, description="""Decision end date (Karar Tarihi Bitiş) filter (optional).
+        Format: YYYY-MM-DDTHH:MM:SS.000Z (ISO 8601 with Z timezone)
+        Examples:
+        • "2024-12-31T23:59:59.999Z" - until end of 2024
+        • "2023-12-31T23:59:59.999Z" - until end of 2023  
+        • "2024-06-30T23:59:59.999Z" - until end of June 2024
+        Use with kararTarihiStart for date range, or alone for "until date" filtering""")
+    sortFields: List[str] = Field(default=["KARAR_TARIHI"], description="""Sorting field (Sıralama Alanı) specification.
+        ["KARAR_TARIHI"]: Sort by decision date (Karar Tarihi) [DEFAULT]
+        Most common use case for chronological ordering""")
+    sortDirection: str = Field(default="desc", description="""Sort direction (Sıralama Yönü) for results.
+        "desc": Descending order - newest decisions first [DEFAULT]
+        "asc": Ascending order - oldest decisions first
+        Recommended: "desc" for latest legal developments""")
+
+class BedestenSearchRequest(BaseModel):
+    data: BedestenSearchData
+    applicationName: str = "UyapMevzuat"
+    paging: bool = True
+
+# Search Response Models
+class BedestenItemType(BaseModel):
+    name: str
+    description: str
+
+class BedestenDecisionEntry(BaseModel):
+    documentId: str
+    itemType: BedestenItemType
+    birimId: Optional[str] = None
+    birimAdi: Optional[str]
+    esasNoYil: Optional[int] = None
+    esasNoSira: Optional[int] = None
+    kararNoYil: Optional[int] = None
+    kararNoSira: Optional[int] = None
+    kararTuru: Optional[str] = None
+    kararTarihi: str
+    kararTarihiStr: str
+    kesinlesmeDurumu: Optional[str] = None
+    kararNo: Optional[str] = None
+    esasNo: Optional[str] = None
+
+class BedestenSearchDataResponse(BaseModel):
+    emsalKararList: List[BedestenDecisionEntry]
+    total: int
+    start: int
+
+class BedestenSearchResponse(BaseModel):
+    data: BedestenSearchDataResponse
+    metadata: Dict[str, Any]
+
+# Document Request/Response Models
+class BedestenDocumentRequestData(BaseModel):
+    documentId: str
+
+class BedestenDocumentRequest(BaseModel):
+    data: BedestenDocumentRequestData
+    applicationName: str = "UyapMevzuat"
+
+class BedestenDocumentData(BaseModel):
+    content: str  # Base64 encoded HTML or PDF
+    mimeType: str
+    version: int
+
+class BedestenDocumentResponse(BaseModel):
+    data: BedestenDocumentData
+    metadata: Dict[str, Any]
+
+class BedestenDocumentMarkdown(BaseModel):
+    documentId: str = Field(..., description="The document ID (Belge Kimliği) from Bedesten")
+    markdown_content: Optional[str] = Field(None, description="The decision content (Karar İçeriği) converted to Markdown")
+    source_url: str = Field(..., description="The source URL (Kaynak URL) of the document")
+    mime_type: Optional[str] = Field(None, description="Original content type (İçerik Türü) (text/html or application/pdf)")

danistay_mcp_module/client.py

@@ -35,8 +35,6 @@ class DanistayApiClient:
             headers={
                 "Content-Type": "application/json; charset=UTF-8", # Arama endpoint'leri için
                 "Accept": "application/json, text/plain, */*",    # Arama endpoint'leri için
-                # /getDokuman HTML döndürdüğü için Accept header'ı GET isteğinde farklı olabilir
-                # ama httpx genellikle bunu yönetir. Gerekirse özel header eklenebilir.
                 "X-Requested-With": "XMLHttpRequest",
             },
             timeout=request_timeout,
@@ -44,7 +42,7 @@ class DanistayApiClient:
         )
 
     def _prepare_keywords_for_api(self, keywords: List[str]) -> List[str]:
-        return [f'"{k.strip("\"")}"' for k in keywords if k and k.strip()]
+        return ['"' + k.strip('"') + '"' for k in keywords if k and k.strip()]
 
     async def search_keyword_decisions(
         self,
@@ -128,7 +126,7 @@ class DanistayApiClient:
         markdown_text = None
         temp_file_path = None
         try:
-            md_converter = MarkItDown(enable_plugins=False) # Basic conversion
+            md_converter = MarkItDown() # Basic conversion
             
             with tempfile.NamedTemporaryFile(mode="w", delete=False, suffix=".html", encoding="utf-8") as tmp_file:
                 tmp_file.write(html_input_for_markdown) # Write the full HTML string
@@ -145,14 +143,14 @@ class DanistayApiClient:
         
         return markdown_text
 
-    async def get_decision_document_as_markdown(self, document_id: str) -> DanistayDocumentMarkdown:
+    async def get_decision_document_as_markdown(self, id: str) -> DanistayDocumentMarkdown:
         """
         Retrieves a specific Danıştay decision by ID and returns its content as Markdown.
         The /getDokuman endpoint for Danıştay returns direct HTML.
         """
-        document_api_url = f"{self.DOCUMENT_ENDPOINT}?id={document_id}"
+        document_api_url = f"{self.DOCUMENT_ENDPOINT}?id={id}"
         source_url = f"{self.BASE_URL}{document_api_url}"
-        logger.info(f"DanistayApiClient: Fetching Danistay document for Markdown (ID: {document_id}) from {source_url}")
+        logger.info(f"DanistayApiClient: Fetching Danistay document for Markdown (ID: {id}) from {source_url}")
 
         try:
             # For direct HTML response, we might want different headers if the API is sensitive,
@@ -164,10 +162,10 @@ class DanistayApiClient:
             html_content_from_api = response.text
 
             if not isinstance(html_content_from_api, str) or not html_content_from_api.strip():
-                logger.warning(f"DanistayApiClient: Received empty or non-string HTML content for ID {document_id}.")
+                logger.warning(f"DanistayApiClient: Received empty or non-string HTML content for ID {id}.")
                 # Return with None markdown_content if HTML is effectively empty
                 return DanistayDocumentMarkdown(
-                    document_id=document_id,
+                    id=id,
                     markdown_content=None,
                     source_url=source_url
                 )
@@ -175,16 +173,16 @@ class DanistayApiClient:
             markdown_content = self._convert_html_to_markdown_danistay(html_content_from_api)
 
             return DanistayDocumentMarkdown(
-                document_id=document_id,
+                id=id,
                 markdown_content=markdown_content,
                 source_url=source_url
             )
         except httpx.RequestError as e:
-            logger.error(f"DanistayApiClient: HTTP error fetching Danistay document (ID: {document_id}): {e}")
+            logger.error(f"DanistayApiClient: HTTP error fetching Danistay document (ID: {id}): {e}")
             raise
         # Removed ValueError for JSON as Danistay /getDokuman returns direct HTML
         except Exception as e: # Catches other errors like MarkItDown issues if they propagate
-            logger.error(f"DanistayApiClient: General error processing Danistay document (ID: {document_id}): {e}")
+            logger.error(f"DanistayApiClient: General error processing Danistay document (ID: {id}): {e}")
             raise
 
     async def close_client_session(self):

danistay_mcp_module/models.py

@@ -1,6 +1,6 @@
 # danistay_mcp_module/models.py
 
-from pydantic import BaseModel, Field, HttpUrl
+from pydantic import BaseModel, Field, HttpUrl, ConfigDict
 from typing import List, Optional, Dict, Any
 
 class DanistayBaseSearchRequest(BaseModel):
@@ -21,10 +21,10 @@ class DanistayKeywordSearchRequestData(BaseModel):
 
 class DanistayKeywordSearchRequest(BaseModel): # This is the model the MCP tool will accept
     """Model for keyword-based search request for Danistay."""
-    andKelimeler: List[str] = Field(default_factory=list, description="Keywords for AND logic, e.g., ['word1', 'word2']")
-    orKelimeler: List[str] = Field(default_factory=list, description="Keywords for OR logic.")
-    notAndKelimeler: List[str] = Field(default_factory=list, description="Keywords for NOT AND logic.")
-    notOrKelimeler: List[str] = Field(default_factory=list, description="Keywords for NOT OR logic.")
+    andKelimeler: List[str] = Field(default_factory=list, description="Keywords for AND logic (VE Mantığı), e.g., ['word1', 'word2']")
+    orKelimeler: List[str] = Field(default_factory=list, description="Keywords for OR logic (VEYA Mantığı).")
+    notAndKelimeler: List[str] = Field(default_factory=list, description="Keywords for NOT AND logic (VE DEĞİL Mantığı).")
+    notOrKelimeler: List[str] = Field(default_factory=list, description="Keywords for NOT OR logic (VEYA DEĞİL Mantığı).")
     pageSize: int = Field(default=10, ge=1, le=100)
     pageNumber: int = Field(default=1, ge=1)
 
@@ -76,36 +76,34 @@ class DanistayApiDecisionEntry(BaseModel):
     id: str
     # The API response for keyword search uses "daireKurul", detailed search example uses "daire".
     # We use an alias to handle both and map to a consistent field name "chamber".
-    chamber: Optional[str] = Field(None, alias="daire", alt_alias="daireKurul", description="The chamber or board.")
+    chamber: Optional[str] = Field(None, alias="daire", description="The chamber or board.")
     esasNo: Optional[str] = Field(None)
     kararNo: Optional[str] = Field(None)
     kararTarihi: Optional[str] = Field(None)
-    arananKelime: Optional[str] = Field(None, description="Matched keyword if provided in response.")
+    arananKelime: Optional[str] = Field(None, description="Matched keyword (Aranan Kelime) if provided in response.")
     # index: Optional[int] = None # Present in response, can be added if needed by MCP tool
     # siraNo: Optional[int] = None # Present in detailed response, can be added
 
-    document_url: Optional[HttpUrl] = Field(None, description="URL to the full document, constructed by the client.")
+    document_url: Optional[HttpUrl] = Field(None, description="URL (Belge URL) to the full document, constructed by the client.")
 
-    class Config:
-        populate_by_name = True # Important for alias to work
-        extra = 'ignore' # Ignore any extra fields from API not defined in model
+    model_config = ConfigDict(populate_by_name=True, extra='ignore')  # Important for alias to work and ignore extra fields
 
 class DanistayApiResponseInnerData(BaseModel):
     """Model for the inner 'data' object in the Danistay API search response."""
     data: List[DanistayApiDecisionEntry]
     recordsTotal: int
     recordsFiltered: int
-    draw: Optional[int] = Field(None, description="Draw counter from API, usually for DataTables.")
+    draw: Optional[int] = Field(None, description="Draw counter (Çizim Sayıcısı) from API, usually for DataTables.")
 
 class DanistayApiResponse(BaseModel):
     """Model for the complete search response from the Danistay API."""
     data: DanistayApiResponseInnerData
-    metadata: Optional[Dict[str, Any]] = Field(None, description="Optional metadata from API.")
+    metadata: Optional[Dict[str, Any]] = Field(None, description="Optional metadata (Meta Veri) from API.")
 
 class DanistayDocumentMarkdown(BaseModel):
     """Model for a Danistay decision document, containing only Markdown content."""
-    document_id: str
-    markdown_content: Optional[str] = Field(None, description="The decision content converted to Markdown.")
+    id: str
+    markdown_content: Optional[str] = Field(None, description="The decision content (Karar İçeriği) converted to Markdown.")
     source_url: HttpUrl
 
 class CompactDanistaySearchResult(BaseModel):

docker-compose.yml

@@ -0,0 +1,66 @@
+version: '3.8'
+
+services:
+  yargi-mcp:
+    build: .
+    image: yargi-mcp:latest
+    container_name: yargi-mcp-server
+    ports:
+      - "${PORT:-8000}:8000"
+    environment:
+      - HOST=0.0.0.0
+      - PORT=8000
+      - LOG_LEVEL=${LOG_LEVEL:-info}
+      - ALLOWED_ORIGINS=${ALLOWED_ORIGINS:-*}
+      - API_TOKEN=${API_TOKEN:-}
+      - PYTHONUNBUFFERED=1
+    volumes:
+      # Mount logs directory
+      - ./logs:/app/logs
+      # Mount .env file if it exists
+      - ./.env:/app/.env:ro
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "python", "-c", "import httpx; httpx.get('http://localhost:8000/health').raise_for_status()"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s
+    networks:
+      - yargi-network
+
+  # Optional: Nginx reverse proxy
+  nginx:
+    image: nginx:alpine
+    container_name: yargi-nginx
+    ports:
+      - "80:80"
+      - "443:443"
+    volumes:
+      - ./nginx.conf:/etc/nginx/nginx.conf:ro
+      - ./ssl:/etc/nginx/ssl:ro
+    depends_on:
+      - yargi-mcp
+    networks:
+      - yargi-network
+    profiles:
+      - production
+
+  # Optional: Redis for caching (future enhancement)
+  redis:
+    image: redis:alpine
+    container_name: yargi-redis
+    command: redis-server --appendonly yes
+    volumes:
+      - redis-data:/data
+    networks:
+      - yargi-network
+    profiles:
+      - with-cache
+
+networks:
+  yargi-network:
+    driver: bridge
+
+volumes:
+  redis-data:

docs/DEPLOYMENT.md

@@ -0,0 +1,428 @@
+# Yargı MCP Server Dağıtım Rehberi
+
+Bu rehber, Yargı MCP Server'ın ASGI web servisi olarak çeşitli dağıtım seçeneklerini kapsar.
+
+## İçindekiler
+
+- [Hızlı Başlangıç](#hızlı-başlangıç)
+- [Yerel Geliştirme](#yerel-geliştirme)
+- [Production Dağıtımı](#production-dağıtımı)
+- [Cloud Dağıtımı](#cloud-dağıtımı)
+- [Docker Dağıtımı](#docker-dağıtımı)
+- [Güvenlik Hususları](#güvenlik-hususları)
+- [İzleme](#izleme)
+
+## Hızlı Başlangıç
+
+### 1. Bağımlılıkları Yükleyin
+
+```bash
+# ASGI sunucusu için uvicorn yükleyin
+pip install uvicorn
+
+# Veya tüm bağımlılıklarla birlikte yükleyin
+pip install -e .
+pip install uvicorn
+```
+
+### 2. Sunucuyu Çalıştırın
+
+```bash
+# Temel başlatma
+python run_asgi.py
+
+# Veya doğrudan uvicorn ile
+uvicorn asgi_app:app --host 0.0.0.0 --port 8000
+```
+
+Sunucu şu adreslerde kullanılabilir olacak:
+- MCP Endpoint: `http://localhost:8000/mcp/`
+- Sağlık Kontrolü: `http://localhost:8000/health`
+- API Durumu: `http://localhost:8000/status`
+
+## Yerel Geliştirme
+
+### Otomatik Yeniden Yükleme ile Geliştirme Sunucusu
+
+```bash
+python run_asgi.py --reload --log-level debug
+```
+
+### FastAPI Entegrasyonunu Kullanma
+
+Ek REST API endpoint'leri için:
+
+```bash
+uvicorn fastapi_app:app --reload
+```
+
+Bu şunları sağlar:
+- `/docs` adresinde interaktif API dokümantasyonu
+- `/api/tools` adresinde araç listesi
+- `/api/databases` adresinde veritabanı bilgileri
+
+### Ortam Değişkenleri
+
+`.env.example` dosyasını temel alarak bir `.env` dosyası oluşturun:
+
+```bash
+cp .env.example .env
+```
+
+Temel değişkenler:
+- `HOST`: Sunucu host adresi (varsayılan: 127.0.0.1)
+- `PORT`: Sunucu portu (varsayılan: 8000)
+- `ALLOWED_ORIGINS`: CORS kökenleri (virgülle ayrılmış)
+- `LOG_LEVEL`: Log seviyesi (debug, info, warning, error)
+
+## Production Dağıtımı
+
+### 1. Uvicorn ile Çoklu Worker Kullanımı
+
+```bash
+python run_asgi.py --host 0.0.0.0 --port 8000 --workers 4
+```
+
+### 2. Gunicorn Kullanımı
+
+```bash
+pip install gunicorn
+gunicorn asgi_app:app -w 4 -k uvicorn.workers.UvicornWorker --bind 0.0.0.0:8000
+```
+
+### 3. Nginx Reverse Proxy ile
+
+1. Nginx'i yükleyin
+2. Sağlanan `nginx.conf` dosyasını kullanın:
+
+```bash
+sudo cp nginx.conf /etc/nginx/sites-available/yargi-mcp
+sudo ln -s /etc/nginx/sites-available/yargi-mcp /etc/nginx/sites-enabled/
+sudo nginx -t
+sudo systemctl reload nginx
+```
+
+### 4. Systemd Servisi
+
+`/etc/systemd/system/yargi-mcp.service` dosyasını oluşturun:
+
+```ini
+[Unit]
+Description=Yargı MCP Server
+After=network.target
+
+[Service]
+Type=exec
+User=www-data
+WorkingDirectory=/opt/yargi-mcp
+Environment="PATH=/opt/yargi-mcp/venv/bin"
+ExecStart=/opt/yargi-mcp/venv/bin/uvicorn asgi_app:app --host 0.0.0.0 --port 8000 --workers 4
+Restart=on-failure
+RestartSec=5
+
+[Install]
+WantedBy=multi-user.target
+```
+
+Etkinleştirin ve başlatın:
+
+```bash
+sudo systemctl enable yargi-mcp
+sudo systemctl start yargi-mcp
+```
+
+## Cloud Dağıtımı
+
+### Heroku
+
+1. `Procfile` oluşturun:
+```
+web: uvicorn asgi_app:app --host 0.0.0.0 --port $PORT
+```
+
+2. Dağıtın:
+```bash
+heroku create uygulama-isminiz
+git push heroku main
+```
+
+### Railway
+
+1. `railway.json` ekleyin:
+```json
+{
+  "build": {
+    "builder": "NIXPACKS"
+  },
+  "deploy": {
+    "startCommand": "uvicorn asgi_app:app --host 0.0.0.0 --port $PORT"
+  }
+}
+```
+
+2. Railway CLI veya GitHub entegrasyonu ile dağıtın
+
+### Google Cloud Run
+
+1. Container oluşturun:
+```bash
+docker build -t yargi-mcp .
+docker tag yargi-mcp gcr.io/PROJE_ADINIZ/yargi-mcp
+docker push gcr.io/PROJE_ADINIZ/yargi-mcp
+```
+
+2. Dağıtın:
+```bash
+gcloud run deploy yargi-mcp \
+  --image gcr.io/PROJE_ADINIZ/yargi-mcp \
+  --platform managed \
+  --region us-central1 \
+  --allow-unauthenticated
+```
+
+### AWS Lambda (Mangum kullanarak)
+
+1. Mangum'u yükleyin:
+```bash
+pip install mangum
+```
+
+2. `lambda_handler.py` oluşturun:
+```python
+from mangum import Mangum
+from asgi_app import app
+
+handler = Mangum(app, lifespan="off")
+```
+
+3. AWS SAM veya Serverless Framework kullanarak dağıtın
+
+## Docker Dağıtımı
+
+### Tek Container
+
+```bash
+# Oluşturun
+docker build -t yargi-mcp .
+
+# Çalıştırın
+docker run -p 8000:8000 --env-file .env yargi-mcp
+```
+
+### Docker Compose
+
+```bash
+# Geliştirme
+docker-compose up
+
+# Nginx ile Production
+docker-compose --profile production up
+
+# Redis önbellekleme ile
+docker-compose --profile with-cache up
+```
+
+### Kubernetes
+
+Deployment YAML oluşturun:
+
+```yaml
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: yargi-mcp
+spec:
+  replicas: 3
+  selector:
+    matchLabels:
+      app: yargi-mcp
+  template:
+    metadata:
+      labels:
+        app: yargi-mcp
+    spec:
+      containers:
+      - name: yargi-mcp
+        image: yargi-mcp:latest
+        ports:
+        - containerPort: 8000
+        env:
+        - name: HOST
+          value: "0.0.0.0"
+        - name: PORT
+          value: "8000"
+        livenessProbe:
+          httpGet:
+            path: /health
+            port: 8000
+          initialDelaySeconds: 10
+          periodSeconds: 30
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: yargi-mcp-service
+spec:
+  selector:
+    app: yargi-mcp
+  ports:
+  - port: 80
+    targetPort: 8000
+  type: LoadBalancer
+```
+
+## Güvenlik Hususları
+
+### 1. Kimlik Doğrulama
+
+`API_TOKEN` ortam değişkenini ayarlayarak token kimlik doğrulamasını etkinleştirin:
+
+```bash
+export API_TOKEN=gizli-token-degeri
+```
+
+Ardından isteklere ekleyin:
+```bash
+curl -H "Authorization: Bearer gizli-token-degeri" http://localhost:8000/api/tools
+```
+
+### 2. HTTPS/SSL
+
+Production için her zaman HTTPS kullanın:
+
+1. SSL sertifikası edinin (Let's Encrypt vb.)
+2. Nginx veya cloud sağlayıcıda yapılandırın
+3. `ALLOWED_ORIGINS` değerini https:// kullanacak şekilde güncelleyin
+
+### 3. Rate Limiting (Hız Sınırlama)
+
+Sağlanan Nginx yapılandırması rate limiting içerir:
+- API endpoint'leri: 10 istek/saniye
+- MCP endpoint: 100 istek/saniye
+
+### 4. CORS Yapılandırması
+
+Production için belirli kaynaklara izin verin:
+
+```bash
+ALLOWED_ORIGINS=https://app.sizindomain.com,https://www.sizindomain.com
+```
+
+## İzleme
+
+### Sağlık Kontrolleri
+
+`/health` endpoint'ini izleyin:
+
+```bash
+curl http://localhost:8000/health
+```
+
+Yanıt:
+```json
+{
+  "status": "healthy",
+  "timestamp": "2024-12-26T10:00:00",
+  "uptime_seconds": 3600,
+  "tools_operational": true
+}
+```
+
+### Loglama
+
+Ortam değişkeni ile log seviyesini yapılandırın:
+
+```bash
+LOG_LEVEL=info  # veya debug, warning, error
+```
+
+Loglar şuraya yazılır:
+- Konsol (stdout)
+- `logs/mcp_server.log` dosyası
+
+### Metrikler (Opsiyonel)
+
+OpenTelemetry desteği için:
+
+```bash
+pip install opentelemetry-instrumentation-fastapi
+```
+
+Ortam değişkenlerini ayarlayın:
+```bash
+OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
+OTEL_SERVICE_NAME=yargi-mcp-server
+```
+
+## Sorun Giderme
+
+### Port Zaten Kullanımda
+
+```bash
+# 8000 portunu kullanan işlemi bulun
+lsof -i :8000
+
+# İşlemi sonlandırın
+kill -9 <PID>
+```
+
+### İzin Hataları
+
+Dosya izinlerinin doğru olduğundan emin olun:
+
+```bash
+chmod +x run_asgi.py
+chown -R www-data:www-data /opt/yargi-mcp
+```
+
+### Bellek Sorunları
+
+Büyük belge işleme için worker belleğini artırın:
+
+```bash
+# systemd servisinde
+Environment="PYTHONMALLOC=malloc"
+LimitNOFILE=65536
+```
+
+### Zaman Aşımı Sorunları
+
+Zaman aşımlarını ayarlayın:
+1. Uvicorn: `--timeout-keep-alive 75`
+2. Nginx: `proxy_read_timeout 300s;`
+3. Cloud sağlayıcılar: Platform özel zaman aşımı ayarlarını kontrol edin
+
+## Performans Ayarlama
+
+### 1. Worker İşlemleri
+
+- Geliştirme: 1 worker
+- Production: CPU çekirdeği başına 2-4 worker
+
+### 2. Bağlantı Havuzlama
+
+Sunucu varsayılan olarak httpx ile bağlantı havuzlama kullanır.
+
+### 3. Önbellekleme (Gelecek Geliştirme)
+
+Redis önbellekleme docker-compose ile etkinleştirilebilir:
+
+```bash
+docker-compose --profile with-cache up
+```
+
+### 4. Veritabanı Zaman Aşımları
+
+`.env` dosyasında veritabanı başına zaman aşımlarını ayarlayın:
+
+```bash
+YARGITAY_TIMEOUT=60
+DANISTAY_TIMEOUT=60
+ANAYASA_TIMEOUT=90
+```
+
+## Destek
+
+Sorunlar ve sorular için:
+- GitHub Issues: https://github.com/saidsurucu/yargi-mcp/issues
+- Dokümantasyon: README.md dosyasına bakın

emsal_mcp_module/client.py

@@ -116,7 +116,7 @@ class EmsalApiClient:
         markdown_text = None
         temp_file_path = None
         try:
-            md_converter = MarkItDown(enable_plugins=False)
+            md_converter = MarkItDown()
             
             with tempfile.NamedTemporaryFile(mode="w", delete=False, suffix=".html", encoding="utf-8") as tmp_file:
                 tmp_file.write(html_input_for_markdown)
@@ -133,14 +133,14 @@ class EmsalApiClient:
         
         return markdown_text
 
-    async def get_decision_document_as_markdown(self, document_id: str) -> EmsalDocumentMarkdown:
+    async def get_decision_document_as_markdown(self, id: str) -> EmsalDocumentMarkdown:
         """
         Retrieves a specific Emsal decision by ID and returns its content as Markdown.
         Assumes Emsal /getDokuman endpoint returns JSON with HTML content in the 'data' field.
         """
-        document_api_url = f"{self.DOCUMENT_ENDPOINT}?id={document_id}"
+        document_api_url = f"{self.DOCUMENT_ENDPOINT}?id={id}"
         source_url = f"{self.BASE_URL}{document_api_url}"
-        logger.info(f"EmsalApiClient: Fetching Emsal document for Markdown (ID: {document_id}) from {source_url}")
+        logger.info(f"EmsalApiClient: Fetching Emsal document for Markdown (ID: {id}) from {source_url}")
 
         try:
             response = await self.http_client.get(document_api_url)
@@ -151,24 +151,24 @@ class EmsalApiClient:
             html_content_from_api = response_json.get("data")
 
             if not isinstance(html_content_from_api, str) or not html_content_from_api.strip():
-                logger.warning(f"EmsalApiClient: Received empty or non-string HTML in 'data' field for Emsal ID {document_id}.")
-                return EmsalDocumentMarkdown(document_id=document_id, markdown_content=None, source_url=source_url)
+                logger.warning(f"EmsalApiClient: Received empty or non-string HTML in 'data' field for Emsal ID {id}.")
+                return EmsalDocumentMarkdown(id=id, markdown_content=None, source_url=source_url)
 
             markdown_content = self._clean_html_and_convert_to_markdown_emsal(html_content_from_api)
 
             return EmsalDocumentMarkdown(
-                document_id=document_id,
+                id=id,
                 markdown_content=markdown_content,
                 source_url=source_url
             )
         except httpx.RequestError as e:
-            logger.error(f"EmsalApiClient: HTTP error fetching Emsal document (ID: {document_id}): {e}")
+            logger.error(f"EmsalApiClient: HTTP error fetching Emsal document (ID: {id}): {e}")
             raise
         except ValueError as e: 
-            logger.error(f"EmsalApiClient: ValueError processing Emsal document response (ID: {document_id}): {e}")
+            logger.error(f"EmsalApiClient: ValueError processing Emsal document response (ID: {id}): {e}")
             raise
         except Exception as e:
-            logger.error(f"EmsalApiClient: General error processing Emsal document (ID: {document_id}): {e}")
+            logger.error(f"EmsalApiClient: General error processing Emsal document (ID: {id}): {e}")
             raise
 
     async def close_client_session(self):

emsal_mcp_module/models.py

@@ -1,6 +1,6 @@
 # emsal_mcp_module/models.py
 
-from pydantic import BaseModel, Field, HttpUrl
+from pydantic import BaseModel, Field, HttpUrl, ConfigDict
 from typing import List, Optional, Dict, Any
 
 class EmsalDetailedSearchRequestData(BaseModel):
@@ -17,7 +17,7 @@ class EmsalDetailedSearchRequestData(BaseModel):
     # Add other specific court type fields from the form if they are separate keys in payload
     # E.g., "Ceza Mahkemeleri", "İdari Mahkemeler" etc.
     
-    birimHukukMah: Optional[str] = Field("", description="List of selected Regional Civil Chambers, '+' separated.") 
+    birimHukukMah: Optional[str] = Field("", description="List of selected Regional Civil Chambers (Bölge Hukuk Mahkemeleri), '+' separated.") 
 
     esasYil: Optional[str] = ""
     esasIlkSiraNo: Optional[str] = ""
@@ -32,31 +32,29 @@ class EmsalDetailedSearchRequestData(BaseModel):
     pageSize: int
     pageNumber: int
     
-    class Config:
-        populate_by_name = True # Enables use of alias in serialization (when dumping to dict for payload)
-        # anystr_strip_whitespace = True # Optional: strip whitespace from strings
+    model_config = ConfigDict(populate_by_name=True)  # Enables use of alias in serialization (when dumping to dict for payload)
 
 class EmsalSearchRequest(BaseModel): # This is the model the MCP tool will accept
     """Model for Emsal detailed search request, with user-friendly field names."""
-    keyword: Optional[str] = Field(None, description="Keyword to search.")
+    keyword: Optional[str] = Field(None, description="Keyword (Anahtar Kelime) to search.")
     
-    selected_bam_civil_court: Optional[str] = Field(None, description="Selected BAM Civil Court (maps to 'Bam Hukuk Mahkemeleri' payload key).")
-    selected_civil_court: Optional[str] = Field(None, description="Selected Civil Court (maps to 'Hukuk Mahkemeleri' payload key).")
-    selected_regional_civil_chambers: Optional[List[str]] = Field(default_factory=list, description="Selected Regional Civil Chambers (for 'birimHukukMah', joined by '+').")
+    selected_bam_civil_court: Optional[str] = Field(None, description="Selected BAM Civil Court (Seçilen BAM Hukuk Mahkemesi) (maps to 'Bam Hukuk Mahkemeleri' payload key).")
+    selected_civil_court: Optional[str] = Field(None, description="Selected Civil Court (Seçilen Hukuk Mahkemesi) (maps to 'Hukuk Mahkemeleri' payload key).")
+    selected_regional_civil_chambers: Optional[List[str]] = Field(default_factory=list, description="Selected Regional Civil Chambers (Seçilen Bölge Hukuk Daireleri) (for 'birimHukukMah', joined by '+').")
 
-    case_year_esas: Optional[str] = Field(None, description="Case year for 'Esas No'.")
-    case_start_seq_esas: Optional[str] = Field(None, description="Starting sequence for 'Esas No'.")
-    case_end_seq_esas: Optional[str] = Field(None, description="Ending sequence for 'Esas No'.")
+    case_year_esas: Optional[str] = Field(None, description="Case year (Dava Yılı) for 'Esas No'.")
+    case_start_seq_esas: Optional[str] = Field(None, description="Starting sequence (Başlangıç Sırası) for 'Esas No'.")
+    case_end_seq_esas: Optional[str] = Field(None, description="Ending sequence (Bitiş Sırası) for 'Esas No'.")
     
-    decision_year_karar: Optional[str] = Field(None, description="Decision year for 'Karar No'.")
-    decision_start_seq_karar: Optional[str] = Field(None, description="Starting sequence for 'Karar No'.")
-    decision_end_seq_karar: Optional[str] = Field(None, description="Ending sequence for 'Karar No'.")
+    decision_year_karar: Optional[str] = Field(None, description="Decision year (Karar Yılı) for 'Karar No'.")
+    decision_start_seq_karar: Optional[str] = Field(None, description="Starting sequence (Başlangıç Sırası) for 'Karar No'.")
+    decision_end_seq_karar: Optional[str] = Field(None, description="Ending sequence (Bitiş Sırası) for 'Karar No'.")
     
-    start_date: Optional[str] = Field(None, description="Start date for decision (DD.MM.YYYY).")
-    end_date: Optional[str] = Field(None, description="End date for decision (DD.MM.YYYY).")
+    start_date: Optional[str] = Field(None, description="Start date (Başlangıç Tarihi) for decision (DD.MM.YYYY).")
+    end_date: Optional[str] = Field(None, description="End date (Bitiş Tarihi) for decision (DD.MM.YYYY).")
     
-    sort_criteria: str = Field("1", description="Sorting criteria (e.g., 1: Esas No).")
-    sort_direction: str = Field("desc", description="Sorting direction ('asc' or 'desc').")
+    sort_criteria: str = Field("1", description="Sorting criteria (Sıralama Kriteri) (e.g., 1: Esas No).")
+    sort_direction: str = Field("desc", description="Sorting direction (Sıralama Yönü) ('asc' or 'desc').")
     
     page_number: int = Field(default=1, ge=1)
     page_size: int = Field(default=10, ge=1, le=100)
@@ -65,35 +63,34 @@ class EmsalSearchRequest(BaseModel): # This is the model the MCP tool will accep
 class EmsalApiDecisionEntry(BaseModel):
     """Model for an individual decision entry from the Emsal API search response."""
     id: str
-    daire: Optional[str] = Field(None, description="The chamber/court that made the decision.")
+    daire: Optional[str] = Field(None, description="The chamber/court (Daire/Mahkeme) that made the decision.")
     esasNo: Optional[str] = Field(None)
     kararNo: Optional[str] = Field(None)
     kararTarihi: Optional[str] = Field(None)
-    arananKelime: Optional[str] = Field(None, description="Matched keyword from the search.")
-    durum: Optional[str] = Field(None, description="Status of the decision (e.g., 'KESİNLEŞMEDİ').")
+    arananKelime: Optional[str] = Field(None, description="Matched keyword (Aranan Kelime) from the search.")
+    durum: Optional[str] = Field(None, description="Status (Durum) of the decision (e.g., 'KESİNLEŞMEDİ').")
     # index: Optional[int] = None # Present in Emsal response, can be added if tool needs it
 
-    document_url: Optional[HttpUrl] = Field(None, description="URL to the full document, constructed by the client.")
+    document_url: Optional[HttpUrl] = Field(None, description="URL (Belge URL) to the full document, constructed by the client.")
 
-    class Config:
-        extra = 'ignore'
+    model_config = ConfigDict(extra='ignore')
 
 class EmsalApiResponseInnerData(BaseModel):
     """Model for the inner 'data' object in the Emsal API search response."""
     data: List[EmsalApiDecisionEntry]
     recordsTotal: int
     recordsFiltered: int
-    draw: Optional[int] = Field(None, description="Draw counter from API, usually for DataTables.")
+    draw: Optional[int] = Field(None, description="Draw counter (Çizim Sayıcısı) from API, usually for DataTables.")
 
 class EmsalApiResponse(BaseModel):
     """Model for the complete search response from the Emsal API."""
     data: EmsalApiResponseInnerData
-    metadata: Optional[Dict[str, Any]] = Field(None, description="Optional metadata from API, if any.")
+    metadata: Optional[Dict[str, Any]] = Field(None, description="Optional metadata (Meta Veri) from API, if any.")
 
 class EmsalDocumentMarkdown(BaseModel):
     """Model for an Emsal decision document, containing only Markdown content."""
-    document_id: str
-    markdown_content: Optional[str] = Field(None, description="The decision content converted to Markdown.")
+    id: str
+    markdown_content: Optional[str] = Field(None, description="The decision content (Karar İçeriği) converted to Markdown.")
     source_url: HttpUrl
 
 class CompactEmsalSearchResult(BaseModel):

fly.toml

@@ -0,0 +1,34 @@
+# fly.toml app configuration file generated for yargi-mcp on 2025-06-29T00:23:47+03:00
+#
+# See https://fly.io/docs/reference/configuration/ for information about how to use this file.
+#
+
+app = 'yargi-mcp'
+primary_region = 'fra'
+
+[env]
+ENABLE_AUTH = "true"
+HOST = "0.0.0.0"
+PORT = "8000"
+LOG_LEVEL = "info"
+
+[build]
+
+[http_service]
+  internal_port = 8000
+  force_https = true
+  auto_stop_machines = 'stop'
+  auto_start_machines = true
+  min_machines_running = 0
+  processes = ['app']
+
+[[vm]]
+  memory = '1gb'
+  cpu_kind = 'shared'
+  cpus = 1
+
+[checks.http_health]             # keep MCP /health live
+  type     = "http"
+  interval = "30s"
+  timeout  = "10s"
+  path     = "/health"

install.bat

@@ -1,18 +0,0 @@
-@echo off
-echo Yargi MCP Kurulum Script'i (install.py) baslatiliyor...
-
-REM Python'in PATH'de oldugunu varsayiyoruz.
-REM Kullanici sistemine gore "python" veya "py -3" veya "python3" olabilir.
-REM Oncelikle "python" deneyelim.
-python install.py
-if errorlevel 1 (
-    echo "python install.py" komutu basarisiz oldu. "py -3 install.py" deneniyor...
-    py -3 install.py
-    if errorlevel 1 (
-        echo "py -3 install.py" komutu da basarisiz oldu.
-        echo Lutfen Python 3'un sisteminizde kurulu ve PATH'de oldugundan emin olun.
-    )
-)
-
-echo.
-pause

install.py

@@ -1,302 +0,0 @@
-# install.py
-
-import subprocess
-import sys
-import os
-import shutil
-import platform
-from urllib.parse import urlencode, urljoin, quote 
-
-# --- Yapılandırma ---
-MCP_SERVER_SCRIPT_NAME = "mcp_server_main.py"
-CLAUDE_TOOL_NAME = "Yargı MCP" 
-DEPENDENCIES_FOR_FASTMCP = [
-    "httpx", "beautifulsoup4", "markitdown", "pydantic", "aiohttp"
-]
-
-# --- Yardımcı Fonksiyonlar ---
-def print_info(message):
-    print(f"[INFO] {message}")
-
-def print_warning(message):
-    print(f"[UYARI] {message}")
-
-def print_error(message):
-    print(f"[HATA] {message}")
-
-def command_exists(command_parts):
-    """Bir komutun sistemde var olup olmadığını kontrol eder ve yolunu döndürür."""
-    try:
-        command_to_check = command_parts[0] if isinstance(command_parts, list) else command_parts
-        found_path = shutil.which(command_to_check)
-        if found_path:
-            return found_path
-        if platform.system() == "Windows" and not command_to_check.endswith(".exe"):
-            # .exe olmadan da PATH'de bulunabilir (örn: pyenv shims)
-            # ama yine de .exe ile de kontrol edelim
-            path_with_exe = shutil.which(command_to_check + ".exe")
-            if path_with_exe:
-                return path_with_exe
-        return None
-    except Exception:
-        return None
-
-def run_command(command_parts, capture_output_flag=False, check_return_code=True, shell=False, cwd=None, log_output_on_success=False):
-    """Verilen komutu çalıştırır."""
-    cmd_str_for_log = ' '.join(command_parts) if isinstance(command_parts, list) else command_parts
-    print_info(f"Komut çalıştırılıyor: {cmd_str_for_log}")
-    
-    kwargs = {
-        "text": True,
-        "shell": shell,
-        "cwd": cwd,
-        "encoding": 'utf-8',
-        "errors": 'replace' # Handles potential decoding errors in output
-    }
-
-    if capture_output_flag:
-        kwargs["capture_output"] = True
-    # Else, stdout/stderr go to console by default (unless shell redirects them)
-
-    try:
-        process = subprocess.run(command_parts, **kwargs)
-        
-        if capture_output_flag:
-            if log_output_on_success and process.returncode == 0:
-                if process.stdout: print_info(f"Stdout:\n{process.stdout.strip()}")
-                if process.stderr: print_warning(f"Stderr:\n{process.stderr.strip()}")
-            elif process.returncode != 0: # Always log output on error if captured
-                if process.stdout: print_error(f"Hata Stdout:\n{process.stdout.strip()}")
-                if process.stderr: print_error(f"Hata Stderr:\n{process.stderr.strip()}")
-
-        if check_return_code and process.returncode != 0:
-            raise subprocess.CalledProcessError(process.returncode, cmd_str_for_log, output=process.stdout, stderr=process.stderr)
-            
-        return process
-    except subprocess.CalledProcessError as e:
-        # run_command already printed details if capture_output_flag was true
-        if not capture_output_flag: # If output went to console, just print a simpler error
-             print_error(f"Komut hatası (return code {e.returncode}): {cmd_str_for_log}")
-        raise 
-    except FileNotFoundError:
-        print_error(f"Komut bulunamadı: {command_parts[0] if isinstance(command_parts, list) else command_parts.split()[0]}")
-        raise
-    except Exception as e:
-        print_error(f"Komut çalıştırılırken beklenmedik hata ({cmd_str_for_log}): {type(e).__name__} - {e}")
-        raise
-
-def get_python_executable():
-    """Kullanılabilir Python 3 çalıştırılabilir dosyasını bulur."""
-    print_info("Python 3 yorumlayıcısı aranıyor...")
-    # Önce mevcut çalışan Python'u dene
-    current_python = sys.executable
-    if current_python:
-        try:
-            print_info(f"Mevcut Python deneniyor: {current_python}")
-            result = run_command([current_python, "-c", "import sys; assert sys.version_info.major == 3, 'Not Python 3'"], capture_output_flag=True, log_output_on_success=False)
-            if result.returncode == 0:
-                print_info(f"Kullanılacak Python: {current_python}")
-                return current_python
-        except Exception as e:
-            print_warning(f"Mevcut Python ({current_python}) kontrol edilirken sorun: {e}")
-
-    # PATH'deki python3 ve python komutlarını dene
-    for cmd_name in ["python3", "python"]:
-        found_cmd_path = command_exists(cmd_name)
-        if found_cmd_path:
-            try:
-                print_info(f"PATH'de bulunan '{cmd_name}' deneniyor: {found_cmd_path}")
-                result = run_command([found_cmd_path, "-c", "import sys; assert sys.version_info.major == 3, 'Not Python 3'; print(sys.executable)"], capture_output_flag=True, log_output_on_success=False)
-                if result.returncode == 0 and result.stdout:
-                    resolved_path = result.stdout.strip()
-                    print_info(f"Kullanılacak Python: {resolved_path} ('{cmd_name}' komutu ile bulundu)")
-                    return resolved_path
-            except Exception as e:
-                print_warning(f"'{cmd_name}' ({found_cmd_path}) kontrol edilirken sorun: {e}")
-                
-    print_error("Python 3 sisteminizde bulunamadı veya PATH'e doğru şekilde eklenmemiş.")
-    print_error("Lütfen Python 3'ü (https://www.python.org/downloads/) kurun.")
-    sys.exit(1)
-
-
-# --- Kurulum Fonksiyonları ---
-def install_uv(python_exe_path):
-    print_info("Adım 1/3: uv kontrol ediliyor/kuruluyor...")
-    uv_executable = command_exists("uv")
-    if uv_executable:
-        print_info(f"uv zaten kurulu: {uv_executable}")
-        run_command([uv_executable, "--version"], capture_output_flag=True, log_output_on_success=True)
-        return uv_executable
-
-    print_info("uv kurulu değil. Kurulum denenecek...")
-    try:
-        if platform.system() == "Windows":
-            print_info("PowerShell ile uv indirme ve kurma script'i çalıştırılacak.")
-            run_command([
-                "powershell", "-ExecutionPolicy", "Bypass", "-NoProfile", "-NonInteractive",
-                "-Command", "try { irm https://astral.sh/uv/install.ps1 | iex } catch { Write-Error $_; exit 1 }"
-            ], shell=False)
-        else: 
-            print_info("curl ile uv kurulum script'i çalıştırılacak.")
-            process = subprocess.run("curl -LsSf https://astral.sh/uv/install.sh | sh", shell=True, capture_output=True, text=True, encoding='utf-8', errors='replace')
-            if process.stdout: print_info(f"uv install script stdout:\n{process.stdout}")
-            if process.stderr: print_warning(f"uv install script stderr:\n{process.stderr}")
-            if process.returncode != 0:
-                raise subprocess.CalledProcessError(process.returncode, "curl ... | sh")
-        
-        uv_executable = command_exists("uv") 
-        if not uv_executable: # PATH'e hemen yansımamış olabilir, bilinen yerleri kontrol et
-            common_paths_uv = []
-            if platform.system() == "Windows":
-                cargo_uv_path = os.path.join(os.environ.get("USERPROFILE", ""), ".cargo", "bin", "uv.exe")
-                localapp_uv_path = os.path.join(os.environ.get("LOCALAPPDATA", ""), "uv", "uv.exe")
-                if os.path.exists(cargo_uv_path): common_paths_uv.append(cargo_uv_path)
-                if os.path.exists(localapp_uv_path): common_paths_uv.append(localapp_uv_path)
-            else: # macOS / Linux
-                common_paths_uv.extend([
-                    os.path.join(os.environ.get("HOME", ""), ".cargo", "bin", "uv"),
-                    os.path.join(os.environ.get("HOME", ""), ".local", "bin", "uv")
-                ])
-            for p_uv in common_paths_uv:
-                if command_exists(p_uv): uv_executable = p_uv; break
-        
-        if uv_executable and command_exists(uv_executable):
-            print_info(f"uv başarıyla kuruldu/bulundu: {uv_executable}")
-            run_command([uv_executable, "--version"], capture_output_flag=True, log_output_on_success=True)
-            return uv_executable
-        else: # Son çare pip
-            print_warning("uv resmi script ile kuruldu/bulundu ancak PATH'de doğrulanamadı. pip ile deneniyor...")
-            run_command([python_exe_path, "-m", "pip", "install", "uv"])
-            uv_executable = command_exists("uv")
-            if uv_executable:
-                print_info(f"uv pip ile başarıyla kuruldu: {uv_executable}")
-                run_command([uv_executable, "--version"], capture_output_flag=True, log_output_on_success=True)
-                return uv_executable
-            print_error("uv pip ile de kurulamadı. Lütfen manuel kurulum yapın: https://astral.sh/uv")
-            return None
-    except Exception as e:
-        print_error(f"uv kurulumu sırasında genel bir hata oluştu: {e}")
-        print_warning("Lütfen uv'yi manuel olarak kurmayı deneyin: https://astral.sh/uv")
-        return None
-
-def install_fastmcp_cli(python_exe_path, uv_exe_path): # uv_exe_path artık kullanılmıyor
-    """fastmcp CLI'yi kontrol eder ve gerekirse pip/pip3 ile kurar."""
-    print_info("Adım 2/3: fastmcp CLI kontrol ediliyor/kuruluyor...")
-    fastmcp_executable = command_exists("fastmcp")
-    if fastmcp_executable:
-        print_info(f"fastmcp CLI zaten kurulu: {fastmcp_executable}")
-        run_command([fastmcp_executable, "version"], capture_output_flag=True, log_output_on_success=True)
-        return fastmcp_executable
-
-    print_info("fastmcp CLI kurulu değil. pip/pip3 ile kurulum denenecek...")
-    try:
-        pip_cmd_to_try = [python_exe_path, "-m", "pip", "install", "fastmcp"]
-        print_info(f"{' '.join(pip_cmd_to_try)} komutu deneniyor...")
-        run_command(pip_cmd_to_try)
-        
-        fastmcp_executable = command_exists("fastmcp")
-        if fastmcp_executable:
-            print_info(f"fastmcp CLI başarıyla kuruldu: {fastmcp_executable}")
-            run_command([fastmcp_executable, "version"], capture_output_flag=True, log_output_on_success=True)
-            return fastmcp_executable
-        else: 
-            scripts_dir = os.path.dirname(python_exe_path)
-            if platform.system() == "Windows" and not scripts_dir.lower().endswith("scripts"):
-                 scripts_dir = os.path.join(scripts_dir, "Scripts")
-            potential_fastmcp_path = os.path.join(scripts_dir, "fastmcp.exe" if platform.system() == "Windows" else "fastmcp")
-            if command_exists(potential_fastmcp_path):
-                print_info(f"fastmcp CLI şu yolda bulundu: {potential_fastmcp_path}")
-                run_command([potential_fastmcp_path, "version"], capture_output_flag=True, log_output_on_success=True)
-                return potential_fastmcp_path
-            else:
-                print_error("fastmcp CLI kuruldu ancak PATH'de veya bilinen Python script yollarında bulunamadı.")
-                print_error("Lütfen terminalinizi yeniden başlatın veya PATH'i manuel güncelleyin.")
-                return None
-    except Exception as e:
-        print_error(f"fastmcp CLI kurulumu sırasında hata oluştu: {e}")
-        return None
-
-def install_tool_to_claude_desktop(fastmcp_exe_path):
-    """Yargı MCP sunucusunu Claude Desktop'a kurar."""
-    print_info(f"Adım 3/3: \"{CLAUDE_TOOL_NAME}\" Claude Desktop'a kuruluyor...")
-    if not os.path.exists(MCP_SERVER_SCRIPT_NAME):
-        print_error(f"Ana sunucu script'i '{MCP_SERVER_SCRIPT_NAME}' bulunamadı.")
-        print_error("Lütfen bu script'i ana sunucu script'inin bulunduğu dizinde çalıştırın.")
-        return False
-
-    dependencies_cmd_part = []
-    for dep in DEPENDENCIES_FOR_FASTMCP:
-        dependencies_cmd_part.extend(["--with", dep])
-    
-    install_command = [
-        fastmcp_exe_path, "install", MCP_SERVER_SCRIPT_NAME,
-        "--name", CLAUDE_TOOL_NAME
-    ] + dependencies_cmd_part
-    
-    try:
-        process = run_command(install_command, capture_output_flag=True, check_return_code=False, log_output_on_success=False)
-        if process.returncode == 0:
-            print_info(f"\"{CLAUDE_TOOL_NAME}\" başarıyla Claude Desktop'a kuruldu/güncellendi.")
-            if process.stdout: print_info(f"fastmcp install stdout:\n{process.stdout.strip()}")
-            if process.stderr: print_warning(f"fastmcp install stderr:\n{process.stderr.strip()}")
-            return True
-        else:
-            error_output = (process.stdout or "") + (process.stderr or "")
-            if "claude app not found" in error_output.lower():
-                print_error("Claude Desktop uygulaması sisteminizde bulunamadı veya algılanamadı.")
-                print_error("Lütfen Claude Desktop'ın kurulu ve çalışır durumda olduğundan emin olun.")
-                print_error("Claude Desktop'ı https://claude.ai/download adresinden indirebilirsiniz.")
-            else:
-                print_error(f"Sunucu Claude Desktop'a kurulurken hata oluştu (return code {process.returncode}).")
-                print_error("Lütfen fastmcp CLI'nin düzgün çalıştığından emin olun.")
-                if process.stderr: print_error(f"fastmcp install stderr:\n{process.stderr.strip()}")
-                if process.stdout: print_info(f"fastmcp install stdout (hata durumunda):\n{process.stdout.strip()}")
-            return False
-    except Exception as e:
-        print_error(f"Sunucu Claude Desktop'a kurulurken genel bir hata oluştu: {e}")
-        return False
-
-# --- Ana Kurulum Mantığı ---
-def main():
-    print("===================================================================")
-    print(" Yargi MCP Sunucusu - Python Kurulum Script'i")
-    print("===================================================================")
-    
-    if platform.system() == "Windows":
-        confirm = input("Bu script, uv ve fastmcp araclarini kuracak ve Yargi MCP sunucusunu Claude Desktop'a entegre edecektir. Devam etmek istiyor musunuz? (E/H): ")
-        if confirm.lower() != 'e':
-            print_info("Kurulum kullanıcı tarafından iptal edildi.")
-            sys.exit(0)
-    
-    python_executable = get_python_executable()
-    uv_executable_path = install_uv(python_executable) # uv hala öneriliyor fastmcp install için
-    
-    fastmcp_executable_path = install_fastmcp_cli(python_executable, uv_executable_path) # uv_exe_path burada kullanılmıyor
-    if not fastmcp_executable_path:
-        print_error("fastmcp CLI kurulumu başarısız oldu. Kurulum sonlandırılıyor.")
-        sys.exit(1)
-
-    if not install_tool_to_claude_desktop(fastmcp_executable_path):
-        print_error("Claude Desktop'a kurulum başarısız oldu.")
-        sys.exit(1)
-
-    print_info("===================================================================")
-    print_info(" KURULUM BAŞARIYLA TAMAMLANDI!")
-    print_info("===================================================================")
-    print_info(f"- \"{CLAUDE_TOOL_NAME}\" aracı Claude Desktop'a eklenmiş olmalıdır.")
-    print_info("- Değişikliklerin etkili olması için Claude Desktop'ı yeniden başlatmanız gerekebilir.")
-    print_info("- Eğer uv veya fastmcp PATH'e yeni eklendiyse, terminalinizi de yeniden başlatmanız gerekebilir.")
-
-if __name__ == "__main__":
-    try:
-        main()
-    except SystemExit: 
-        pass # sys.exit() çağrıldığında script sonlansın
-    except Exception as e:
-        print_error(f"Beklenmedik bir genel hata oluştu: {e}")
-        sys.exit(1)
-    finally:
-        if platform.system() == "Windows":
-            input("Çıkmak için Enter tuşuna basın...")
-        else:
-            print("Kurulum script'i tamamlandı.")

install.sh

@@ -1,54 +0,0 @@
-#!/bin/bash
-
-# --- Script Bilgileri ---
-echo "==================================================================="
-echo " Yargi MCP Sunucusu - Kurulum Başlatıcı (macOS/Linux)"
-echo "==================================================================="
-echo " Bu script, Yargi MCP sunucusunun kurulumu için gerekli olan"
-echo " Python script'ini (install.py) çalıştıracaktır."
-echo ""
-read -p "Devam etmek istiyor musunuz? (E/H): " continue_script
-if [[ ! "$continue_script" =~ ^[Ee]$ ]]; then
-    echo "Kurulum iptal edildi."
-    exit 0
-fi
-echo ""
-
-# --- Python Yorumlayıcısını Bul ve install.py'yi Çalıştır ---
-PYTHON_EXECUTABLE=""
-
-# Öncelikle python3'ü dene
-if command -v python3 &>/dev/null; then
-    PYTHON_EXECUTABLE="python3"
-# Sonra python'u dene (Python 3 olduğundan emin olmak için install.py içinde kontrol var)
-elif command -v python &>/dev/null; then
-    PYTHON_EXECUTABLE="python"
-fi
-
-if [ -z "$PYTHON_EXECUTABLE" ]; then
-    echo "[HATA] Sisteminizde Python 3 bulunamadı veya PATH'e eklenmemiş."
-    echo "Lütfen Python 3'ü (https://www.python.org/downloads/) kurun."
-    exit 1
-fi
-
-echo "[INFO] '$PYTHON_EXECUTABLE install.py' komutu çalıştırılıyor..."
-echo "-------------------------------------------------------------------"
-
-"$PYTHON_EXECUTABLE" install.py
-
-# install.py script'inin çıkış kodunu kontrol et
-INSTALL_EXIT_CODE=$?
-
-echo "-------------------------------------------------------------------"
-if [ $INSTALL_EXIT_CODE -eq 0 ]; then
-    echo "[INFO] install.py script'i başarıyla tamamlandı."
-else
-    echo "[HATA] install.py script'i bir hatayla sonlandı (Çıkış Kodu: $INSTALL_EXIT_CODE)."
-    echo "[HATA] Lütfen yukarıdaki hata mesajlarını kontrol edin."
-fi
-
-echo ""
-# Pencerenin hemen kapanmaması için (özellikle çift tıklanarak çalıştırılırsa)
-read -p "Kurulum script'i tamamlandı. Çıkmak için Enter tuşuna basın..."
-
-exit $INSTALL_EXIT_CODE

kik_mcp_module/client.py

@@ -0,0 +1,441 @@
+# kik_mcp_module/client.py
+import asyncio
+from playwright.async_api import (
+    async_playwright, 
+    Page, 
+    BrowserContext, 
+    Browser, 
+    Error as PlaywrightError, 
+    TimeoutError as PlaywrightTimeoutError
+)
+from bs4 import BeautifulSoup
+import logging
+from typing import Dict, Any, List, Optional
+import urllib.parse 
+import base64 # Base64 için
+import re
+import html as html_parser 
+from markitdown import MarkItDown 
+import os
+import math 
+import tempfile
+
+from .models import (
+    KikSearchRequest,
+    KikDecisionEntry,
+    KikSearchResult,
+    KikDocumentMarkdown,
+    KikKararTipi
+)
+
+logger = logging.getLogger(__name__)
+
+class KikApiClient:
+    BASE_URL = "https://ekap.kik.gov.tr"
+    SEARCH_PAGE_PATH = "/EKAP/Vatandas/kurulkararsorgu.aspx"
+    FIELD_LOCATORS = {
+        "karar_tipi_radio_group": "input[name='ctl00$ContentPlaceHolder1$kurulKararTip']",
+        "karar_no": "input[name='ctl00$ContentPlaceHolder1$txtKararNo']",
+        "karar_tarihi_baslangic": "input[name='ctl00$ContentPlaceHolder1$etKararTarihBaslangic$EkapTakvimTextBox_etKararTarihBaslangic']",
+        "karar_tarihi_bitis": "input[name='ctl00$ContentPlaceHolder1$etKararTarihBitis$EkapTakvimTextBox_etKararTarihBitis']",
+        "resmi_gazete_sayisi": "input[name='ctl00$ContentPlaceHolder1$txtResmiGazeteSayisi']",
+        "resmi_gazete_tarihi": "input[name='ctl00$ContentPlaceHolder1$etResmiGazeteTarihi$EkapTakvimTextBox_etResmiGazeteTarihi']",
+        "basvuru_konusu_ihale": "input[name='ctl00$ContentPlaceHolder1$txtBasvuruKonusuIhale']",
+        "basvuru_sahibi": "input[name='ctl00$ContentPlaceHolder1$txtSikayetci']",
+        "ihaleyi_yapan_idare": "input[name='ctl00$ContentPlaceHolder1$txtIhaleyiYapanIdare']",
+        "yil": "select[name='ctl00$ContentPlaceHolder1$ddlYil']",
+        "karar_metni": "input[name='ctl00$ContentPlaceHolder1$txtKararMetni']",
+        "search_button_id": "ctl00_ContentPlaceHolder1_btnAra" 
+    }
+    RESULTS_TABLE_ID = "grdKurulKararSorguSonuc"
+    NO_RESULTS_MESSAGE_SELECTOR = "div#ctl00_MessageContent1" 
+    VALIDATION_SUMMARY_SELECTOR = "div#ctl00_ValidationSummary1"
+    MODAL_CLOSE_BUTTON_SELECTOR = "div#detayPopUp.in a#btnKapatPencere_0.close"
+    DOCUMENT_MARKDOWN_CHUNK_SIZE = 5000 
+
+    def __init__(self, request_timeout: float = 60000): 
+        self.playwright_instance: Optional[async_playwright] = None
+        self.browser: Optional[Browser] = None
+        self.context: Optional[BrowserContext] = None
+        self.page: Optional[Page] = None
+        self.request_timeout = request_timeout 
+        self._lock = asyncio.Lock()
+
+    async def _ensure_playwright_ready(self, force_new_page: bool = False):
+        async with self._lock:
+            browser_recreated = False
+            context_recreated = False
+            if not self.playwright_instance:
+                self.playwright_instance = await async_playwright().start()
+            if not self.browser or not self.browser.is_connected():
+                if self.browser: await self.browser.close()
+                self.browser = await self.playwright_instance.chromium.launch(headless=True) 
+                browser_recreated = True 
+            if not self.context or browser_recreated:
+                if self.context: await self.context.close()
+                if not self.browser: raise PlaywrightError("Browser not initialized.")
+                self.context = await self.browser.new_context(
+                    user_agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.0.0 Safari/537.36",
+                    java_script_enabled=True,
+                )
+                context_recreated = True 
+            if not self.page or self.page.is_closed() or force_new_page or context_recreated or browser_recreated:
+                if self.page and not self.page.is_closed(): await self.page.close()
+                if not self.context: raise PlaywrightError("Context is None.")
+                self.page = await self.context.new_page()
+                if not self.page: raise PlaywrightError("Failed to create new page.")
+                self.page.set_default_navigation_timeout(self.request_timeout)
+                self.page.set_default_timeout(self.request_timeout)
+            if not self.page or self.page.is_closed(): 
+                raise PlaywrightError("Playwright page initialization failed.")
+            logger.debug("_ensure_playwright_ready completed.")
+
+    async def close_client_session(self):
+        async with self._lock:
+            # ... (öncekiyle aynı)
+            if self.page and not self.page.is_closed(): await self.page.close(); self.page = None
+            if self.context: await self.context.close(); self.context = None
+            if self.browser: await self.browser.close(); self.browser = None
+            if self.playwright_instance: await self.playwright_instance.stop(); self.playwright_instance = None
+            logger.info("KikApiClient (Playwright): Resources closed.")
+
+    def _parse_decision_entries_from_soup(self, soup: BeautifulSoup, search_karar_tipi: KikKararTipi) -> List[KikDecisionEntry]:
+        entries: List[KikDecisionEntry] = []
+        table = soup.find("table", {"id": self.RESULTS_TABLE_ID})
+        if not table: return entries
+        rows = table.find_all("tr")
+        for row_idx, row in enumerate(rows):
+            if row_idx < 2: continue             
+            cells = row.find_all("td")
+            if len(cells) == 6:
+                try:
+                    preview_button_tag = cells[0].find("a", id=re.compile(r"btnOnizle$"))
+                    event_target = ""
+                    if preview_button_tag and preview_button_tag.has_attr('href'):
+                        match = re.search(r"__doPostBack\('([^']*)','([^']*)'\)", preview_button_tag['href'])
+                        if match: event_target = match.group(1)                    
+                    karar_no_span = cells[1].find("span", id=re.compile(r"lblKno$"))
+                    karar_tarihi_span = cells[2].find("span", id=re.compile(r"lblKtar$"))
+                    idare_span = cells[3].find("span", id=re.compile(r"lblIdare$"))
+                    basvuru_sahibi_span = cells[4].find("span", id=re.compile(r"lblSikayetci$"))
+                    ihale_span = cells[5].find("span", id=re.compile(r"lblIhale$"))
+                    if not (event_target and karar_no_span and karar_tarihi_span): continue
+                    
+                    # Karar tipini arama parametresinden alıyoruz, çünkü HTML'de direkt olarak bulunmuyor.
+                    entry = KikDecisionEntry(
+                        preview_event_target=event_target,
+                        kararNo=karar_no_span.get_text(strip=True), 
+                        karar_tipi=search_karar_tipi, # Arama yapılan karar tipini ekle
+                        kararTarihi=karar_tarihi_span.get_text(strip=True),
+                        idare=idare_span.get_text(strip=True) if idare_span else None,
+                        basvuruSahibi=basvuru_sahibi_span.get_text(strip=True) if basvuru_sahibi_span else None,
+                        ihaleKonusu=ihale_span.get_text(strip=True) if ihale_span else None,
+                    )
+                    entries.append(entry)
+                except Exception as e:
+                    logger.error(f"Error parsing a KIK decision entry row: {e}", exc_info=True)
+        return entries
+        
+    def _parse_total_records_from_soup(self, soup: BeautifulSoup) -> int:
+        # ... (öncekiyle aynı) ...
+        try:
+            pager_div = soup.find("div", class_="gridToplamSayi")
+            if pager_div:
+                match = re.search(r"Toplam Kayıt Sayısı:(\d+)", pager_div.get_text(strip=True))
+                if match: return int(match.group(1))
+        except: pass 
+        return 0
+        
+    def _parse_current_page_from_soup(self, soup: BeautifulSoup) -> int:
+        # ... (öncekiyle aynı) ...
+        try:
+            pager_div = soup.find("div", class_="sayfalama")
+            if pager_div:
+                active_page_span = pager_div.find("span", class_="active")
+                if active_page_span: return int(active_page_span.get_text(strip=True))
+        except: pass
+        return 1
+
+    async def search_decisions(self, search_params: KikSearchRequest) -> KikSearchResult:
+        await self._ensure_playwright_ready()
+        page = self.page 
+        search_url = f"{self.BASE_URL}{self.SEARCH_PAGE_PATH}"
+        try:
+            if page.url != search_url:
+                await page.goto(search_url, wait_until="networkidle", timeout=self.request_timeout)
+            search_button_selector = f"a[id='{self.FIELD_LOCATORS['search_button_id']}']"
+            await page.wait_for_selector(search_button_selector, state="visible", timeout=self.request_timeout)
+
+            current_karar_tipi_value = search_params.karar_tipi.value
+            radio_locator_selector = f"{self.FIELD_LOCATORS['karar_tipi_radio_group']}[value='{current_karar_tipi_value}']"
+            if not await page.locator(radio_locator_selector).is_checked():
+                 js_target_radio = f"ctl00$ContentPlaceHolder1${current_karar_tipi_value}"
+                 async with page.expect_navigation(wait_until="networkidle", timeout=self.request_timeout):
+                     await page.evaluate(f"javascript:__doPostBack('{js_target_radio}','')")
+                 await page.wait_for_timeout(1000) 
+
+            async def fill_if_value(selector_key: str, value: Optional[str]):
+                if value is not None: await page.fill(self.FIELD_LOCATORS[selector_key], value)
+            
+            # Karar No'yu KİK sitesine göndermeden önce '_' -> '/' dönüşümü yap
+            karar_no_for_kik_form = None
+            if search_params.karar_no: # search_params.karar_no Claude'dan '_' ile gelmiş olabilir
+                karar_no_for_kik_form = search_params.karar_no.replace('_', '/')
+                logger.info(f"Using karar_no '{karar_no_for_kik_form}' (transformed from '{search_params.karar_no}') for KIK form.")
+            
+            await fill_if_value('karar_metni', search_params.karar_metni)
+            await fill_if_value('karar_no', karar_no_for_kik_form) # Dönüştürülmüş halini kullan
+            # ... (diğer fill_if_value çağrıları aynı) ...
+            await fill_if_value('karar_tarihi_baslangic', search_params.karar_tarihi_baslangic)
+            await fill_if_value('karar_tarihi_bitis', search_params.karar_tarihi_bitis)
+            await fill_if_value('resmi_gazete_sayisi', search_params.resmi_gazete_sayisi)
+            await fill_if_value('resmi_gazete_tarihi', search_params.resmi_gazete_tarihi)
+            await fill_if_value('basvuru_konusu_ihale', search_params.basvuru_konusu_ihale)
+            await fill_if_value('basvuru_sahibi', search_params.basvuru_sahibi)
+            await fill_if_value('ihaleyi_yapan_idare', search_params.ihaleyi_yapan_idare)
+
+            if search_params.yil:
+                await page.select_option(self.FIELD_LOCATORS['yil'], value=search_params.yil)
+
+            action_is_search_button_click = (search_params.page == 1)
+            event_target_for_submit: str
+            if action_is_search_button_click:
+                event_target_for_submit = self.FIELD_LOCATORS['search_button_id']
+            else: # Pagination
+                page_link_ctl_number = search_params.page + 2 
+                event_target_for_submit = f"ctl00$ContentPlaceHolder1$grdKurulKararSorguSonuc$ctl14$ctl{page_link_ctl_number:02d}"
+            
+            try:
+                async with page.expect_navigation(wait_until="networkidle", timeout=self.request_timeout):
+                    if action_is_search_button_click:
+                        await page.locator(search_button_selector).click()
+                    else: 
+                        await page.evaluate(f"javascript:__doPostBack('{event_target_for_submit}','')")
+            except PlaywrightTimeoutError:
+                await page.wait_for_timeout(2000) 
+            
+            results_table_dom_selector = f"table#{self.RESULTS_TABLE_ID}"
+            try:
+                await page.wait_for_selector(results_table_dom_selector, timeout=30000, state="attached")
+                await page.wait_for_timeout(2000) 
+            except PlaywrightTimeoutError:
+                logger.warning(f"Timeout waiting for results table '{results_table_dom_selector}'.")
+            
+            html_content = await page.content()
+            soup = BeautifulSoup(html_content, "html.parser")
+            # ... (hata ve sonuç yok mesajı kontrolü aynı) ...
+            validation_summary_tag = soup.find("div", id=self.VALIDATION_SUMMARY_SELECTOR.split('[')[0].split(':')[0])
+            if validation_summary_tag and validation_summary_tag.get_text(strip=True) and \
+               ("display: none" not in validation_summary_tag.get("style", "").lower() if validation_summary_tag.has_attr("style") else True) and \
+               validation_summary_tag.get_text(strip=True) != "":
+                return KikSearchResult(decisions=[], total_records=0, current_page=search_params.page)
+            message_content_div = soup.find("div", id=self.NO_RESULTS_MESSAGE_SELECTOR.split(':')[0])
+            if message_content_div and "kayıt bulunamamıştır" in message_content_div.get_text(strip=True).lower():
+                return KikSearchResult(decisions=[], total_records=0, current_page=1)
+
+            # _parse_decision_entries_from_soup'a arama yapılan karar_tipi'ni gönder
+            decisions = self._parse_decision_entries_from_soup(soup, search_params.karar_tipi)
+            total_records = self._parse_total_records_from_soup(soup)
+            current_page_from_html = self._parse_current_page_from_soup(soup)
+            return KikSearchResult(decisions=decisions, total_records=total_records, current_page=current_page_from_html)
+        except Exception as e: 
+            logger.error(f"Error during KIK decision search: {e}", exc_info=True)
+            return KikSearchResult(decisions=[], current_page=search_params.page)
+
+    def _clean_html_for_markdown(self, html_content: str) -> str:
+        # ... (öncekiyle aynı) ...
+        if not html_content: return ""
+        return html_parser.unescape(html_content)
+
+    def _convert_html_to_markdown_internal(self, html_fragment: str) -> Optional[str]:
+        # ... (öncekiyle aynı) ...
+        if not html_fragment: return None
+        cleaned_html = self._clean_html_for_markdown(html_fragment)
+        markdown_output = None; temp_file_path = None
+        try:
+            md_converter = MarkItDown(enable_plugins=True, remove_alt_whitespace=True, keep_underline=True)
+            with tempfile.NamedTemporaryFile(mode="w", delete=False, suffix=".html", encoding="utf-8") as tmp_html_file:
+                tmp_html_file.write(cleaned_html); temp_file_path = tmp_html_file.name
+            markdown_output = md_converter.convert(temp_file_path).text_content
+            if markdown_output: markdown_output = re.sub(r'\n{3,}', '\n\n', markdown_output).strip()
+        except Exception as e: logger.error(f"MarkItDown conversion error: {e}", exc_info=True)
+        finally:
+            if temp_file_path and os.path.exists(temp_file_path): os.remove(temp_file_path)
+        return markdown_output
+
+
+    async def get_decision_document_as_markdown(
+            self, 
+            karar_id_b64: str, 
+            page_number: int = 1 
+        ) -> KikDocumentMarkdown:
+        await self._ensure_playwright_ready()
+        # Bu metodun kendi içinde yeni bir 'page' nesnesi ('doc_page_for_content') kullanacağını unutmayın,
+        # ana 'self.page' arama sonuçları sayfasında kalır.
+        current_main_page = self.page # Ana arama sonuçları sayfasını referans alalım
+
+        try:
+            decoded_key = base64.b64decode(karar_id_b64.encode('utf-8')).decode('utf-8')
+            karar_tipi_value, karar_no_for_search = decoded_key.split('|', 1)
+            original_karar_tipi = KikKararTipi(karar_tipi_value)
+            logger.info(f"KIK Get Detail: Decoded karar_id '{karar_id_b64}' to Karar Tipi: {original_karar_tipi.value}, Karar No: {karar_no_for_search}. Requested Markdown Page: {page_number}")
+        except Exception as e_decode:
+            logger.error(f"Invalid karar_id format. Could not decode Base64 or split: {karar_id_b64}. Error: {e_decode}")
+            return KikDocumentMarkdown(retrieved_with_karar_id=karar_id_b64, error_message="Invalid karar_id format.", current_page=page_number)
+
+        default_error_response_data = {
+            "retrieved_with_karar_id": karar_id_b64,
+            "retrieved_karar_no": karar_no_for_search,
+            "retrieved_karar_tipi": original_karar_tipi,
+            "error_message": "An unspecified error occurred.",
+            "current_page": page_number, "total_pages": 1, "is_paginated": False
+        }
+        
+        # Ana arama sayfasında olduğumuzdan emin olalım
+        if self.SEARCH_PAGE_PATH not in current_main_page.url:
+            logger.info(f"Not on search page ({current_main_page.url}). Navigating to {self.SEARCH_PAGE_PATH} before targeted search for document.")
+            await current_main_page.goto(f"{self.BASE_URL}{self.SEARCH_PAGE_PATH}", wait_until="networkidle", timeout=self.request_timeout)
+            await current_main_page.wait_for_selector(f"a[id='{self.FIELD_LOCATORS['search_button_id']}']", state="visible", timeout=self.request_timeout)
+
+        targeted_search_params = KikSearchRequest(
+            karar_no=karar_no_for_search, 
+            karar_tipi=original_karar_tipi,
+            page=1 
+        )
+        logger.info(f"Performing targeted search for Karar No: {karar_no_for_search}")
+        # search_decisions kendi içinde _ensure_playwright_ready çağırır ve self.page'i kullanır.
+        # Bu, current_main_page ile aynı olmalı.
+        search_results = await self.search_decisions(targeted_search_params)
+
+        if not search_results.decisions:
+            default_error_response_data["error_message"] = f"Decision with Karar No '{karar_no_for_search}' (Tipi: {original_karar_tipi.value}) not found by internal search."
+            return KikDocumentMarkdown(**default_error_response_data)
+
+        decision_to_fetch = None
+        for dec_entry in search_results.decisions:
+            if dec_entry.karar_no_str == karar_no_for_search and dec_entry.karar_tipi == original_karar_tipi:
+                decision_to_fetch = dec_entry
+                break
+        
+        if not decision_to_fetch:
+            default_error_response_data["error_message"] = f"Karar No '{karar_no_for_search}' (Tipi: {original_karar_tipi.value}) not present with an exact match in first page of targeted search results."
+            return KikDocumentMarkdown(**default_error_response_data)
+
+        decision_preview_event_target = decision_to_fetch.preview_event_target
+        logger.info(f"Found target decision. Using preview_event_target: {decision_preview_event_target} for Karar No: {decision_to_fetch.karar_no_str}")
+        
+        iframe_document_url_str = None
+        karar_id_param_from_url_on_doc_page = None
+        document_html_content = ""
+
+        try:
+            logger.info(f"Evaluating __doPostBack on main page to show modal for: {decision_preview_event_target}")
+            # Bu evaluate, self.page (yani current_main_page) üzerinde çalışır
+            await current_main_page.evaluate(f"javascript:__doPostBack('{decision_preview_event_target}','')")
+            await current_main_page.wait_for_timeout(1000) 
+            logger.info(f"Executed __doPostBack for {decision_preview_event_target} on main page.")
+            
+            iframe_selector = "iframe#iframe_detayPopUp"
+            modal_visible_selector = "div#detayPopUp.in" 
+
+            try:
+                logger.info(f"Waiting for modal '{modal_visible_selector}' to be visible and iframe '{iframe_selector}' src to be populated on main page...")
+                await current_main_page.wait_for_function(
+                    f"""
+                    () => {{
+                        const modal = document.querySelector('{modal_visible_selector}');
+                        const iframe = document.querySelector('{iframe_selector}');
+                        const modalIsTrulyVisible = modal && (window.getComputedStyle(modal).display !== 'none');
+                        return modalIsTrulyVisible && 
+                               iframe && iframe.getAttribute('src') && 
+                               iframe.getAttribute('src').includes('KurulKararGoster.aspx');
+                    }}
+                    """,
+                    timeout=self.request_timeout / 2 
+                )
+                iframe_src_value = await current_main_page.locator(iframe_selector).get_attribute("src")
+                logger.info(f"Iframe src populated: {iframe_src_value}")
+
+            except PlaywrightTimeoutError:
+                 logger.warning(f"Timeout waiting for KIK iframe src for {decision_preview_event_target}. Trying to parse from static content after presumed update.")
+                 html_after_postback = await current_main_page.content()
+                 # ... (fallback parsing öncekiyle aynı, default_error_response_data set edilir ve return edilir) ...
+                 soup_after_postback = BeautifulSoup(html_after_postback, "html.parser")
+                 detay_popup_div = soup_after_postback.find("div", {"id": "detayPopUp", "class": re.compile(r"\bin\b")})
+                 if not detay_popup_div: detay_popup_div = soup_after_postback.find("div", {"id": "detayPopUp", "style": re.compile(r"display:\s*block", re.I)})
+                 iframe_tag = detay_popup_div.find("iframe", {"id": "iframe_detayPopUp"}) if detay_popup_div else None
+                 if iframe_tag and iframe_tag.has_attr("src") and iframe_tag["src"]: iframe_src_value = iframe_tag["src"]
+                 else:
+                    default_error_response_data["error_message"]="Timeout or failure finding decision content iframe URL after postback."
+                    return KikDocumentMarkdown(**default_error_response_data)
+            
+            if not iframe_src_value or not iframe_src_value.strip():
+                default_error_response_data["error_message"]="Extracted iframe URL for decision content is empty."
+                return KikDocumentMarkdown(**default_error_response_data)
+
+            # iframe_src_value göreceli bir URL ise, ana sayfanın URL'si ile birleştir
+            iframe_document_url_str = urllib.parse.urljoin(current_main_page.url, iframe_src_value)
+            logger.info(f"Constructed absolute iframe_document_url_str for goto: {iframe_document_url_str}") # Log this absolute URL
+            default_error_response_data["source_url"] = iframe_document_url_str
+            
+            parsed_url = urllib.parse.urlparse(iframe_document_url_str)
+            query_params = urllib.parse.parse_qs(parsed_url.query)
+            karar_id_param_from_url_on_doc_page = query_params.get("KararId", [None])[0] 
+            default_error_response_data["karar_id_param_from_url"] = karar_id_param_from_url_on_doc_page
+            if not karar_id_param_from_url_on_doc_page:
+                 default_error_response_data["error_message"]="KararId (KIK internal ID) not found in extracted iframe URL."
+                 return KikDocumentMarkdown(**default_error_response_data)
+
+            logger.info(f"Fetching KIK decision content from iframe URL using a new Playwright page: {iframe_document_url_str}")
+            
+            doc_page_for_content = await self.context.new_page() 
+            try:
+                # `goto` metoduna MUTLAK URL verilmeli. Loglanan URL'nin mutlak olduğundan emin olalım.
+                await doc_page_for_content.goto(iframe_document_url_str, wait_until="domcontentloaded", timeout=self.request_timeout)
+                document_html_content = await doc_page_for_content.content()
+            except Exception as e_doc_page:
+                logger.error(f"Error navigating or getting content from doc_page ({iframe_document_url_str}): {e_doc_page}")
+                if doc_page_for_content and not doc_page_for_content.is_closed(): await doc_page_for_content.close()
+                default_error_response_data["error_message"]=f"Failed to load decision detail page: {e_doc_page}"
+                return KikDocumentMarkdown(**default_error_response_data)
+            finally:
+                if doc_page_for_content and not doc_page_for_content.is_closed(): 
+                    await doc_page_for_content.close() 
+
+            soup_decision_detail = BeautifulSoup(document_html_content, "html.parser")
+            karar_content_span = soup_decision_detail.find("span", {"id": "ctl00_ContentPlaceHolder1_lblKarar"})
+            actual_decision_html = karar_content_span.decode_contents() if karar_content_span else document_html_content
+            full_markdown_content = self._convert_html_to_markdown_internal(actual_decision_html)
+
+            if not full_markdown_content:
+                 default_error_response_data["error_message"]="Markdown conversion failed or returned empty content."
+                 try: 
+                    if await current_main_page.locator(self.MODAL_CLOSE_BUTTON_SELECTOR).is_visible(timeout=1000):
+                        await current_main_page.locator(self.MODAL_CLOSE_BUTTON_SELECTOR).click()
+                 except: pass
+                 return KikDocumentMarkdown(**default_error_response_data)
+
+            content_length = len(full_markdown_content); total_pages = math.ceil(content_length / self.DOCUMENT_MARKDOWN_CHUNK_SIZE) or 1
+            current_page_clamped = max(1, min(page_number, total_pages))
+            start_index = (current_page_clamped - 1) * self.DOCUMENT_MARKDOWN_CHUNK_SIZE
+            markdown_chunk = full_markdown_content[start_index : start_index + self.DOCUMENT_MARKDOWN_CHUNK_SIZE]
+            
+            try: 
+                if await current_main_page.locator(self.MODAL_CLOSE_BUTTON_SELECTOR).is_visible(timeout=2000): 
+                    await current_main_page.locator(self.MODAL_CLOSE_BUTTON_SELECTOR).click()
+                    await current_main_page.wait_for_selector(f"div#detayPopUp:not(.in)", timeout=5000) 
+            except: pass
+
+            return KikDocumentMarkdown(
+                retrieved_with_karar_id=karar_id_b64,
+                retrieved_karar_no=karar_no_for_search,
+                retrieved_karar_tipi=original_karar_tipi,
+                kararIdParam=karar_id_param_from_url_on_doc_page, 
+                markdown_chunk=markdown_chunk, source_url=iframe_document_url_str,
+                current_page=current_page_clamped, total_pages=total_pages,
+                is_paginated=(total_pages > 1), full_content_char_count=content_length
+            )
+        except Exception as e: 
+            logger.error(f"Error in get_decision_document_as_markdown for Karar ID {karar_id_b64}: {e}", exc_info=True)
+            default_error_response_data["error_message"] = f"General error: {str(e)}"
+            return KikDocumentMarkdown(**default_error_response_data)

kik_mcp_module/models.py

@@ -0,0 +1,75 @@
+# kik_mcp_module/models.py
+from pydantic import BaseModel, Field, HttpUrl, computed_field, ConfigDict
+from typing import List, Optional
+from enum import Enum
+import base64 # Base64 encoding/decoding için
+
+class KikKararTipi(str, Enum):
+    """Enum for KIK (Public Procurement Authority) Decision Types."""
+    UYUSMAZLIK = "rbUyusmazlik"
+    DUZENLEYICI = "rbDuzenleyici"
+    MAHKEME = "rbMahkeme"
+
+class KikSearchRequest(BaseModel):
+    """Model for KIK Decision search criteria."""
+    karar_tipi: KikKararTipi = Field(KikKararTipi.UYUSMAZLIK, description="Type of KIK Decision.")
+    karar_no: Optional[str] = Field(None, description="Decision Number (e.g., '2024/UH.II-1766').")
+    karar_tarihi_baslangic: Optional[str] = Field(None, description="Decision Date Start (DD.MM.YYYY).", pattern=r"^\d{2}\.\d{2}\.\d{4}$")
+    karar_tarihi_bitis: Optional[str] = Field(None, description="Decision Date End (DD.MM.YYYY).", pattern=r"^\d{2}\.\d{2}\.\d{4}$")
+    resmi_gazete_sayisi: Optional[str] = Field(None, description="Official Gazette Number.")
+    resmi_gazete_tarihi: Optional[str] = Field(None, description="Official Gazette Date (DD.MM.YYYY).", pattern=r"^\d{2}\.\d{2}\.\d{4}$")
+    basvuru_konusu_ihale: Optional[str] = Field(None, description="Tender subject of the application.")
+    basvuru_sahibi: Optional[str] = Field(None, description="Applicant.")
+    ihaleyi_yapan_idare: Optional[str] = Field(None, description="Procuring Entity.")
+    yil: Optional[str] = Field(None, description="Year of the decision.")
+    karar_metni: Optional[str] = Field(None, description="Keyword/phrase in decision text.")
+    page: int = Field(1, ge=1, description="Results page number.")
+
+class KikDecisionEntry(BaseModel):
+    """Represents a single decision entry from KIK search results."""
+    preview_event_target: str = Field(..., description="Internal event target for fetching details.")
+    karar_no_str: str = Field(..., alias="kararNo", description="Raw decision number as extracted from KIK (e.g., '2024/UH.II-1766').")
+    karar_tipi: KikKararTipi = Field(..., description="The type of decision this entry belongs to.")
+    
+    karar_tarihi_str: str = Field(..., alias="kararTarihi", description="Decision date.")
+    idare_str: Optional[str] = Field(None, alias="idare", description="Procuring entity.")
+    basvuru_sahibi_str: Optional[str] = Field(None, alias="basvuruSahibi", description="Applicant.")
+    ihale_konusu_str: Optional[str] = Field(None, alias="ihaleKonusu", description="Tender subject.")
+
+    @computed_field
+    @property
+    def karar_id(self) -> str:
+        """
+        A Base64 encoded unique ID for the decision, combining decision type and number.
+        Format before encoding: "{karar_tipi.value}|{karar_no_str}"
+        """
+        combined_key = f"{self.karar_tipi.value}|{self.karar_no_str}"
+        return base64.b64encode(combined_key.encode('utf-8')).decode('utf-8')
+
+    model_config = ConfigDict(populate_by_name=True)
+
+class KikSearchResult(BaseModel):
+    """Model for KIK search results."""
+    decisions: List[KikDecisionEntry]
+    total_records: int = 0
+    current_page: int = 1
+
+class KikDocumentMarkdown(BaseModel):
+    """
+    KIK decision document, with Markdown content potentially paginated.
+    """
+    retrieved_with_karar_id: Optional[str] = Field(None, description="The Base64 encoded karar_id that was used to request this document.")
+    # Decode edilmiş karar no ve tipini de yanıt olarak ekleyelim, Claude için faydalı olabilir.
+    retrieved_karar_no: Optional[str] = Field(None, description="The raw KIK Decision Number (e.g., '2024/UH.II-1766') this document pertains to.")
+    retrieved_karar_tipi: Optional[KikKararTipi] = Field(None, description="The KIK Decision Type this document pertains to.")
+    
+    karar_id_param_from_url: Optional[str] = Field(None, alias="kararIdParam", description="The KIK system's internal KararId parameter from the document's display URL (KurulKararGoster.aspx).")
+    markdown_chunk: Optional[str] = Field(None, description="The requested chunk of the decision content converted to Markdown.")
+    source_url: Optional[str] = Field(None, description="The source URL of the original document (KurulKararGoster.aspx).")
+    error_message: Optional[str] = Field(None, description="Error message if document retrieval or processing failed.")
+    current_page: int = Field(1, description="The current page number of the markdown chunk being returned.")
+    total_pages: int = Field(1, description="The total number of pages the full markdown content is divided into.")
+    is_paginated: bool = Field(False, description="True if the full markdown content is split into multiple pages.")
+    full_content_char_count: Optional[int] = Field(None, description="Total character count of the full markdown content before chunking.")
+
+    model_config = ConfigDict(populate_by_name=True)

mcp_auth/__init__.py

@@ -0,0 +1,28 @@
+"""
+MCP Auth Toolkit - OAuth 2.1 + Authorization for Model Context Protocol Servers
+Integrated with Clerk Authentication
+"""
+
+from .middleware import (
+    AuthContext,
+    FastMCPAuthWrapper,
+    MCPAuthMiddleware,
+    auth_required,
+)
+from .oauth import OAuthConfig, OAuthProvider
+from .policy import PolicyEngine, ToolPolicy, create_default_policies
+from .storage import PersistentStorage
+
+__version__ = "0.1.0"
+__all__ = [
+    "OAuthProvider",
+    "OAuthConfig", 
+    "AuthContext",
+    "auth_required",
+    "create_default_policies",
+    "MCPAuthMiddleware",
+    "FastMCPAuthWrapper",
+    "PolicyEngine",
+    "ToolPolicy",
+    "PersistentStorage",
+]

mcp_auth/clerk_config.py

@@ -0,0 +1,73 @@
+"""
+Clerk OAuth configuration for MCP Auth Toolkit
+"""
+
+import os
+import logging
+from .oauth import OAuthConfig
+
+logger = logging.getLogger(__name__)
+
+
+def create_clerk_oauth_config() -> OAuthConfig:
+    """Create OAuth configuration for Clerk integration using SDK"""
+    
+    # Get Clerk configuration from environment
+    clerk_domain = os.getenv("CLERK_DOMAIN", "accounts.yargimcp.com")
+    clerk_publishable_key = os.getenv("CLERK_PUBLISHABLE_KEY")
+    clerk_secret_key = os.getenv("CLERK_SECRET_KEY")
+    
+    if not clerk_publishable_key or not clerk_secret_key:
+        raise ValueError("CLERK_PUBLISHABLE_KEY and CLERK_SECRET_KEY are required")
+    
+    # For Clerk with custom domains, we use our adapter endpoints
+    # This allows us to handle the custom domain flow properly
+    base_url = os.getenv("BASE_URL", "https://yargimcp.com")
+    
+    config = OAuthConfig(
+        client_id=clerk_publishable_key,
+        client_secret=clerk_secret_key,
+        # Use our adapter endpoints instead of Clerk's direct endpoints
+        authorization_endpoint=f"{base_url}/authorize",
+        token_endpoint=f"{base_url}/token",
+        # Keep Clerk's JWKS for token validation
+        jwks_uri=f"https://{clerk_domain}/.well-known/jwks.json",
+        issuer=base_url,  # We're the issuer for MCP tokens
+        scopes=["mcp:tools:read", "mcp:tools:write", "openid", "profile", "email"]
+    )
+    
+    logger.info(f"Created Clerk OAuth config with adapter endpoints")
+    logger.info(f"Clerk domain: {clerk_domain}")
+    logger.debug(f"Authorization endpoint: {config.authorization_endpoint}")
+    logger.debug(f"Token endpoint: {config.token_endpoint}")
+    
+    return config
+
+
+def get_jwt_secret() -> str:
+    """Get JWT secret for token signing"""
+    jwt_secret = os.getenv("JWT_SECRET_KEY")
+    
+    if not jwt_secret:
+        raise ValueError("JWT_SECRET_KEY environment variable is required")
+    
+    return jwt_secret
+
+
+def create_mcp_server_config():
+    """Create complete MCP server configuration for Clerk integration"""
+    
+    try:
+        oauth_config = create_clerk_oauth_config()
+        jwt_secret = get_jwt_secret()
+        
+        return {
+            "oauth_config": oauth_config,
+            "jwt_secret": jwt_secret,
+            "base_url": os.getenv("BASE_URL", "https://yargi-mcp.fly.dev"),
+            "auth_enabled": os.getenv("ENABLE_AUTH", "true").lower() == "true"
+        }
+        
+    except Exception as e:
+        logger.error(f"Failed to create MCP server config: {e}")
+        raise

mcp_auth/middleware.py

@@ -0,0 +1,315 @@
+"""
+MCP server middleware for OAuth authentication and authorization
+"""
+
+import functools
+import logging
+from collections.abc import Callable
+from dataclasses import dataclass
+from typing import Any, Optional
+
+logger = logging.getLogger(__name__)
+
+try:
+    from fastmcp import FastMCP
+    FASTMCP_AVAILABLE = True
+except ImportError:
+    FASTMCP_AVAILABLE = False
+    FastMCP = None
+    logger.warning("FastMCP not available, some features will be disabled")
+
+from .oauth import OAuthProvider
+from .policy import PolicyEngine
+
+
+@dataclass
+class AuthContext:
+    """Authentication context passed to MCP tools"""
+
+    user_id: str
+    scopes: list[str]
+    claims: dict[str, Any]
+    token: str
+
+
+class MCPAuthMiddleware:
+    """Authentication middleware for MCP servers"""
+
+    def __init__(self, oauth_provider: OAuthProvider, policy_engine: PolicyEngine):
+        self.oauth_provider = oauth_provider
+        self.policy_engine = policy_engine
+
+    def authenticate_request(self, authorization_header: str) -> AuthContext | None:
+        """Extract and validate auth token from request"""
+
+        if not authorization_header:
+            logger.debug("No authorization header provided")
+            return None
+
+        if not authorization_header.startswith("Bearer "):
+            logger.debug("Authorization header does not start with 'Bearer '")
+            return None
+
+        token = authorization_header[7:]  # Remove 'Bearer ' prefix
+
+        token_info = self.oauth_provider.introspect_token(token)
+
+        if not token_info.get("active"):
+            logger.warning("Token is not active")
+            return None
+
+        logger.debug(f"Authenticated user: {token_info.get('sub', 'unknown')}")
+
+        return AuthContext(
+            user_id=token_info.get("sub", "unknown"),
+            scopes=token_info.get("mcp_tool_scopes", []),
+            claims=token_info,
+            token=token,
+        )
+
+    def authorize_tool_call(
+        self, tool_name: str, auth_context: AuthContext
+    ) -> tuple[bool, str | None]:
+        """Check if user can call the specified tool"""
+
+        return self.policy_engine.authorize_tool_call(
+            tool_name=tool_name,
+            user_scopes=auth_context.scopes,
+            user_claims=auth_context.claims,
+        )
+
+
+def auth_required(
+    oauth_provider: OAuthProvider,
+    policy_engine: PolicyEngine,
+    tool_name: str | None = None,
+):
+    """
+    Decorator to require authentication for MCP tool functions
+
+    Usage:
+        @auth_required(oauth_provider, policy_engine, "search_yargitay")
+        def my_tool_function(context: AuthContext, ...):
+            pass
+    """
+
+    def decorator(func: Callable) -> Callable:
+        middleware = MCPAuthMiddleware(oauth_provider, policy_engine)
+
+        @functools.wraps(func)
+        async def wrapper(*args, **kwargs):
+            # Extract authorization header from kwargs
+            auth_header = kwargs.pop("authorization", None)
+            
+            # Also check in args if it's a Request object
+            if not auth_header and args:
+                for arg in args:
+                    if hasattr(arg, 'headers'):
+                        auth_header = arg.headers.get("Authorization")
+                        break
+
+            if not auth_header:
+                logger.warning(f"No authorization header for tool '{tool_name or func.__name__}'")
+                raise PermissionError("Authorization header required")
+
+            auth_context = middleware.authenticate_request(auth_header)
+
+            if not auth_context:
+                logger.warning(f"Authentication failed for tool '{tool_name or func.__name__}'")
+                raise PermissionError("Invalid or expired token")
+
+            actual_tool_name = tool_name or func.__name__
+
+            authorized, reason = middleware.authorize_tool_call(
+                actual_tool_name, auth_context
+            )
+
+            if not authorized:
+                logger.warning(f"Authorization failed for tool '{actual_tool_name}': {reason}")
+                raise PermissionError(f"Access denied: {reason}")
+
+            # Add auth context to function call
+            return await func(auth_context, *args, **kwargs)
+
+        return wrapper
+
+    return decorator
+
+
+class FastMCPAuthWrapper:
+    """Wrapper for FastMCP servers to add authentication"""
+
+    def __init__(
+        self,
+        mcp_server: "FastMCP",
+        oauth_provider: OAuthProvider,
+        policy_engine: PolicyEngine,
+    ):
+        if not FASTMCP_AVAILABLE:
+            raise ImportError("FastMCP is required for FastMCPAuthWrapper")
+            
+        self.mcp_server = mcp_server
+        self.middleware = MCPAuthMiddleware(oauth_provider, policy_engine)
+        self.oauth_provider = oauth_provider
+        logger.info("Initializing FastMCP authentication wrapper")
+        self._wrap_tools()
+
+    def _wrap_tools(self):
+        """Wrap all existing tools with auth middleware"""
+
+        # Try different FastMCP tool storage locations
+        tool_registry = None
+        
+        if hasattr(self.mcp_server, '_tools'):
+            tool_registry = self.mcp_server._tools
+        elif hasattr(self.mcp_server, 'tools'):
+            tool_registry = self.mcp_server.tools
+        elif hasattr(self.mcp_server, '_tool_registry'):
+            tool_registry = self.mcp_server._tool_registry
+        elif hasattr(self.mcp_server, '_handlers') and hasattr(self.mcp_server._handlers, 'tools'):
+            tool_registry = self.mcp_server._handlers.tools
+        
+        if not tool_registry:
+            logger.warning("FastMCP server tool registry not found, tools will not be automatically wrapped")
+            logger.debug(f"Available server attributes: {dir(self.mcp_server)}")
+            return
+
+        logger.debug(f"Found tool registry with {len(tool_registry)} tools")
+        original_tools = dict(tool_registry)
+        wrapped_count = 0
+
+        for tool_name, tool_func in original_tools.items():
+            try:
+                wrapped_func = self._create_auth_wrapper(tool_name, tool_func)
+                tool_registry[tool_name] = wrapped_func
+                wrapped_count += 1
+                logger.debug(f"Wrapped tool: {tool_name}")
+            except Exception as e:
+                logger.error(f"Failed to wrap tool {tool_name}: {e}")
+
+        logger.info(f"Successfully wrapped {wrapped_count} tools with authentication")
+
+    def _create_auth_wrapper(self, tool_name: str, original_func: Callable) -> Callable:
+        """Create auth wrapper for a specific tool"""
+
+        @functools.wraps(original_func)
+        async def auth_wrapper(*args, **kwargs):
+            # Extract authorization from various sources
+            auth_header = None
+            
+            # Check kwargs first
+            auth_header = kwargs.pop("authorization", None)
+            
+            # Check if first argument is a Request object
+            if not auth_header and args:
+                first_arg = args[0]
+                if hasattr(first_arg, 'headers'):
+                    auth_header = first_arg.headers.get("Authorization")
+
+            if not auth_header:
+                logger.warning(f"No authorization header for tool '{tool_name}'")
+                raise PermissionError("Authorization required")
+
+            auth_context = self.middleware.authenticate_request(auth_header)
+
+            if not auth_context:
+                logger.warning(f"Authentication failed for tool '{tool_name}'")
+                raise PermissionError("Invalid token")
+
+            authorized, reason = self.middleware.authorize_tool_call(
+                tool_name, auth_context
+            )
+
+            if not authorized:
+                logger.warning(f"Authorization failed for tool '{tool_name}': {reason}")
+                raise PermissionError(f"Access denied: {reason}")
+
+            # Add auth context to kwargs
+            kwargs["auth_context"] = auth_context
+            logger.debug(f"Calling tool '{tool_name}' for user {auth_context.user_id}")
+            
+            return await original_func(*args, **kwargs)
+
+        return auth_wrapper
+
+    def add_oauth_endpoints(self):
+        """Add OAuth endpoints to the MCP server"""
+
+        @self.mcp_server.tool(
+            description="Initiate OAuth 2.1 authorization flow with PKCE",
+            annotations={"readOnlyHint": True, "idempotentHint": False}
+        )
+        async def oauth_authorize(redirect_uri: str, scopes: Optional[str] = None):
+            """OAuth authorization endpoint"""
+            scope_list = scopes.split(" ") if scopes else None
+            auth_url, pkce = self.oauth_provider.generate_authorization_url(
+                redirect_uri=redirect_uri, scopes=scope_list
+            )
+            logger.info(f"Generated authorization URL for redirect_uri: {redirect_uri}")
+            return {
+                "authorization_url": auth_url,
+                "code_verifier": pkce.verifier,  # For PKCE flow
+                "code_challenge": pkce.challenge,
+                "instructions": "Use the authorization_url to complete OAuth flow, then exchange the returned code using oauth_token tool"
+            }
+
+        @self.mcp_server.tool(
+            description="Exchange OAuth authorization code for access token",
+            annotations={"readOnlyHint": False, "idempotentHint": False}
+        )
+        async def oauth_token(
+            code: str,
+            state: str,
+            redirect_uri: str
+        ):
+            """OAuth token exchange endpoint"""
+            try:
+                result = await self.oauth_provider.exchange_code_for_token(
+                    code=code, state=state, redirect_uri=redirect_uri
+                )
+                logger.info("Successfully exchanged authorization code for token")
+                return result
+            except Exception as e:
+                logger.error(f"Token exchange failed: {e}")
+                raise
+
+        @self.mcp_server.tool(
+            description="Validate and introspect OAuth access token",
+            annotations={"readOnlyHint": True, "idempotentHint": True}
+        )
+        async def oauth_introspect(token: str):
+            """Token introspection endpoint"""
+            result = self.oauth_provider.introspect_token(token)
+            logger.debug(f"Token introspection: active={result.get('active', False)}")
+            return result
+
+        @self.mcp_server.tool(
+            description="Revoke OAuth access token",
+            annotations={"readOnlyHint": False, "idempotentHint": False}
+        )
+        async def oauth_revoke(token: str):
+            """Token revocation endpoint"""
+            success = self.oauth_provider.revoke_token(token)
+            logger.info(f"Token revocation: success={success}")
+            return {"revoked": success}
+
+        @self.mcp_server.tool(
+            description="Get list of tools available to authenticated user",
+            annotations={"readOnlyHint": True, "idempotentHint": True}
+        )
+        async def oauth_user_tools(authorization: str):
+            """Get user's allowed tools based on scopes"""
+            auth_context = self.middleware.authenticate_request(authorization)
+            if not auth_context:
+                raise PermissionError("Invalid token")
+            
+            allowed_patterns = self.middleware.policy_engine.get_allowed_tools(auth_context.scopes)
+            
+            return {
+                "user_id": auth_context.user_id,
+                "scopes": auth_context.scopes,
+                "allowed_tool_patterns": allowed_patterns,
+                "message": "Use these patterns to determine which tools you can access"
+            }
+
+        logger.info("Added OAuth endpoints: oauth_authorize, oauth_token, oauth_introspect, oauth_revoke, oauth_user_tools")

mcp_auth/oauth.py

@@ -0,0 +1,304 @@
+"""
+OAuth 2.1 + PKCE implementation for MCP servers with Clerk integration
+"""
+
+import base64
+import hashlib
+import secrets
+import time
+import logging
+from dataclasses import dataclass
+from datetime import datetime, timedelta
+from typing import Any, Optional
+from urllib.parse import urlencode
+
+import httpx
+import jwt
+from jwt.exceptions import PyJWTError, InvalidTokenError
+
+from .storage import PersistentStorage
+
+# Try to import Clerk SDK
+try:
+    from clerk_backend_api import Clerk
+    CLERK_AVAILABLE = True
+except ImportError:
+    CLERK_AVAILABLE = False
+    Clerk = None
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass
+class OAuthConfig:
+    """OAuth provider configuration for Clerk"""
+
+    client_id: str
+    client_secret: str
+    authorization_endpoint: str
+    token_endpoint: str
+    jwks_uri: str | None = None
+    issuer: str = "mcp-auth"
+    scopes: list[str] = None
+
+    def __post_init__(self):
+        if self.scopes is None:
+            self.scopes = ["mcp:tools:read", "mcp:tools:write"]
+
+
+class PKCEChallenge:
+    """PKCE challenge/verifier pair for OAuth 2.1"""
+
+    def __init__(self):
+        self.verifier = (
+            base64.urlsafe_b64encode(secrets.token_bytes(32))
+            .decode("utf-8")
+            .rstrip("=")
+        )
+
+        challenge_bytes = hashlib.sha256(self.verifier.encode("utf-8")).digest()
+        self.challenge = (
+            base64.urlsafe_b64encode(challenge_bytes).decode("utf-8").rstrip("=")
+        )
+
+
+class OAuthProvider:
+    """OAuth 2.1 provider with PKCE support and Clerk integration"""
+
+    def __init__(self, config: OAuthConfig, jwt_secret: str):
+        self.config = config
+        self.jwt_secret = jwt_secret
+        # Use persistent storage instead of memory
+        self.storage = PersistentStorage()
+        
+        # Initialize Clerk SDK if available
+        self.clerk = None
+        if CLERK_AVAILABLE and config.client_secret:
+            try:
+                self.clerk = Clerk(bearer_auth=config.client_secret)
+                logger.info("Clerk SDK initialized successfully")
+            except Exception as e:
+                logger.warning(f"Failed to initialize Clerk SDK: {e}")
+                
+        logger.info("OAuth provider initialized with persistent storage")
+
+    def generate_authorization_url(
+        self,
+        redirect_uri: str,
+        state: str | None = None,
+        scopes: list[str] | None = None,
+    ) -> tuple[str, PKCEChallenge]:
+        """Generate OAuth authorization URL with PKCE for Clerk"""
+
+        pkce = PKCEChallenge()
+        session_id = secrets.token_urlsafe(32)
+
+        if state is None:
+            state = secrets.token_urlsafe(16)
+
+        if scopes is None:
+            scopes = self.config.scopes
+
+        # Store session data with expiration
+        session_data = {
+            "pkce_verifier": pkce.verifier,
+            "state": state,
+            "redirect_uri": redirect_uri,
+            "scopes": scopes,
+            "created_at": time.time(),
+            "expires_at": (datetime.utcnow() + timedelta(minutes=10)).timestamp(),
+        }
+        self.storage.set_session(session_id, session_data)
+
+        # Build Clerk OAuth URL
+        # Check if this is a custom domain (sign-in endpoint)
+        if self.config.authorization_endpoint.endswith('/sign-in'):
+            # For custom domains, Clerk expects redirect_url parameter
+            params = {
+                "redirect_url": redirect_uri,
+                "state": f"{state}:{session_id}",
+            }
+            auth_url = f"{self.config.authorization_endpoint}?{urlencode(params)}"
+        else:
+            # Standard OAuth flow with PKCE
+            params = {
+                "response_type": "code",
+                "client_id": self.config.client_id,
+                "redirect_uri": redirect_uri,
+                "scope": " ".join(scopes),
+                "state": f"{state}:{session_id}",  # Combine state with session ID
+                "code_challenge": pkce.challenge,
+                "code_challenge_method": "S256",
+            }
+            auth_url = f"{self.config.authorization_endpoint}?{urlencode(params)}"
+        
+        logger.info(f"Generated OAuth URL with session {session_id[:8]}...")
+        logger.debug(f"Auth URL: {auth_url}")
+        return auth_url, pkce
+
+    async def exchange_code_for_token(
+        self, code: str, state: str, redirect_uri: str
+    ) -> dict[str, Any]:
+        """Exchange authorization code for access token with Clerk"""
+
+        try:
+            original_state, session_id = state.split(":", 1)
+        except ValueError as e:
+            logger.error(f"Invalid state format: {state}")
+            raise ValueError("Invalid state format") from e
+
+        session = self.storage.get_session(session_id)
+        if not session:
+            logger.error(f"Session {session_id} not found")
+            raise ValueError("Invalid session")
+        
+        # Check session expiration
+        if datetime.utcnow().timestamp() > session.get("expires_at", 0):
+            self.storage.delete_session(session_id)
+            logger.error(f"Session {session_id} expired")
+            raise ValueError("Session expired")
+
+        if session["state"] != original_state:
+            logger.error(f"State mismatch: expected {session['state']}, got {original_state}")
+            raise ValueError("State mismatch")
+
+        if session["redirect_uri"] != redirect_uri:
+            logger.error(f"Redirect URI mismatch: expected {session['redirect_uri']}, got {redirect_uri}")
+            raise ValueError("Redirect URI mismatch")
+
+        # Prepare token exchange request for Clerk
+        token_data = {
+            "grant_type": "authorization_code",
+            "client_id": self.config.client_id,
+            "client_secret": self.config.client_secret,
+            "code": code,
+            "redirect_uri": redirect_uri,
+            "code_verifier": session["pkce_verifier"],
+        }
+
+        logger.info(f"Exchanging code with Clerk for session {session_id[:8]}...")
+
+        async with httpx.AsyncClient() as client:
+            response = await client.post(
+                self.config.token_endpoint,
+                data=token_data,
+                headers={"Content-Type": "application/x-www-form-urlencoded"},
+                timeout=30.0,
+            )
+
+        if response.status_code != 200:
+            logger.error(f"Clerk token exchange failed: {response.status_code} - {response.text}")
+            raise ValueError(f"Token exchange failed: {response.text}")
+
+        token_response = response.json()
+        logger.info("Successfully exchanged code for Clerk token")
+
+        # Create MCP-scoped JWT token
+        access_token = self._create_mcp_token(
+            session["scopes"], token_response.get("access_token"), session_id
+        )
+
+        # Store token for introspection
+        token_id = secrets.token_urlsafe(16)
+        token_data = {
+            "access_token": access_token,
+            "scopes": session["scopes"],
+            "created_at": time.time(),
+            "expires_at": (datetime.utcnow() + timedelta(hours=1)).timestamp(),
+            "session_id": session_id,
+            "clerk_token": token_response.get("access_token"),
+        }
+        self.storage.set_token(token_id, token_data)
+
+        # Clean up session
+        self.storage.delete_session(session_id)
+
+        return {
+            "access_token": access_token,
+            "token_type": "bearer",
+            "expires_in": 3600,
+            "scope": " ".join(session["scopes"]),
+        }
+
+    def validate_pkce(self, code_verifier: str, code_challenge: str) -> bool:
+        """Validate PKCE code challenge (RFC 7636)"""
+        # S256 method
+        verifier_hash = hashlib.sha256(code_verifier.encode()).digest()
+        expected_challenge = base64.urlsafe_b64encode(verifier_hash).decode().rstrip('=')
+        return expected_challenge == code_challenge
+
+    def _create_mcp_token(
+        self, scopes: list[str], upstream_token: str, session_id: str
+    ) -> str:
+        """Create MCP-scoped JWT token with Clerk token embedded"""
+
+        now = int(time.time())
+        payload = {
+            "iss": self.config.issuer,
+            "sub": session_id,
+            "aud": "mcp-server",
+            "iat": now,
+            "exp": now + 3600,  # 1 hour expiration
+            "mcp_tool_scopes": scopes,
+            "upstream_token": upstream_token,
+            "clerk_integration": True,
+        }
+
+        return jwt.encode(payload, self.jwt_secret, algorithm="HS256")
+
+    def introspect_token(self, token: str) -> dict[str, Any]:
+        """Introspect and validate MCP token"""
+
+        try:
+            payload = jwt.decode(token, self.jwt_secret, algorithms=["HS256"])
+
+            # Check if token is expired
+            if payload.get("exp", 0) < time.time():
+                return {"active": False, "error": "token_expired"}
+
+            return {
+                "active": True,
+                "sub": payload.get("sub"),
+                "aud": payload.get("aud"),
+                "iss": payload.get("iss"),
+                "exp": payload.get("exp"),
+                "iat": payload.get("iat"),
+                "mcp_tool_scopes": payload.get("mcp_tool_scopes", []),
+                "upstream_token": payload.get("upstream_token"),
+                "clerk_integration": payload.get("clerk_integration", False),
+            }
+
+        except PyJWTError as e:
+            logger.warning(f"Token validation failed: {e}")
+            return {"active": False, "error": "invalid_token"}
+
+    def revoke_token(self, token: str) -> bool:
+        """Revoke a token"""
+
+        try:
+            payload = jwt.decode(token, self.jwt_secret, algorithms=["HS256"])
+            session_id = payload.get("sub")
+
+            # Remove all tokens associated with this session
+            all_tokens = self.storage.get_tokens()
+            tokens_to_remove = [
+                token_id
+                for token_id, token_data in all_tokens.items()
+                if token_data.get("session_id") == session_id
+            ]
+
+            for token_id in tokens_to_remove:
+                self.storage.delete_token(token_id)
+
+            logger.info(f"Revoked {len(tokens_to_remove)} tokens for session {session_id}")
+            return True
+
+        except InvalidTokenError as e:
+            logger.warning(f"Token revocation failed: {e}")
+            return False
+
+    def cleanup_expired_sessions(self):
+        """Clean up expired sessions and tokens"""
+        # This is now handled automatically by persistent storage
+        self.storage.cleanup_expired_sessions()
+        logger.debug("Cleanup completed via persistent storage")

mcp_auth/policy.py

@@ -0,0 +1,201 @@
+"""
+Authorization policy engine for MCP tools
+"""
+
+import re
+import logging
+from dataclasses import dataclass
+from enum import Enum
+from typing import Any
+
+logger = logging.getLogger(__name__)
+
+
+class PolicyAction(Enum):
+    ALLOW = "allow"
+    DENY = "deny"
+
+
+@dataclass
+class ToolPolicy:
+    """Policy rule for MCP tool access"""
+
+    tool_pattern: str  # regex pattern for tool names
+    required_scopes: list[str]
+    action: PolicyAction = PolicyAction.ALLOW
+    conditions: dict[str, Any] | None = None
+
+    def matches_tool(self, tool_name: str) -> bool:
+        """Check if the policy applies to given tool"""
+        return bool(re.match(self.tool_pattern, tool_name))
+
+    def evaluate_scopes(self, user_scopes: list[str]) -> bool:
+        """Check if user has required scopes"""
+        return all(scope in user_scopes for scope in self.required_scopes)
+
+
+class PolicyEngine:
+    """Authorization policy engine for Turkish legal database tools"""
+
+    def __init__(self):
+        self.policies: list[ToolPolicy] = []
+        self.default_action = PolicyAction.DENY
+
+    def add_policy(self, policy: ToolPolicy):
+        """Add a policy rule"""
+        self.policies.append(policy)
+        logger.debug(f"Added policy: {policy.tool_pattern} -> {policy.required_scopes}")
+
+    def add_tool_scope_policy(
+        self,
+        tool_pattern: str,
+        required_scopes: str | list[str],
+        action: PolicyAction = PolicyAction.ALLOW,
+    ):
+        """Convenience method to add tool-scope policy"""
+        if isinstance(required_scopes, str):
+            required_scopes = [required_scopes]
+
+        policy = ToolPolicy(
+            tool_pattern=tool_pattern, required_scopes=required_scopes, action=action
+        )
+        self.add_policy(policy)
+
+    def authorize_tool_call(
+        self,
+        tool_name: str,
+        user_scopes: list[str],
+        user_claims: dict[str, Any] | None = None,
+    ) -> tuple[bool, str | None]:
+        """
+        Authorize a tool call
+
+        Returns:
+            (authorized: bool, reason: Optional[str])
+        """
+
+        logger.debug(f"Authorizing tool '{tool_name}' for user with scopes: {user_scopes}")
+
+        matching_policies = [
+            policy for policy in self.policies if policy.matches_tool(tool_name)
+        ]
+
+        if not matching_policies:
+            if self.default_action == PolicyAction.ALLOW:
+                logger.debug(f"No policies found for '{tool_name}', allowing by default")
+                return True, None
+            else:
+                logger.warning(f"No policies found for '{tool_name}', denying by default")
+                return False, f"No policy found for tool '{tool_name}', default deny"
+
+        # Check for explicit deny policies first
+        for policy in matching_policies:
+            if policy.action == PolicyAction.DENY:
+                if policy.evaluate_scopes(user_scopes):
+                    logger.warning(f"Explicit deny policy matched for '{tool_name}'")
+                    return False, f"Explicit deny policy for tool '{tool_name}'"
+
+        # Check allow policies
+        allow_policies = [
+            p for p in matching_policies if p.action == PolicyAction.ALLOW
+        ]
+
+        if not allow_policies:
+            logger.warning(f"No allow policies found for '{tool_name}'")
+            return False, f"No allow policies found for tool '{tool_name}'"
+
+        for policy in allow_policies:
+            if policy.evaluate_scopes(user_scopes):
+                if self._evaluate_conditions(policy.conditions, user_claims):
+                    logger.debug(f"Authorization granted for '{tool_name}'")
+                    return True, None
+
+        logger.warning(f"Insufficient scopes for '{tool_name}'. Required: {[p.required_scopes for p in allow_policies]}, User has: {user_scopes}")
+        return False, f"Insufficient scopes for tool '{tool_name}'"
+
+    def _evaluate_conditions(
+        self,
+        conditions: dict[str, Any] | None,
+        user_claims: dict[str, Any] | None,
+    ) -> bool:
+        """Evaluate additional policy conditions"""
+
+        if not conditions:
+            return True
+
+        if not user_claims:
+            logger.debug("No user claims provided, conditions evaluation failed")
+            return False
+
+        for key, expected_value in conditions.items():
+            user_value = user_claims.get(key)
+
+            if isinstance(expected_value, list):
+                if user_value not in expected_value:
+                    logger.debug(f"Condition failed: {key} = {user_value} not in {expected_value}")
+                    return False
+            elif user_value != expected_value:
+                logger.debug(f"Condition failed: {key} = {user_value} != {expected_value}")
+                return False
+
+        return True
+
+    def get_allowed_tools(self, user_scopes: list[str]) -> list[str]:
+        """Get list of tool patterns user is allowed to call"""
+
+        allowed_tools = []
+
+        for policy in self.policies:
+            if policy.action == PolicyAction.ALLOW and policy.evaluate_scopes(
+                user_scopes
+            ):
+                allowed_tools.append(policy.tool_pattern)
+
+        return allowed_tools
+
+
+def create_turkish_legal_policies() -> PolicyEngine:
+    """Create policy set for Turkish legal database MCP server"""
+
+    engine = PolicyEngine()
+
+    # Administrative tools (full access)
+    engine.add_tool_scope_policy(".*", ["mcp:tools:admin"])
+
+    # Search tools - require read access
+    engine.add_tool_scope_policy("search.*", ["mcp:tools:read"])
+    
+    # Fetch/get document tools - require read access  
+    engine.add_tool_scope_policy("get_.*", ["mcp:tools:read"])
+    engine.add_tool_scope_policy("fetch.*", ["mcp:tools:read"])
+
+    # Specific Turkish legal database tools
+    engine.add_tool_scope_policy("search_yargitay.*", ["mcp:tools:read"])
+    engine.add_tool_scope_policy("search_danistay.*", ["mcp:tools:read"])
+    engine.add_tool_scope_policy("search_anayasa.*", ["mcp:tools:read"])
+    engine.add_tool_scope_policy("search_rekabet.*", ["mcp:tools:read"])
+    engine.add_tool_scope_policy("search_kik.*", ["mcp:tools:read"])
+    engine.add_tool_scope_policy("search_emsal.*", ["mcp:tools:read"])
+    engine.add_tool_scope_policy("search_uyusmazlik.*", ["mcp:tools:read"])
+    engine.add_tool_scope_policy("search_sayistay.*", ["mcp:tools:read"])
+    engine.add_tool_scope_policy("search_.*_bedesten", ["mcp:tools:read"])
+    engine.add_tool_scope_policy("search_yerel_hukuk.*", ["mcp:tools:read"])
+    engine.add_tool_scope_policy("search_istinaf_hukuk.*", ["mcp:tools:read"])
+    engine.add_tool_scope_policy("search_kyb.*", ["mcp:tools:read"])
+
+    # Document retrieval tools
+    engine.add_tool_scope_policy("get_.*_document.*", ["mcp:tools:read"])
+    engine.add_tool_scope_policy("get_.*_markdown", ["mcp:tools:read"])
+
+    # Write operations (if any future tools need them)
+    engine.add_tool_scope_policy("create_.*", ["mcp:tools:write"])
+    engine.add_tool_scope_policy("update_.*", ["mcp:tools:write"]) 
+    engine.add_tool_scope_policy("delete_.*", ["mcp:tools:write"])
+
+    logger.info("Created Turkish legal database policy engine")
+    return engine
+
+
+def create_default_policies() -> PolicyEngine:
+    """Create a default policy set for MCP servers (backwards compatibility)"""
+    return create_turkish_legal_policies()

mcp_auth/storage.py

@@ -0,0 +1,112 @@
+"""
+Persistent storage for OAuth sessions and tokens
+"""
+
+import json
+import os
+import tempfile
+import logging
+from datetime import datetime
+from typing import Dict, Any, Optional
+
+logger = logging.getLogger(__name__)
+
+
+class PersistentStorage:
+    """File-based persistent storage for OAuth data"""
+    
+    def __init__(self, storage_dir: str = None):
+        if storage_dir is None:
+            # Use system temp directory or environment variable
+            storage_dir = os.environ.get('TEMP', tempfile.gettempdir())
+        
+        self.storage_dir = os.path.join(storage_dir, 'mcp_oauth_storage')
+        os.makedirs(self.storage_dir, exist_ok=True)
+        
+        self.sessions_file = os.path.join(self.storage_dir, 'oauth_sessions.json')
+        self.tokens_file = os.path.join(self.storage_dir, 'oauth_tokens.json')
+        
+        logger.info(f"Persistent OAuth storage initialized at: {self.storage_dir}")
+    
+    def _load_json(self, filepath: str) -> Dict:
+        """Load JSON data from file"""
+        try:
+            if os.path.exists(filepath):
+                with open(filepath, 'r', encoding='utf-8') as f:
+                    return json.load(f)
+        except Exception as e:
+            logger.error(f"Error loading {filepath}: {e}")
+        return {}
+    
+    def _save_json(self, filepath: str, data: Dict):
+        """Save JSON data to file"""
+        try:
+            with open(filepath, 'w', encoding='utf-8') as f:
+                json.dump(data, f, indent=2, default=str)
+        except Exception as e:
+            logger.error(f"Error saving {filepath}: {e}")
+    
+    def get_sessions(self) -> Dict[str, Dict[str, Any]]:
+        """Get all OAuth sessions"""
+        data = self._load_json(self.sessions_file)
+        # Clean expired sessions
+        now = datetime.utcnow().timestamp()
+        valid_sessions = {k: v for k, v in data.items() 
+                         if v.get('expires_at', 0) > now}
+        if len(valid_sessions) != len(data):
+            self._save_json(self.sessions_file, valid_sessions)
+        return valid_sessions
+    
+    def set_session(self, session_id: str, data: Dict[str, Any]):
+        """Set OAuth session data"""
+        sessions = self.get_sessions()
+        sessions[session_id] = data
+        self._save_json(self.sessions_file, sessions)
+    
+    def get_session(self, session_id: str) -> Optional[Dict[str, Any]]:
+        """Get specific OAuth session data"""
+        sessions = self.get_sessions()
+        return sessions.get(session_id)
+    
+    def delete_session(self, session_id: str):
+        """Delete OAuth session"""
+        sessions = self.get_sessions()
+        if session_id in sessions:
+            del sessions[session_id]
+            self._save_json(self.sessions_file, sessions)
+    
+    def get_tokens(self) -> Dict[str, Dict[str, Any]]:
+        """Get all OAuth tokens"""
+        data = self._load_json(self.tokens_file)
+        # Clean expired tokens
+        now = datetime.utcnow().timestamp()
+        valid_tokens = {k: v for k, v in data.items() 
+                       if v.get('expires_at', 0) > now}
+        if len(valid_tokens) != len(data):
+            self._save_json(self.tokens_file, valid_tokens)
+        return valid_tokens
+    
+    def set_token(self, token_id: str, token_data: Dict[str, Any]):
+        """Set OAuth token data"""
+        tokens = self.get_tokens()
+        tokens[token_id] = token_data
+        self._save_json(self.tokens_file, tokens)
+    
+    def get_token(self, token_id: str) -> Optional[Dict[str, Any]]:
+        """Get specific OAuth token data"""
+        tokens = self.get_tokens()
+        return tokens.get(token_id)
+    
+    def delete_token(self, token_id: str):
+        """Delete OAuth token"""
+        tokens = self.get_tokens()
+        if token_id in tokens:
+            del tokens[token_id]
+            self._save_json(self.tokens_file, tokens)
+    
+    def cleanup_expired_sessions(self):
+        """Clean up expired sessions and tokens"""
+        # This is handled automatically in get_sessions() and get_tokens()
+        sessions = self.get_sessions()
+        tokens = self.get_tokens()
+        logger.debug(f"Cleanup: {len(sessions)} active sessions, {len(tokens)} active tokens")

mcp_auth_factory.py

@@ -0,0 +1,193 @@
+"""
+Factory for creating FastMCP app with MCP Auth Toolkit integration
+"""
+
+import logging
+import os
+from typing import Optional
+
+logger = logging.getLogger(__name__)
+
+try:
+    from fastmcp import FastMCP
+    FASTMCP_AVAILABLE = True
+except ImportError:
+    FASTMCP_AVAILABLE = False
+    FastMCP = None
+
+from mcp_auth import (
+    OAuthProvider, 
+    PolicyEngine, 
+    FastMCPAuthWrapper,
+    create_default_policies
+)
+from mcp_auth.clerk_config import create_mcp_server_config
+
+
+def create_auth_enabled_app(app_name: str = "Yargı MCP Server") -> FastMCP:
+    """Create FastMCP app with authentication enabled"""
+    
+    if not FASTMCP_AVAILABLE:
+        raise ImportError("FastMCP is required for authenticated MCP server")
+    
+    logger.info("Creating FastMCP app with MCP Auth Toolkit integration")
+    
+    # Create base FastMCP app
+    app = FastMCP(app_name)
+    
+    # Check if authentication is enabled
+    auth_enabled = os.getenv("ENABLE_AUTH", "true").lower() == "true"
+    
+    if not auth_enabled:
+        logger.info("Authentication disabled, returning basic FastMCP app")
+        return app
+    
+    try:
+        # Get configuration
+        logger.info("Getting MCP server configuration...")
+        config = create_mcp_server_config()
+        logger.info("Configuration loaded successfully")
+        
+        # Create OAuth provider with Clerk config
+        logger.info("Creating OAuth provider...")
+        oauth_provider = OAuthProvider(
+            config=config["oauth_config"],
+            jwt_secret=config["jwt_secret"]
+        )
+        logger.info("OAuth provider created successfully")
+        
+        # Create policy engine for Turkish legal database
+        policy_engine = create_default_policies()
+        
+        # Store auth components for later wrapping (after tools are defined)
+        app._oauth_provider = oauth_provider
+        app._policy_engine = policy_engine
+        app._auth_config = config
+        
+        # Add OAuth endpoints immediately
+        @app.tool(
+            description="Initiate OAuth 2.1 authorization flow with PKCE",
+            annotations={"readOnlyHint": True, "idempotentHint": False}
+        )
+        async def oauth_authorize(redirect_uri: str, scopes: str = None):
+            """OAuth authorization endpoint"""
+            scope_list = scopes.split(" ") if scopes else ["mcp:tools:read", "mcp:tools:write"]
+            auth_url, pkce = oauth_provider.generate_authorization_url(
+                redirect_uri=redirect_uri, scopes=scope_list
+            )
+            logger.info(f"Generated authorization URL for redirect_uri: {redirect_uri}")
+            return {
+                "authorization_url": auth_url,
+                "code_verifier": pkce.verifier,
+                "code_challenge": pkce.challenge,
+                "instructions": "Use the authorization_url to complete OAuth flow, then exchange the returned code using oauth_token tool"
+            }
+
+        @app.tool(
+            description="Exchange OAuth authorization code for access token",
+            annotations={"readOnlyHint": False, "idempotentHint": False}
+        )
+        async def oauth_token(code: str, state: str, redirect_uri: str):
+            """OAuth token exchange endpoint"""
+            try:
+                result = await oauth_provider.exchange_code_for_token(
+                    code=code, state=state, redirect_uri=redirect_uri
+                )
+                logger.info("Successfully exchanged authorization code for token")
+                return result
+            except Exception as e:
+                logger.error(f"Token exchange failed: {e}")
+                raise
+
+        @app.tool(
+            description="Validate and introspect OAuth access token",
+            annotations={"readOnlyHint": True, "idempotentHint": True}
+        )
+        async def oauth_introspect(token: str):
+            """Token introspection endpoint"""
+            result = oauth_provider.introspect_token(token)
+            logger.debug(f"Token introspection: active={result.get('active', False)}")
+            return result
+
+        @app.tool(
+            description="Revoke OAuth access token",
+            annotations={"readOnlyHint": False, "idempotentHint": False}
+        )
+        async def oauth_revoke(token: str):
+            """Token revocation endpoint"""
+            success = oauth_provider.revoke_token(token)
+            logger.info(f"Token revocation: success={success}")
+            return {"revoked": success}
+        
+        logger.info("Successfully created authenticated FastMCP app")
+        
+    except Exception as e:
+        logger.error(f"Failed to create authenticated app: {e}")
+        logger.info("Falling back to non-authenticated FastMCP app")
+        # Return basic app if auth setup fails
+        return app
+    
+    return app
+
+
+def create_app() -> FastMCP:
+    """Create FastMCP app (backwards compatible with mcp_factory.py)"""
+    return create_auth_enabled_app()
+
+
+def get_auth_wrapper(app: FastMCP) -> Optional[FastMCPAuthWrapper]:
+    """Get auth wrapper from app if available"""
+    return getattr(app, '_auth_wrapper', None)
+
+
+def get_oauth_provider(app: FastMCP) -> Optional[OAuthProvider]:
+    """Get OAuth provider from app if available"""
+    return getattr(app, '_oauth_provider', None)
+
+
+def get_policy_engine(app: FastMCP) -> Optional[PolicyEngine]:
+    """Get policy engine from app if available"""
+    return getattr(app, '_policy_engine', None)
+
+
+def is_auth_enabled(app: FastMCP) -> bool:
+    """Check if authentication is enabled for the app"""
+    return hasattr(app, '_oauth_provider') or hasattr(app, '_auth_wrapper')
+
+
+def enable_tool_authentication(app: FastMCP):
+    """Enable authentication on all existing tools (call after tools are defined)"""
+    if not is_auth_enabled(app):
+        logger.debug("Authentication not enabled, skipping tool authentication")
+        return
+    
+    oauth_provider = get_oauth_provider(app)
+    policy_engine = get_policy_engine(app)
+    
+    if not oauth_provider or not policy_engine:
+        logger.warning("OAuth provider or policy engine not available")
+        return
+    
+    try:
+        # Create auth wrapper and wrap tools
+        auth_wrapper = FastMCPAuthWrapper(
+            mcp_server=app,
+            oauth_provider=oauth_provider,
+            policy_engine=policy_engine
+        )
+        
+        # Store wrapper for reference
+        app._auth_wrapper = auth_wrapper
+        
+        logger.info("Tool authentication enabled successfully")
+        
+    except Exception as e:
+        logger.error(f"Failed to enable tool authentication: {e}")
+
+
+def cleanup_auth_sessions(app: FastMCP):
+    """Clean up expired auth sessions and tokens"""
+    oauth_provider = get_oauth_provider(app)
+    if oauth_provider:
+        oauth_provider.cleanup_expired_sessions()
+        logger.debug("Cleaned up expired OAuth sessions")

mcp_auth_http_adapter.py

@@ -0,0 +1,338 @@
+"""
+HTTP adapter for MCP Auth Toolkit OAuth endpoints
+Exposes MCP OAuth tools as HTTP endpoints for Claude.ai integration
+"""
+
+import os
+import logging
+import secrets
+import time
+from typing import Optional
+from urllib.parse import urlencode, quote
+from datetime import datetime, timedelta
+
+from fastapi import APIRouter, Request, Query, HTTPException
+from fastapi.responses import RedirectResponse, JSONResponse
+
+# Try to import Clerk SDK
+try:
+    from clerk_backend_api import Clerk
+    CLERK_AVAILABLE = True
+except ImportError as e:
+    CLERK_AVAILABLE = False
+    Clerk = None
+
+logger = logging.getLogger(__name__)
+
+router = APIRouter()
+
+# OAuth configuration
+BASE_URL = os.getenv("BASE_URL", "https://yargimcp.com")
+
+
+@router.get("/.well-known/oauth-authorization-server")
+async def get_oauth_metadata():
+    """OAuth 2.0 Authorization Server Metadata (RFC 8414)"""
+    return JSONResponse({
+        "issuer": BASE_URL,
+        "authorization_endpoint": f"{BASE_URL}/authorize",
+        "token_endpoint": f"{BASE_URL}/token",
+        "registration_endpoint": f"{BASE_URL}/register",
+        "response_types_supported": ["code"],
+        "grant_types_supported": ["authorization_code", "refresh_token"],
+        "code_challenge_methods_supported": ["S256"],
+        "token_endpoint_auth_methods_supported": ["none"],
+        "scopes_supported": ["mcp:tools:read", "mcp:tools:write", "openid", "profile", "email"],
+        "service_documentation": f"{BASE_URL}/mcp/"
+    })
+
+
+@router.get("/.well-known/oauth-protected-resource")
+async def get_protected_resource_metadata():
+    """OAuth Protected Resource Metadata (RFC 9728)"""
+    return JSONResponse({
+        "resource": BASE_URL,
+        "authorization_servers": [BASE_URL],
+        "bearer_methods_supported": ["header"],
+        "scopes_supported": ["mcp:tools:read", "mcp:tools:write"],
+        "resource_documentation": f"{BASE_URL}/docs"
+    })
+
+
+@router.get("/authorize")
+async def authorize_endpoint(
+    response_type: str = Query(...),
+    client_id: str = Query(...),
+    redirect_uri: str = Query(...),
+    code_challenge: str = Query(...),
+    code_challenge_method: str = Query("S256"),
+    state: Optional[str] = Query(None),
+    scope: Optional[str] = Query(None)
+):
+    """OAuth 2.1 Authorization Endpoint - Uses Clerk SDK for custom domains"""
+    
+    logger.info(f"OAuth authorize request - client_id: {client_id}, redirect_uri: {redirect_uri}")
+    
+    if not CLERK_AVAILABLE:
+        logger.error("Clerk SDK not available")
+        raise HTTPException(status_code=500, detail="Clerk SDK not available")
+    
+    # Store OAuth session for later validation
+    try:
+        from mcp_server_main import app as mcp_app
+        from mcp_auth_factory import get_oauth_provider
+        
+        oauth_provider = get_oauth_provider(mcp_app)
+        if not oauth_provider:
+            raise HTTPException(status_code=500, detail="OAuth provider not configured")
+        
+        # Generate session and store PKCE
+        session_id = secrets.token_urlsafe(32)
+        if state is None:
+            state = secrets.token_urlsafe(16)
+        
+        # Create PKCE challenge
+        from mcp_auth.oauth import PKCEChallenge
+        pkce = PKCEChallenge()
+        
+        # Store session data
+        session_data = {
+            "pkce_verifier": pkce.verifier,
+            "pkce_challenge": code_challenge,  # Store the client's challenge
+            "state": state,
+            "redirect_uri": redirect_uri,
+            "client_id": client_id,
+            "scopes": scope.split(" ") if scope else ["mcp:tools:read", "mcp:tools:write"],
+            "created_at": time.time(),
+            "expires_at": (datetime.utcnow() + timedelta(minutes=10)).timestamp(),
+        }
+        oauth_provider.storage.set_session(session_id, session_data)
+        
+        # For Clerk with custom domains, we need to use their hosted sign-in page
+        # We'll pass our callback URL and session info in the state
+        callback_url = f"{BASE_URL}/auth/callback"
+        
+        # Encode session info in state for retrieval after Clerk auth
+        combined_state = f"{state}:{session_id}"
+        
+        # Use Clerk's sign-in URL with proper parameters
+        clerk_domain = os.getenv("CLERK_DOMAIN", "accounts.yargimcp.com")
+        sign_in_params = {
+            "redirect_url": f"{callback_url}?state={quote(combined_state)}",
+        }
+        
+        sign_in_url = f"https://{clerk_domain}/sign-in?{urlencode(sign_in_params)}"
+        
+        logger.info(f"Redirecting to Clerk sign-in: {sign_in_url}")
+        
+        return RedirectResponse(url=sign_in_url)
+        
+    except Exception as e:
+        logger.exception(f"Authorization failed: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/auth/callback")
+async def oauth_callback(
+    request: Request,
+    state: Optional[str] = Query(None)
+):
+    """Handle OAuth callback from Clerk - simplified for custom domains"""
+    
+    logger.info(f"OAuth callback received - state: {state}")
+    logger.info(f"Query params: {dict(request.query_params)}")
+    logger.info(f"Cookies: {dict(request.cookies)}")
+    
+    # For Clerk custom domains, we'll assume authentication succeeded
+    # if Clerk redirected the user to our callback URL
+    
+    # For custom domains, we'll skip complex session verification
+    # and rely on the fact that Clerk only redirects here after successful auth
+    
+    try:
+        if not state:
+            logger.error("No state parameter provided")
+            return JSONResponse(
+                status_code=400,
+                content={"error": "invalid_request", "error_description": "Missing state parameter"}
+            )
+        
+        # Parse state to get original state and session ID
+        try:
+            if ":" in state:
+                original_state, session_id = state.rsplit(":", 1)
+            else:
+                original_state = state
+                session_id = state  # Fallback
+        except ValueError:
+            logger.error(f"Invalid state format: {state}")
+            return JSONResponse(
+                status_code=400,
+                content={"error": "invalid_request", "error_description": "Invalid state format"}
+            )
+        
+        # Get OAuth provider
+        from mcp_server_main import app as mcp_app
+        from mcp_auth_factory import get_oauth_provider
+        
+        oauth_provider = get_oauth_provider(mcp_app)
+        if not oauth_provider:
+            raise HTTPException(status_code=500, detail="OAuth provider not configured")
+        
+        # Get stored session
+        oauth_session = oauth_provider.storage.get_session(session_id)
+        
+        if not oauth_session:
+            logger.error(f"OAuth session not found for ID: {session_id}")
+            return JSONResponse(
+                status_code=400,
+                content={"error": "invalid_request", "error_description": "OAuth session expired or not found"}
+            )
+        
+        # Generate simple authorization code for custom domain flow
+        auth_code = f"clerk_custom_{session_id}_{int(time.time())}"
+        
+        # Store the code mapping for token exchange  
+        code_data = {
+            "session_id": session_id,
+            "clerk_authenticated": True,
+            "custom_domain_flow": True,
+            "created_at": time.time(),
+            "expires_at": (datetime.utcnow() + timedelta(minutes=5)).timestamp(),
+        }
+        oauth_provider.storage.set_session(f"code_{auth_code}", code_data)
+        
+        # Build redirect URL back to Claude
+        redirect_params = {
+            "code": auth_code,
+            "state": original_state
+        }
+        
+        redirect_url = f"{oauth_session['redirect_uri']}?{urlencode(redirect_params)}"
+        logger.info(f"Redirecting back to Claude: {redirect_url}")
+        
+        return RedirectResponse(url=redirect_url)
+        
+    except Exception as e:
+        logger.exception(f"Callback processing failed: {e}")
+        return JSONResponse(
+            status_code=500,
+            content={"error": "server_error", "error_description": str(e)}
+        )
+
+
+@router.post("/register")
+async def register_client(request: Request):
+    """Dynamic Client Registration (RFC 7591)"""
+    
+    data = await request.json()
+    logger.info(f"Client registration request: {data}")
+    
+    # Simple dynamic registration - accept any client
+    client_id = f"mcp-client-{os.urandom(8).hex()}"
+    
+    return JSONResponse({
+        "client_id": client_id,
+        "client_secret": None,  # Public client
+        "redirect_uris": data.get("redirect_uris", []),
+        "grant_types": ["authorization_code", "refresh_token"],
+        "response_types": ["code"],
+        "client_name": data.get("client_name", "MCP Client"),
+        "token_endpoint_auth_method": "none",
+        "client_id_issued_at": int(datetime.now().timestamp())
+    })
+
+
+@router.post("/token")
+async def token_endpoint(request: Request):
+    """OAuth 2.1 Token Endpoint"""
+    
+    # Parse form data
+    form_data = await request.form()
+    grant_type = form_data.get("grant_type")
+    code = form_data.get("code")
+    redirect_uri = form_data.get("redirect_uri")
+    client_id = form_data.get("client_id")
+    code_verifier = form_data.get("code_verifier")
+    
+    logger.info(f"Token exchange - grant_type: {grant_type}, code: {code[:20] if code else 'None'}...")
+    
+    if grant_type != "authorization_code":
+        return JSONResponse(
+            status_code=400,
+            content={"error": "unsupported_grant_type"}
+        )
+    
+    try:
+        # Import here to avoid circular imports
+        from mcp_server_main import app as mcp_app
+        from mcp_auth_factory import get_oauth_provider
+        
+        # Get OAuth provider
+        oauth_provider = get_oauth_provider(mcp_app)
+        if not oauth_provider:
+            raise HTTPException(status_code=500, detail="OAuth provider not configured")
+        
+        # Extract session info from code
+        code_session = None
+        if code.startswith("clerk_"):
+            # Get the code mapping
+            code_session = oauth_provider.storage.get_session(f"code_{code}")
+            if code_session:
+                session_id = code_session.get("session_id")
+            else:
+                logger.error(f"Code mapping not found for: {code}")
+                return JSONResponse(
+                    status_code=400,
+                    content={"error": "invalid_grant", "error_description": "Invalid authorization code"}
+                )
+        else:
+            session_id = code
+            
+        session = oauth_provider.storage.get_session(session_id)
+        
+        if not session:
+            logger.error(f"Session {session_id} not found for token exchange")
+            return JSONResponse(
+                status_code=400,
+                content={"error": "invalid_grant", "error_description": "Invalid authorization code"}
+            )
+        
+        # Validate PKCE if present
+        if "pkce_challenge" in session and code_verifier:
+            # Validate PKCE challenge
+            if not oauth_provider.validate_pkce(code_verifier, session["pkce_challenge"]):
+                logger.error("PKCE challenge validation failed")
+                return JSONResponse(
+                    status_code=400,
+                    content={"error": "invalid_grant", "error_description": "Invalid code verifier"}
+                )
+            logger.info("PKCE validation successful")
+        else:
+            logger.info("No PKCE validation required")
+        
+        # Create JWT token
+        access_token = oauth_provider._create_mcp_token(
+            session["scopes"], 
+            session.get("clerk_token", ""), 
+            session_id
+        )
+        
+        # Clean up sessions
+        oauth_provider.storage.delete_session(session_id)
+        if code_session:
+            oauth_provider.storage.delete_session(f"code_{code}")
+        
+        return JSONResponse({
+            "access_token": access_token,
+            "token_type": "Bearer",
+            "expires_in": 3600,
+            "scope": " ".join(session["scopes"])
+        })
+        
+    except Exception as e:
+        logger.exception(f"Token exchange failed: {e}")
+        return JSONResponse(
+            status_code=500,
+            content={"error": "server_error", "error_description": str(e)}
+        )

nginx.conf

@@ -0,0 +1,94 @@
+events {
+    worker_connections 1024;
+}
+
+http {
+    upstream yargi_mcp {
+        server yargi-mcp:8000;
+    }
+
+    # Rate limiting
+    limit_req_zone $binary_remote_addr zone=api_limit:10m rate=10r/s;
+    limit_req_zone $binary_remote_addr zone=mcp_limit:10m rate=100r/s;
+
+    server {
+        listen 80;
+        server_name localhost;
+
+        # Redirect HTTP to HTTPS in production
+        # return 301 https://$server_name$request_uri;
+
+        # Security headers
+        add_header X-Content-Type-Options nosniff;
+        add_header X-Frame-Options DENY;
+        add_header X-XSS-Protection "1; mode=block";
+        add_header Referrer-Policy "strict-origin-when-cross-origin";
+
+        # API endpoints
+        location /api/ {
+            limit_req zone=api_limit burst=20 nodelay;
+            
+            proxy_pass http://yargi_mcp;
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto $scheme;
+            
+            # Timeouts
+            proxy_connect_timeout 60s;
+            proxy_send_timeout 60s;
+            proxy_read_timeout 60s;
+        }
+
+        # MCP endpoint (higher rate limit)
+        location /mcp-server/mcp/ {
+            limit_req zone=mcp_limit burst=50 nodelay;
+            
+            proxy_pass http://yargi_mcp;
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto $scheme;
+            
+            # WebSocket support
+            proxy_http_version 1.1;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection "upgrade";
+            
+            # Longer timeouts for MCP operations
+            proxy_connect_timeout 300s;
+            proxy_send_timeout 300s;
+            proxy_read_timeout 300s;
+        }
+
+        # Health check (no rate limit)
+        location /health {
+            proxy_pass http://yargi_mcp;
+            proxy_set_header Host $host;
+        }
+
+        # Root and other paths
+        location / {
+            limit_req zone=api_limit burst=10 nodelay;
+            
+            proxy_pass http://yargi_mcp;
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto $scheme;
+        }
+    }
+
+    # SSL configuration (uncomment for production)
+    # server {
+    #     listen 443 ssl http2;
+    #     server_name your-domain.com;
+    #
+    #     ssl_certificate /etc/nginx/ssl/cert.pem;
+    #     ssl_certificate_key /etc/nginx/ssl/key.pem;
+    #     ssl_protocols TLSv1.2 TLSv1.3;
+    #     ssl_ciphers HIGH:!aNULL:!MD5;
+    #
+    #     # Include all location blocks from above
+    # }
+}

pyproject.toml

@@ -0,0 +1,64 @@
+[project]
+name = "yargi-mcp"
+version = "0.1.2"
+description = "MCP Server For Turkish Legal Databases"
+readme = "README.md"
+requires-python = ">=3.11"
+license = {text = "MIT"}
+authors = [{name = "Said Surucu", email = "saidsrc@gmail.com"}]
+keywords = ["mcp", "turkish-law", "legal", "yargitay", "danistay", "turkish", "law", "court", "decisions"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Legal Industry",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Text Processing :: Markup :: Markdown",
+    "Operating System :: OS Independent",
+]
+urls = {Homepage = "https://github.com/saidsurucu/yargi-mcp", Issues = "https://github.com/saidsurucu/yargi-mcp/issues"}
+dependencies = [
+    "beautifulsoup4>=4.13.4",
+    "httpx>=0.28.1",
+    "markitdown[pdf]>=0.1.1",
+    "pydantic>=2.11.4",
+    "aiohttp>=3.11.18",
+    "playwright>=1.52.0",
+    "fastmcp>=2.9.2",
+    "pypdf>=5.5.0",
+    "fastapi>=0.115.14",
+    "PyJWT>=2.8.0",
+]
+
+[project.optional-dependencies]
+asgi = [
+    "uvicorn[standard]>=0.30.0",
+    "starlette>=0.37.0",
+]
+api = [
+    "fastapi>=0.115.0",
+    "uvicorn[standard]>=0.30.0",
+]
+production = [
+    "gunicorn>=22.0.0",
+    "uvicorn[standard]>=0.30.0",
+]
+saas = [
+    "clerk-backend-api>=3.0.0",
+    "stripe>=9.1.0",
+]
+
+[project.scripts]
+yargi-mcp = "mcp_server_main:main"
+
+[tool.setuptools]
+py-modules = ["mcp_server_main", "mcp_auth_factory", "mcp_auth_http_adapter", "asgi_app", "fastapi_app", "starlette_app", "run_asgi", "stripe_webhook"]
+
+[tool.setuptools.packages.find]
+include = ["*_mcp_module", "mcp_auth"]
+
+[build-system]
+requires = ["setuptools>=65.0", "wheel"]
+build-backend = "setuptools.build_meta"

railway.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://railway.app/railway.schema.json",
+  "build": {
+    "builder": "NIXPACKS",
+    "buildCommand": "pip install -e .[asgi]"
+  },
+  "deploy": {
+    "startCommand": "uvicorn asgi_app:app --host 0.0.0.0 --port $PORT",
+    "healthcheckPath": "/health",
+    "healthcheckTimeout": 30,
+    "restartPolicyType": "ON_FAILURE",
+    "restartPolicyMaxRetries": 3
+  },
+  "variables": {
+    "ALLOWED_ORIGINS": "*",
+    "LOG_LEVEL": "info"
+  }
+}

rekabet_mcp_module/client.py

@@ -0,0 +1,407 @@
+# rekabet_mcp_module/client.py
+
+import httpx
+from bs4 import BeautifulSoup
+from typing import List, Optional, Tuple, Dict, Any
+import logging
+import html
+import re
+import io # For io.BytesIO
+from urllib.parse import urlencode, urljoin, quote, parse_qs, urlparse
+from markitdown import MarkItDown
+import math
+
+# pypdf for PDF processing (lighter alternative to PyMuPDF)
+from pypdf import PdfReader, PdfWriter # PyPDF2'nin devamı niteliğindeki pypdf
+
+from .models import (
+    RekabetKurumuSearchRequest,
+    RekabetDecisionSummary,
+    RekabetSearchResult,
+    RekabetDocument,
+    RekabetKararTuruGuidEnum
+)
+from pydantic import HttpUrl # Ensure HttpUrl is imported from pydantic
+
+logger = logging.getLogger(__name__)
+if not logger.hasHandlers(): # Pragma: no cover
+    logging.basicConfig(
+        level=logging.INFO,  # Varsayılan log seviyesi
+        format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+    )
+    # Debug betiğinde daha detaylı loglama için seviye ayrıca ayarlanabilir.
+
+class RekabetKurumuApiClient:
+    BASE_URL = "https://www.rekabet.gov.tr"
+    SEARCH_PATH = "/tr/Kararlar"
+    DECISION_LANDING_PATH_TEMPLATE = "/Karar"
+    # PDF sayfa bazlı Markdown döndürüldüğü için bu sabit artık doğrudan kullanılmıyor.
+    # DOCUMENT_MARKDOWN_CHUNK_SIZE = 5000 
+
+    def __init__(self, request_timeout: float = 60.0):
+        self.http_client = httpx.AsyncClient(
+            base_url=self.BASE_URL,
+            headers={
+                "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8",
+                "Accept-Language": "tr-TR,tr;q=0.9,en-US;q=0.8,en;q=0.7",
+                "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
+            },
+            timeout=request_timeout,
+            verify=True,
+            follow_redirects=True
+        )
+
+    def _build_search_query_params(self, params: RekabetKurumuSearchRequest) -> List[Tuple[str, str]]:
+        query_params: List[Tuple[str, str]] = []
+        query_params.append(("sayfaAdi", params.sayfaAdi if params.sayfaAdi is not None else ""))
+        query_params.append(("YayinlanmaTarihi", params.YayinlanmaTarihi if params.YayinlanmaTarihi is not None else ""))
+        query_params.append(("PdfText", params.PdfText if params.PdfText is not None else ""))
+        
+        karar_turu_id_value = ""
+        if params.KararTuruID is not None: 
+            karar_turu_id_value = params.KararTuruID.value if params.KararTuruID.value != "ALL" else "" 
+        query_params.append(("KararTuruID", karar_turu_id_value))
+            
+        query_params.append(("KararSayisi", params.KararSayisi if params.KararSayisi is not None else ""))
+        query_params.append(("KararTarihi", params.KararTarihi if params.KararTarihi is not None else ""))
+        
+        if params.page and params.page > 1:
+            query_params.append(("page", str(params.page)))
+            
+        return query_params
+
+    async def search_decisions(self, params: RekabetKurumuSearchRequest) -> RekabetSearchResult:
+        request_path = self.SEARCH_PATH
+        final_query_params = self._build_search_query_params(params)
+        logger.info(f"RekabetKurumuApiClient: Performing search. Path: {request_path}, Parameters: {final_query_params}")
+        
+        try:
+            response = await self.http_client.get(request_path, params=final_query_params)
+            response.raise_for_status()
+            html_content = response.text
+        except httpx.RequestError as e:
+            logger.error(f"RekabetKurumuApiClient: HTTP request error during search: {e}")
+            raise
+        
+        soup = BeautifulSoup(html_content, 'html.parser')
+        processed_decisions: List[RekabetDecisionSummary] = []
+        total_records: Optional[int] = None
+        total_pages: Optional[int] = None
+        
+        pagination_div = soup.find("div", class_="yazi01")
+        if pagination_div:
+            text_content = pagination_div.get_text(separator=" ", strip=True)
+            total_match = re.search(r"Toplam\s*:\s*(\d+)", text_content)
+            if total_match:
+                try:
+                    total_records = int(total_match.group(1))
+                    logger.debug(f"Total records found from pagination: {total_records}")
+                except ValueError:
+                    logger.warning(f"Could not convert 'Toplam' value to int: {total_match.group(1)}")
+            else:
+                logger.warning("'Toplam :' string not found in pagination section.")
+            
+            results_per_page_assumed = 10 
+            if total_records is not None:
+                calculated_total_pages = math.ceil(total_records / results_per_page_assumed)
+                total_pages = calculated_total_pages if calculated_total_pages > 0 else (1 if total_records > 0 else 0)
+                logger.debug(f"Calculated total pages: {total_pages}")
+            
+            if total_pages is None: # Fallback if total_records couldn't be parsed
+                last_page_link = pagination_div.select_one("li.PagedList-skipToLast a")
+                if last_page_link and last_page_link.has_attr('href'):
+                    qs = parse_qs(urlparse(last_page_link['href']).query)
+                    if 'page' in qs and qs['page']:
+                        try:
+                            total_pages = int(qs['page'][0])
+                            logger.debug(f"Total pages found from 'Last >>' link: {total_pages}")
+                        except ValueError:
+                            logger.warning(f"Could not convert page value from 'Last >>' link to int: {qs['page'][0]}")
+                elif total_records == 0 : total_pages = 0 # If no records, 0 pages
+                elif total_records is not None and total_records > 0 : total_pages = 1 # If records exist but no last page link (e.g. single page)
+                else: logger.warning("'Last >>' link not found in pagination section.")
+        
+        decision_tables_container = soup.find("div", id="kararList")
+        if not decision_tables_container:
+            logger.warning("`div#kararList` (decision list container) not found. HTML structure might have changed or no decisions on this page.")
+        else:
+            decision_tables = decision_tables_container.find_all("table", class_="equalDivide")
+            logger.info(f"Found {len(decision_tables)} 'table' elements with class='equalDivide' for parsing.")
+            
+            if not decision_tables and total_records is not None and total_records > 0 :
+                 logger.warning(f"Page indicates {total_records} records but no decision tables found with class='equalDivide'.")
+
+            for idx, table in enumerate(decision_tables):
+                logger.debug(f"Processing table {idx + 1}...")
+                try:
+                    rows = table.find_all("tr")
+                    if len(rows) != 3: 
+                        logger.warning(f"Table {idx + 1} has an unexpected number of rows ({len(rows)} instead of 3). Skipping. HTML snippet:\n{table.prettify()[:500]}")
+                        continue
+
+                    # Row 1: Publication Date, Decision Number, Related Cases Link
+                    td_elements_r1 = rows[0].find_all("td")
+                    pub_date = td_elements_r1[0].get_text(strip=True) if len(td_elements_r1) > 0 else None
+                    dec_num = td_elements_r1[1].get_text(strip=True) if len(td_elements_r1) > 1 else None
+                    
+                    related_cases_link_tag = td_elements_r1[2].find("a", href=True) if len(td_elements_r1) > 2 else None
+                    related_cases_url_str: Optional[str] = None
+                    karar_id_from_related: Optional[str] = None
+                    if related_cases_link_tag and related_cases_link_tag.has_attr('href'):
+                        related_cases_url_str = urljoin(self.BASE_URL, related_cases_link_tag['href'])
+                        qs_related = parse_qs(urlparse(related_cases_link_tag['href']).query)
+                        if 'kararId' in qs_related and qs_related['kararId']:
+                            karar_id_from_related = qs_related['kararId'][0]
+                    
+                    # Row 2: Decision Date, Decision Type
+                    td_elements_r2 = rows[1].find_all("td")
+                    dec_date = td_elements_r2[0].get_text(strip=True) if len(td_elements_r2) > 0 else None
+                    dec_type_text = td_elements_r2[1].get_text(strip=True) if len(td_elements_r2) > 1 else None
+
+                    # Row 3: Title and Main Decision Link
+                    title_cell = rows[2].find("td", colspan="5")
+                    decision_link_tag = title_cell.find("a", href=True) if title_cell else None
+                    
+                    title_text: Optional[str] = None
+                    decision_landing_url_str: Optional[str] = None 
+                    karar_id_from_main_link: Optional[str] = None
+
+                    if decision_link_tag and decision_link_tag.has_attr('href'):
+                        title_text = decision_link_tag.get_text(strip=True)
+                        href_val = decision_link_tag['href']
+                        if href_val.startswith(self.DECISION_LANDING_PATH_TEMPLATE + "?kararId="): # Ensure it's a decision link
+                            decision_landing_url_str = urljoin(self.BASE_URL, href_val)
+                            qs_main = parse_qs(urlparse(href_val).query)
+                            if 'kararId' in qs_main and qs_main['kararId']:
+                                karar_id_from_main_link = qs_main['kararId'][0]
+                        else:
+                            logger.warning(f"Table {idx+1} decision link has unexpected format: {href_val}")
+                    else:
+                        logger.warning(f"Table {idx+1} could not find title/decision link tag.")
+                    
+                    current_karar_id = karar_id_from_main_link or karar_id_from_related
+
+                    if not current_karar_id: 
+                        logger.warning(f"Table {idx+1} Karar ID not found. Skipping. Title (if any): {title_text}")
+                        continue
+                    
+                    # Convert string URLs to HttpUrl for the model
+                    final_decision_url = HttpUrl(decision_landing_url_str) if decision_landing_url_str else None
+                    final_related_cases_url = HttpUrl(related_cases_url_str) if related_cases_url_str else None
+
+                    processed_decisions.append(RekabetDecisionSummary(
+                        publication_date=pub_date, decision_number=dec_num, decision_date=dec_date,
+                        decision_type_text=dec_type_text, title=title_text, 
+                        decision_url=final_decision_url, 
+                        karar_id=current_karar_id, 
+                        related_cases_url=final_related_cases_url
+                    ))
+                    logger.debug(f"Table {idx+1} parsed successfully: Karar ID '{current_karar_id}', Title '{title_text[:50] if title_text else 'N/A'}...'")
+
+                except Exception as e:
+                    logger.warning(f"RekabetKurumuApiClient: Error parsing decision summary {idx+1}: {e}. Problematic Table HTML:\n{table.prettify()}", exc_info=True)
+                    continue
+        
+        return RekabetSearchResult(
+            decisions=processed_decisions, total_records_found=total_records, 
+            retrieved_page_number=params.page, total_pages=total_pages if total_pages is not None else 0
+        )
+
+    async def _extract_pdf_url_and_landing_page_metadata(self, karar_id: str, landing_page_html: str, landing_page_url: str) -> Dict[str, Any]:
+        soup = BeautifulSoup(landing_page_html, 'html.parser')
+        data: Dict[str, Any] = {
+            "pdf_url": None,
+            "title_on_landing_page": soup.title.string.strip() if soup.title and soup.title.string else f"Rekabet Kurumu Kararı {karar_id}",
+        }
+        # This part needs to be robust and specific to Rekabet Kurumu's landing page structure.
+        # Look for common patterns: direct links, download buttons, embedded viewers.
+        pdf_anchor = soup.find("a", href=re.compile(r"\.pdf(\?|$)", re.IGNORECASE)) # Basic PDF link
+        if not pdf_anchor: # Try other common patterns if the basic one fails
+            # Example: Look for links with specific text or class
+            pdf_anchor = soup.find("a", string=re.compile(r"karar metni|pdf indir", re.IGNORECASE))
+        
+        if pdf_anchor and pdf_anchor.has_attr('href'):
+            pdf_path = pdf_anchor['href']
+            data["pdf_url"] = urljoin(landing_page_url, pdf_path)
+            logger.info(f"PDF link found on landing page (<a>): {data['pdf_url']}")
+        else:
+            iframe_pdf = soup.find("iframe", src=re.compile(r"\.pdf(\?|$)", re.IGNORECASE))
+            if iframe_pdf and iframe_pdf.has_attr('src'):
+                pdf_path = iframe_pdf['src']
+                data["pdf_url"] = urljoin(landing_page_url, pdf_path)
+                logger.info(f"PDF link found on landing page (<iframe>): {data['pdf_url']}")
+            else:
+                embed_pdf = soup.find("embed", src=re.compile(r"\.pdf(\?|$)", re.IGNORECASE), type="application/pdf")
+                if embed_pdf and embed_pdf.has_attr('src'):
+                    pdf_path = embed_pdf['src']
+                    data["pdf_url"] = urljoin(landing_page_url, pdf_path)
+                    logger.info(f"PDF link found on landing page (<embed>): {data['pdf_url']}")
+                else:
+                    logger.warning(f"No PDF link found on landing page {landing_page_url} for kararId {karar_id} using common selectors.")
+        return data
+
+    async def _download_pdf_bytes(self, pdf_url: str) -> Optional[bytes]:
+        try:
+            url_to_fetch = pdf_url if pdf_url.startswith(('http://', 'https://')) else urljoin(self.BASE_URL, pdf_url)
+            logger.info(f"Downloading PDF from: {url_to_fetch}")
+            response = await self.http_client.get(url_to_fetch)
+            response.raise_for_status()
+            pdf_bytes = await response.aread()
+            logger.info(f"PDF content downloaded ({len(pdf_bytes)} bytes) from: {url_to_fetch}")
+            return pdf_bytes
+        except httpx.RequestError as e:
+            logger.error(f"HTTP error downloading PDF from {pdf_url}: {e}")
+        except Exception as e:
+            logger.error(f"General error downloading PDF from {pdf_url}: {e}")
+        return None
+
+    def _extract_single_pdf_page_as_pdf_bytes(self, original_pdf_bytes: bytes, page_number_to_extract: int) -> Tuple[Optional[bytes], int]:
+        total_pages_in_original_pdf = 0
+        single_page_pdf_bytes: Optional[bytes] = None
+        
+        if not original_pdf_bytes:
+            logger.warning("No original PDF bytes provided for page extraction.")
+            return None, 0
+
+        try:
+            pdf_stream = io.BytesIO(original_pdf_bytes)
+            reader = PdfReader(pdf_stream)
+            total_pages_in_original_pdf = len(reader.pages)
+            
+            if not (0 < page_number_to_extract <= total_pages_in_original_pdf):
+                logger.warning(f"Requested page number ({page_number_to_extract}) is out of PDF page range (1-{total_pages_in_original_pdf}).")
+                return None, total_pages_in_original_pdf
+
+            writer = PdfWriter()
+            writer.add_page(reader.pages[page_number_to_extract - 1]) # pypdf is 0-indexed
+            
+            output_pdf_stream = io.BytesIO()
+            writer.write(output_pdf_stream)
+            single_page_pdf_bytes = output_pdf_stream.getvalue()
+            
+            logger.debug(f"Page {page_number_to_extract} of original PDF (total {total_pages_in_original_pdf} pages) extracted as new PDF using pypdf.")
+            
+        except Exception as e:
+            logger.error(f"Error extracting PDF page using pypdf: {e}", exc_info=True)
+            return None, total_pages_in_original_pdf 
+        return single_page_pdf_bytes, total_pages_in_original_pdf
+
+    def _convert_pdf_bytes_to_markdown(self, pdf_bytes: bytes, source_url_for_logging: str) -> Optional[str]:
+        if not pdf_bytes:
+            logger.warning(f"No PDF bytes provided for Markdown conversion (source: {source_url_for_logging}).")
+            return None
+        
+        pdf_stream = io.BytesIO(pdf_bytes)
+        try:
+            md_converter = MarkItDown(enable_plugins=False) 
+            conversion_result = md_converter.convert(pdf_stream) 
+            markdown_text = conversion_result.text_content
+            
+            if not markdown_text:
+                 logger.warning(f"MarkItDown returned empty content from PDF byte stream (source: {source_url_for_logging}). PDF page might be image-based or MarkItDown could not process the PDF stream.")
+            return markdown_text
+        except Exception as e:
+            logger.error(f"MarkItDown conversion error for PDF byte stream (source: {source_url_for_logging}): {e}", exc_info=True)
+            return None
+
+    async def get_decision_document(self, karar_id: str, page_number: int = 1) -> RekabetDocument:
+        if not karar_id:
+             return RekabetDocument(
+                source_landing_page_url=HttpUrl(f"{self.BASE_URL}"), 
+                karar_id=karar_id or "UNKNOWN_KARAR_ID",
+                error_message="karar_id is required.",
+                current_page=1, total_pages=0, is_paginated=False )
+
+        decision_url_path = f"{self.DECISION_LANDING_PATH_TEMPLATE}?kararId={karar_id}"
+        full_landing_page_url = urljoin(self.BASE_URL, decision_url_path)
+        
+        logger.info(f"RekabetKurumuApiClient: Getting decision document: {full_landing_page_url}, Requested PDF Page: {page_number}")
+
+        pdf_url_to_report: Optional[HttpUrl] = None
+        title_to_report: Optional[str] = f"Rekabet Kurumu Kararı {karar_id}" # Default
+        error_message: Optional[str] = None
+        markdown_for_requested_page: Optional[str] = None
+        total_pdf_pages: int = 0
+        
+        try:
+            async with self.http_client.stream("GET", full_landing_page_url) as response:
+                response.raise_for_status()
+                content_type = response.headers.get("content-type", "").lower()
+                final_url_of_response = HttpUrl(str(response.url))
+                original_pdf_bytes: Optional[bytes] = None
+
+                if "application/pdf" in content_type:
+                    logger.info(f"URL {final_url_of_response} is a direct PDF. Processing content.")
+                    pdf_url_to_report = final_url_of_response
+                    original_pdf_bytes = await response.aread()
+                elif "text/html" in content_type:
+                    logger.info(f"URL {final_url_of_response} is an HTML landing page. Looking for PDF link.")
+                    landing_page_html_bytes = await response.aread()
+                    detected_charset = response.charset_encoding or 'utf-8'
+                    try: landing_page_html = landing_page_html_bytes.decode(detected_charset)
+                    except UnicodeDecodeError: landing_page_html = landing_page_html_bytes.decode('utf-8', errors='replace')
+
+                    if landing_page_html.strip():
+                        landing_page_data = self._extract_pdf_url_and_landing_page_metadata(karar_id, landing_page_html, str(final_url_of_response))
+                        pdf_url_str_from_html = landing_page_data.get("pdf_url")
+                        if landing_page_data.get("title_on_landing_page"): title_to_report = landing_page_data.get("title_on_landing_page")
+                        if pdf_url_str_from_html:
+                            pdf_url_to_report = HttpUrl(pdf_url_str_from_html)
+                            original_pdf_bytes = await self._download_pdf_bytes(str(pdf_url_to_report))
+                        else: error_message = (error_message or "") + " PDF URL not found on HTML landing page."
+                    else: error_message = "Decision landing page content is empty."
+                else: error_message = f"Unexpected content type ({content_type}) for URL: {final_url_of_response}"
+
+                if original_pdf_bytes:
+                    single_page_pdf_bytes, total_pdf_pages_from_extraction = self._extract_single_pdf_page_as_pdf_bytes(original_pdf_bytes, page_number)
+                    total_pdf_pages = total_pdf_pages_from_extraction 
+
+                    if single_page_pdf_bytes:
+                        markdown_for_requested_page = self._convert_pdf_bytes_to_markdown(single_page_pdf_bytes, str(pdf_url_to_report or full_landing_page_url))
+                        if not markdown_for_requested_page:
+                            error_message = (error_message or "") + f"; Could not convert page {page_number} of PDF to Markdown."
+                    elif total_pdf_pages > 0 : 
+                        error_message = (error_message or "") + f"; Could not extract page {page_number} from PDF (page may be out of range or extraction failed)."
+                    else: 
+                         error_message = (error_message or "") + "; PDF could not be processed or page count was zero (original PDF might be invalid)."
+                elif not error_message: 
+                    error_message = "PDF content could not be downloaded or identified."
+            
+            is_paginated = total_pdf_pages > 1
+            current_page_final = page_number
+            if total_pdf_pages > 0: 
+                current_page_final = max(1, min(page_number, total_pdf_pages))
+            elif markdown_for_requested_page is None: 
+                current_page_final = 1 
+            
+            # If markdown is None but there was no specific error for markdown conversion (e.g. PDF not found first)
+            # make sure error_message reflects that.
+            if markdown_for_requested_page is None and pdf_url_to_report and not error_message:
+                 error_message = (error_message or "") + "; Failed to produce Markdown from PDF page."
+
+
+            return RekabetDocument(
+                source_landing_page_url=full_landing_page_url, karar_id=karar_id,
+                title_on_landing_page=title_to_report, pdf_url=pdf_url_to_report,
+                markdown_chunk=markdown_for_requested_page, current_page=current_page_final,
+                total_pages=total_pdf_pages, is_paginated=is_paginated,
+                error_message=error_message.strip("; ") if error_message else None )
+
+        except httpx.HTTPStatusError as e: error_msg_detail = f"HTTP Status error {e.response.status_code} while processing decision page."
+        except httpx.RequestError as e: error_msg_detail = f"HTTP Request error while processing decision page: {str(e)}"
+        except Exception as e: error_msg_detail = f"General error while processing decision: {str(e)}"
+        
+        exc_info_flag = not isinstance(e, (httpx.HTTPStatusError, httpx.RequestError)) if 'e' in locals() else True
+        logger.error(f"RekabetKurumuApiClient: Error processing decision {karar_id} from {full_landing_page_url}: {error_msg_detail}", exc_info=exc_info_flag)
+        error_message = (error_message + "; " if error_message else "") + error_msg_detail
+        
+        return RekabetDocument(
+            source_landing_page_url=full_landing_page_url, karar_id=karar_id,
+            title_on_landing_page=title_to_report, pdf_url=pdf_url_to_report,
+            markdown_chunk=None, current_page=page_number, total_pages=0, is_paginated=False,
+            error_message=error_message.strip("; ") if error_message else "An unexpected error occurred." )
+
+    async def close_client_session(self): # Pragma: no cover
+        if hasattr(self, 'http_client') and self.http_client and not self.http_client.is_closed:
+            await self.http_client.aclose()
+            logger.info("RekabetKurumuApiClient: HTTP client session closed.")

rekabet_mcp_module/models.py

@@ -0,0 +1,76 @@
+# rekabet_mcp_module/models.py
+
+from pydantic import BaseModel, Field, HttpUrl
+from typing import List, Optional, Any
+from enum import Enum
+
+# Enum for decision type GUIDs (used by the client and expected by the website)
+class RekabetKararTuruGuidEnum(str, Enum):
+    TUMU = "ALL"  # Represents "All" or "Select Decision Type"
+    BIRLESME_DEVRALMA = "2fff0979-9f9d-42d7-8c2e-a30705889542"  # Merger and Acquisition
+    DIGER = "dda8feaf-c919-405c-9da1-823f22b45ad9"  # Other
+    MENFI_TESPIT_MUAFIYET = "95ccd210-5304-49c5-b9e0-8ee53c50d4e8"  # Negative Clearance and Exemption
+    OZELLESTIRME = "e1f14505-842b-4af5-95d1-312d6de1a541"  # Privatization
+    REKABET_IHLALI = "720614bf-efd1-4dca-9785-b98eb65f2677"  # Competition Infringement
+
+# Enum for user-friendly decision type names (for server tool parameters)
+# These correspond to the display names on the website's select dropdown.
+class RekabetKararTuruAdiEnum(str, Enum):
+    TUMU = "Tümü"  # Corresponds to the empty value "" for GUID, meaning "All"
+    BIRLESME_VE_DEVRALMA = "Birleşme ve Devralma"
+    DIGER = "Diğer"
+    MENFI_TESPIT_VE_MUAFIYET = "Menfi Tespit ve Muafiyet"
+    OZELLESTIRME = "Özelleştirme"
+    REKABET_IHLALI = "Rekabet İhlali"
+
+class RekabetKurumuSearchRequest(BaseModel):
+    """Model for Rekabet Kurumu (Turkish Competition Authority) search request."""
+    sayfaAdi: Optional[str] = Field(None, description="Search in decision title (Başlık).")
+    YayinlanmaTarihi: Optional[str] = Field(None, description="Publication date (Yayım Tarihi), e.g., DD.MM.YYYY.")
+    PdfText: Optional[str] = Field(
+        None,
+        description='Search in decision text (Metin). For an exact phrase match, enclose the phrase in double quotes (e.g., "\\"vertical agreement\\" competition). The website indicates that using "" provides more precise results for phrases.'
+    )
+    # This field uses the GUID enum as it's used by the client to make the actual web request.
+    KararTuruID: Optional[RekabetKararTuruGuidEnum] = Field(RekabetKararTuruGuidEnum.TUMU, description="Decision type (Karar Türü) GUID for internal client use, corresponding to the website's values.")
+    KararSayisi: Optional[str] = Field(None, description="Decision number (Karar Sayısı).")
+    KararTarihi: Optional[str] = Field(None, description="Decision date (Karar Tarihi), e.g., DD.MM.YYYY.")
+    page: int = Field(1, ge=1, description="Page number to fetch for results list.")
+
+class RekabetDecisionSummary(BaseModel):
+    """Model for a single Rekabet Kurumu decision summary from search results."""
+    publication_date: Optional[str] = Field(None, description="Publication Date (Yayımlanma Tarihi).")
+    decision_number: Optional[str] = Field(None, description="Decision Number (Karar Sayısı).")
+    decision_date: Optional[str] = Field(None, description="Decision Date (Karar Tarihi).")
+    decision_type_text: Optional[str] = Field(None, description="Decision Type as text (Karar Türü - metin olarak).")
+    title: Optional[str] = Field(None, description="Decision title or summary text.")
+    decision_url: Optional[HttpUrl] = Field(None, description="URL to the decision's landing page (e.g., /Karar?kararId=...).")
+    karar_id: Optional[str] = Field(None, description="GUID of the decision, extracted from its URL.")
+    related_cases_url: Optional[HttpUrl] = Field(None, description="URL to related court cases page, if available.")
+
+class RekabetSearchResult(BaseModel):
+    """Model for the overall search result for Rekabet Kurumu decisions."""
+    decisions: List[RekabetDecisionSummary]
+    total_records_found: Optional[int] = Field(None, description="Total number of records found matching the query.")
+    retrieved_page_number: int = Field(description="The page number of the results that were retrieved.")
+    total_pages: Optional[int] = Field(None, description="Total number of pages available for the query.")
+
+class RekabetDocument(BaseModel):
+    """
+    Model for a Rekabet Kurumu decision document.
+    Contains metadata from the landing page, a link to the PDF,
+    and the PDF's content converted to paginated Markdown.
+    """
+    source_landing_page_url: HttpUrl = Field(description="The URL of the decision's landing page from which the PDF was identified.")
+    karar_id: str = Field(description="GUID of the decision.")
+    
+    title_on_landing_page: Optional[str] = Field(None, description="Title as found on the landing page (e.g., from <title> tag or a main heading). Could be a generic title if direct PDF.")
+    pdf_url: Optional[HttpUrl] = Field(None, description="Direct URL to the decision PDF document, if successfully found and resolved.")
+    
+    # Fields for Markdown content derived from the PDF
+    markdown_chunk: Optional[str] = Field(None, description="A 5,000 character chunk of the Markdown content derived from the decision PDF.")
+    current_page: int = Field(1, description="The current page number of the PDF-derived markdown chunk (1-indexed).")
+    total_pages: int = Field(1, description="Total number of pages for the full PDF-derived markdown content. Will be 0 if content could not be processed.")
+    is_paginated: bool = Field(False, description="True if the full PDF-derived markdown content is split into multiple pages.")
+    
+    error_message: Optional[str] = Field(None, description="Contains an error message if the document retrieval or processing failed at any stage.")

requirements.txt

@@ -1,6 +1,11 @@
 fastmcp
 httpx
 beautifulsoup4
-markitdown
+markitdown[pdf]
 pydantic
-aiohttp 
+aiohttp
+playwright
+pypdf
+fastapi>=0.115.14
+uvicorn[standard]>=0.30.0
+starlette>=0.37.0

run_asgi.py

@@ -0,0 +1,119 @@
+#!/usr/bin/env python3
+"""
+Standalone ASGI server runner for Yargı MCP
+
+This script provides a simple way to run the Yargı MCP server
+as a web service using uvicorn.
+
+Usage:
+    python run_asgi.py
+    python run_asgi.py --host 0.0.0.0 --port 8080
+    python run_asgi.py --reload  # For development
+"""
+
+import os
+import sys
+import argparse
+import logging
+from pathlib import Path
+
+# Add project root to Python path
+sys.path.insert(0, str(Path(__file__).parent))
+
+try:
+    import uvicorn
+except ImportError:
+    print("Error: uvicorn is not installed.")
+    print("Please install it with: pip install uvicorn")
+    sys.exit(1)
+
+# Configure logging
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+)
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Run Yargı MCP server as an ASGI web service"
+    )
+    parser.add_argument(
+        "--host",
+        type=str,
+        default=os.getenv("HOST", "127.0.0.1"),
+        help="Host to bind to (default: 127.0.0.1)"
+    )
+    parser.add_argument(
+        "--port",
+        type=int,
+        default=int(os.getenv("PORT", "8000")),
+        help="Port to bind to (default: 8000)"
+    )
+    parser.add_argument(
+        "--reload",
+        action="store_true",
+        help="Enable auto-reload for development"
+    )
+    parser.add_argument(
+        "--transport",
+        choices=["http", "sse"],
+        default="http",
+        help="Transport type (default: http)"
+    )
+    parser.add_argument(
+        "--log-level",
+        choices=["debug", "info", "warning", "error"],
+        default=os.getenv("LOG_LEVEL", "info").lower(),
+        help="Log level (default: info)"
+    )
+    parser.add_argument(
+        "--workers",
+        type=int,
+        default=1,
+        help="Number of worker processes (default: 1)"
+    )
+    
+    args = parser.parse_args()
+    
+    # Select app based on transport
+    app_name = "asgi_app:app" if args.transport == "http" else "asgi_app:sse_app"
+    
+    # Configure uvicorn
+    config = {
+        "app": app_name,
+        "host": args.host,
+        "port": args.port,
+        "log_level": args.log_level,
+        "reload": args.reload,
+        "access_log": True,
+    }
+    
+    # Add workers only if not in reload mode
+    if not args.reload and args.workers > 1:
+        config["workers"] = args.workers
+    
+    # Print startup information
+    print(f"Starting Yargı MCP server...")
+    print(f"Host: {args.host}")
+    print(f"Port: {args.port}")
+    print(f"Transport: {args.transport}")
+    print(f"Log level: {args.log_level}")
+    if args.reload:
+        print("Auto-reload: enabled")
+    else:
+        print(f"Workers: {args.workers}")
+    print(f"\nServer will be available at: http://{args.host}:{args.port}")
+    print(f"MCP endpoint: http://{args.host}:{args.port}/mcp/")
+    print(f"Health check: http://{args.host}:{args.port}/health")
+    print(f"API status: http://{args.host}:{args.port}/status")
+    print("\nPress CTRL+C to stop the server\n")
+    
+    # Run uvicorn
+    try:
+        uvicorn.run(**config)
+    except KeyboardInterrupt:
+        print("\nShutting down server...")
+        sys.exit(0)
+
+if __name__ == "__main__":
+    main()

sayistay_mcp_module/__init__.py

@@ -0,0 +1,56 @@
+# sayistay_mcp_module/__init__.py
+
+"""
+Sayıştay (Turkish Court of Accounts) MCP Module
+
+This module provides access to three types of Sayıştay decisions:
+- Genel Kurul (General Assembly) decisions
+- Temyiz Kurulu (Appeals Board) decisions  
+- Daire (Chamber) decisions
+
+The module handles ASP.NET WebForms authentication with CSRF tokens
+and DataTables-based pagination for comprehensive decision search.
+"""
+
+from .client import SayistayApiClient
+from .models import (
+    # Genel Kurul models
+    GenelKurulSearchRequest,
+    GenelKurulSearchResponse,
+    GenelKurulDecision,
+    
+    # Temyiz Kurulu models
+    TemyizKuruluSearchRequest, 
+    TemyizKuruluSearchResponse,
+    TemyizKuruluDecision,
+    
+    # Daire models
+    DaireSearchRequest,
+    DaireSearchResponse,
+    DaireDecision,
+    
+    # Document models
+    SayistayDocumentMarkdown
+)
+from .enums import (
+    DaireEnum,
+    KamuIdaresiTuruEnum,
+    WebKararKonusuEnum
+)
+
+__all__ = [
+    "SayistayApiClient",
+    "GenelKurulSearchRequest",
+    "GenelKurulSearchResponse", 
+    "GenelKurulDecision",
+    "TemyizKuruluSearchRequest",
+    "TemyizKuruluSearchResponse",
+    "TemyizKuruluDecision",
+    "DaireSearchRequest",
+    "DaireSearchResponse",
+    "DaireDecision",
+    "SayistayDocumentMarkdown",
+    "DaireEnum",
+    "KamuIdaresiTuruEnum",
+    "WebKararKonusuEnum"
+]

sayistay_mcp_module/client.py

@@ -0,0 +1,691 @@
+# sayistay_mcp_module/client.py
+
+import httpx
+import re
+from bs4 import BeautifulSoup
+from typing import Dict, Any, List, Optional, Tuple
+import logging
+import html
+import tempfile
+import os
+from urllib.parse import urlencode, urljoin
+from markitdown import MarkItDown
+
+from .models import (
+    GenelKurulSearchRequest, GenelKurulSearchResponse, GenelKurulDecision,
+    TemyizKuruluSearchRequest, TemyizKuruluSearchResponse, TemyizKuruluDecision,
+    DaireSearchRequest, DaireSearchResponse, DaireDecision,
+    SayistayDocumentMarkdown
+)
+from .enums import DaireEnum, KamuIdaresiTuruEnum, WebKararKonusuEnum
+
+logger = logging.getLogger(__name__)
+if not logger.hasHandlers():
+    logging.basicConfig(
+        level=logging.INFO,
+        format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+    )
+
+class SayistayApiClient:
+    """
+    API Client for Sayıştay (Turkish Court of Accounts) decision search system.
+    
+    Handles three types of decisions:
+    - Genel Kurul (General Assembly): Precedent-setting interpretive decisions
+    - Temyiz Kurulu (Appeals Board): Appeals against chamber decisions  
+    - Daire (Chamber): First-instance audit findings and sanctions
+    
+    Features:
+    - ASP.NET WebForms session management with CSRF tokens
+    - DataTables-based pagination and filtering
+    - Automatic session refresh on expiration
+    - Document retrieval with Markdown conversion
+    """
+    
+    BASE_URL = "https://www.sayistay.gov.tr"
+    
+    # Search endpoints for each decision type
+    GENEL_KURUL_ENDPOINT = "/KararlarGenelKurul/DataTablesList"
+    TEMYIZ_KURULU_ENDPOINT = "/KararlarTemyiz/DataTablesList" 
+    DAIRE_ENDPOINT = "/KararlarDaire/DataTablesList"
+    
+    # Page endpoints for session initialization and document access
+    GENEL_KURUL_PAGE = "/KararlarGenelKurul"
+    TEMYIZ_KURULU_PAGE = "/KararlarTemyiz"
+    DAIRE_PAGE = "/KararlarDaire"
+    
+    def __init__(self, request_timeout: float = 60.0):
+        self.request_timeout = request_timeout
+        self.session_cookies: Dict[str, str] = {}
+        self.csrf_tokens: Dict[str, str] = {}  # Store tokens for each endpoint
+        
+        self.http_client = httpx.AsyncClient(
+            base_url=self.BASE_URL,
+            headers={
+                "Accept": "application/json, text/javascript, */*; q=0.01",
+                "Accept-Language": "tr-TR,tr;q=0.9,en-US;q=0.8,en;q=0.7",
+                "Content-Type": "application/x-www-form-urlencoded; charset=UTF-8",
+                "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36",
+                "X-Requested-With": "XMLHttpRequest",
+                "Sec-Fetch-Dest": "empty",
+                "Sec-Fetch-Mode": "cors", 
+                "Sec-Fetch-Site": "same-origin"
+            },
+            timeout=request_timeout,
+            follow_redirects=True
+        )
+
+    async def _initialize_session_for_endpoint(self, endpoint_type: str) -> bool:
+        """
+        Initialize session and obtain CSRF token for specific endpoint.
+        
+        Args:
+            endpoint_type: One of 'genel_kurul', 'temyiz_kurulu', 'daire'
+            
+        Returns:
+            True if session initialized successfully, False otherwise
+        """
+        page_mapping = {
+            'genel_kurul': self.GENEL_KURUL_PAGE,
+            'temyiz_kurulu': self.TEMYIZ_KURULU_PAGE,
+            'daire': self.DAIRE_PAGE
+        }
+        
+        if endpoint_type not in page_mapping:
+            logger.error(f"Invalid endpoint type: {endpoint_type}")
+            return False
+            
+        page_url = page_mapping[endpoint_type]
+        logger.info(f"Initializing session for {endpoint_type} endpoint: {page_url}")
+        
+        try:
+            response = await self.http_client.get(page_url)
+            response.raise_for_status()
+            
+            # Extract session cookies
+            for cookie_name, cookie_value in response.cookies.items():
+                self.session_cookies[cookie_name] = cookie_value
+                logger.debug(f"Stored session cookie: {cookie_name}")
+            
+            # Extract CSRF token from form
+            soup = BeautifulSoup(response.text, 'html.parser')
+            csrf_input = soup.find('input', {'name': '__RequestVerificationToken'})
+            
+            if csrf_input and csrf_input.get('value'):
+                self.csrf_tokens[endpoint_type] = csrf_input['value']
+                logger.info(f"Extracted CSRF token for {endpoint_type}")
+                return True
+            else:
+                logger.warning(f"CSRF token not found in {endpoint_type} page")
+                return False
+                
+        except httpx.RequestError as e:
+            logger.error(f"HTTP error during session initialization for {endpoint_type}: {e}")
+            return False
+        except Exception as e:
+            logger.error(f"Error initializing session for {endpoint_type}: {e}")
+            return False
+
+    def _enum_to_form_value(self, enum_value: str, enum_type: str) -> str:
+        """Convert enum values to form values expected by the API."""
+        if enum_value == "ALL":
+            if enum_type == "daire":
+                return "Tüm Daireler"
+            elif enum_type == "kamu_idaresi":
+                return "Tüm Kurumlar" 
+            elif enum_type == "web_karar_konusu":
+                return "Tüm Konular"
+        return enum_value
+
+    def _build_datatables_params(self, start: int, length: int, draw: int = 1) -> List[Tuple[str, str]]:
+        """Build standard DataTables parameters for all endpoints."""
+        params = [
+            ("draw", str(draw)),
+            ("start", str(start)),
+            ("length", str(length)),
+            ("search[value]", ""),
+            ("search[regex]", "false")
+        ]
+        return params
+
+    def _build_genel_kurul_form_data(self, params: GenelKurulSearchRequest, draw: int = 1) -> List[Tuple[str, str]]:
+        """Build form data for Genel Kurul search request."""
+        form_data = self._build_datatables_params(params.start, params.length, draw)
+        
+        # Add DataTables column definitions (from actual request)
+        column_defs = [
+            ("columns[0][data]", "KARARNO"),
+            ("columns[0][name]", ""),
+            ("columns[0][searchable]", "true"),
+            ("columns[0][orderable]", "false"),
+            ("columns[0][search][value]", ""),
+            ("columns[0][search][regex]", "false"),
+            
+            ("columns[1][data]", "KARARNO"),
+            ("columns[1][name]", ""),
+            ("columns[1][searchable]", "true"),
+            ("columns[1][orderable]", "true"),
+            ("columns[1][search][value]", ""),
+            ("columns[1][search][regex]", "false"),
+            
+            ("columns[2][data]", "KARARTARIH"),
+            ("columns[2][name]", ""),
+            ("columns[2][searchable]", "true"),
+            ("columns[2][orderable]", "true"),
+            ("columns[2][search][value]", ""),
+            ("columns[2][search][regex]", "false"),
+            
+            ("columns[3][data]", "KARAROZETI"),
+            ("columns[3][name]", ""),
+            ("columns[3][searchable]", "true"),
+            ("columns[3][orderable]", "false"),
+            ("columns[3][search][value]", ""),
+            ("columns[3][search][regex]", "false"),
+            
+            ("columns[4][data]", ""),
+            ("columns[4][name]", ""),
+            ("columns[4][searchable]", "true"),
+            ("columns[4][orderable]", "false"),
+            ("columns[4][search][value]", ""),
+            ("columns[4][search][regex]", "false"),
+            
+            ("order[0][column]", "2"),
+            ("order[0][dir]", "desc")
+        ]
+        form_data.extend(column_defs)
+        
+        # Add search parameters
+        form_data.extend([
+            ("KararlarGenelKurulAra.KARARNO", params.karar_no or ""),
+            ("__Invariant[]", "KararlarGenelKurulAra.KARARNO"),
+            ("__Invariant[]", "KararlarGenelKurulAra.KARAREK"),
+            ("KararlarGenelKurulAra.KARAREK", params.karar_ek or ""),
+            ("KararlarGenelKurulAra.KARARTARIHBaslangic", params.karar_tarih_baslangic or "Başlangıç Tarihi"),
+            ("KararlarGenelKurulAra.KARARTARIHBitis", params.karar_tarih_bitis or "Bitiş Tarihi"), 
+            ("KararlarGenelKurulAra.KARARTAMAMI", params.karar_tamami or ""),
+            ("__RequestVerificationToken", self.csrf_tokens.get('genel_kurul', ''))
+        ])
+        
+        return form_data
+
+    def _build_temyiz_kurulu_form_data(self, params: TemyizKuruluSearchRequest, draw: int = 1) -> List[Tuple[str, str]]:
+        """Build form data for Temyiz Kurulu search request."""
+        form_data = self._build_datatables_params(params.start, params.length, draw)
+        
+        # Add DataTables column definitions (from actual request)
+        column_defs = [
+            ("columns[0][data]", "TEMYIZTUTANAKTARIHI"),
+            ("columns[0][name]", ""),
+            ("columns[0][searchable]", "true"),
+            ("columns[0][orderable]", "false"),
+            ("columns[0][search][value]", ""),
+            ("columns[0][search][regex]", "false"),
+            
+            ("columns[1][data]", "TEMYIZTUTANAKTARIHI"),
+            ("columns[1][name]", ""),
+            ("columns[1][searchable]", "true"),
+            ("columns[1][orderable]", "true"),
+            ("columns[1][search][value]", ""),
+            ("columns[1][search][regex]", "false"),
+            
+            ("columns[2][data]", "ILAMDAIRESI"),
+            ("columns[2][name]", ""),
+            ("columns[2][searchable]", "true"),
+            ("columns[2][orderable]", "true"),
+            ("columns[2][search][value]", ""),
+            ("columns[2][search][regex]", "false"),
+            
+            ("columns[3][data]", "TEMYIZKARAR"),
+            ("columns[3][name]", ""),
+            ("columns[3][searchable]", "true"),
+            ("columns[3][orderable]", "false"),
+            ("columns[3][search][value]", ""),
+            ("columns[3][search][regex]", "false"),
+            
+            ("columns[4][data]", ""),
+            ("columns[4][name]", ""),
+            ("columns[4][searchable]", "true"),
+            ("columns[4][orderable]", "false"),
+            ("columns[4][search][value]", ""),
+            ("columns[4][search][regex]", "false"),
+            
+            ("order[0][column]", "1"),
+            ("order[0][dir]", "desc")
+        ]
+        form_data.extend(column_defs)
+        
+        # Add search parameters
+        daire_value = self._enum_to_form_value(params.ilam_dairesi, "daire")
+        kamu_idaresi_value = self._enum_to_form_value(params.kamu_idaresi_turu, "kamu_idaresi")
+        web_karar_konusu_value = self._enum_to_form_value(params.web_karar_konusu, "web_karar_konusu")
+        
+        form_data.extend([
+            ("KararlarTemyizAra.ILAMDAIRESI", daire_value),
+            ("KararlarTemyizAra.YILI", params.yili or ""),
+            ("KararlarTemyizAra.KARARTRHBaslangic", params.karar_tarih_baslangic or ""),
+            ("KararlarTemyizAra.KARARTRHBitis", params.karar_tarih_bitis or ""),
+            ("KararlarTemyizAra.KAMUIDARESITURU", kamu_idaresi_value if kamu_idaresi_value != "Tüm Kurumlar" else ""),
+            ("KararlarTemyizAra.ILAMNO", params.ilam_no or ""),
+            ("KararlarTemyizAra.DOSYANO", params.dosya_no or ""),
+            ("KararlarTemyizAra.TEMYIZTUTANAKNO", params.temyiz_tutanak_no or ""),
+            ("__Invariant", "KararlarTemyizAra.TEMYIZTUTANAKNO"),
+            ("KararlarTemyizAra.TEMYIZKARAR", params.temyiz_karar or ""),
+            ("KararlarTemyizAra.WEBKARARKONUSU", web_karar_konusu_value if web_karar_konusu_value != "Tüm Konular" else ""),
+            ("__RequestVerificationToken", self.csrf_tokens.get('temyiz_kurulu', ''))
+        ])
+        
+        return form_data
+
+    def _build_daire_form_data(self, params: DaireSearchRequest, draw: int = 1) -> List[Tuple[str, str]]:
+        """Build form data for Daire search request."""
+        form_data = self._build_datatables_params(params.start, params.length, draw)
+        
+        # Add DataTables column definitions (from actual request)
+        column_defs = [
+            ("columns[0][data]", "YARGILAMADAIRESI"),
+            ("columns[0][name]", ""),
+            ("columns[0][searchable]", "true"),
+            ("columns[0][orderable]", "false"),
+            ("columns[0][search][value]", ""),
+            ("columns[0][search][regex]", "false"),
+            
+            ("columns[1][data]", "KARARTRH"),
+            ("columns[1][name]", ""),
+            ("columns[1][searchable]", "true"),
+            ("columns[1][orderable]", "true"),
+            ("columns[1][search][value]", ""),
+            ("columns[1][search][regex]", "false"),
+            
+            ("columns[2][data]", "KARARNO"),
+            ("columns[2][name]", ""),
+            ("columns[2][searchable]", "true"),
+            ("columns[2][orderable]", "true"),
+            ("columns[2][search][value]", ""),
+            ("columns[2][search][regex]", "false"),
+            
+            ("columns[3][data]", "YARGILAMADAIRESI"),
+            ("columns[3][name]", ""),
+            ("columns[3][searchable]", "true"),
+            ("columns[3][orderable]", "true"),
+            ("columns[3][search][value]", ""),
+            ("columns[3][search][regex]", "false"),
+            
+            ("columns[4][data]", "WEBKARARMETNI"),
+            ("columns[4][name]", ""),
+            ("columns[4][searchable]", "true"),
+            ("columns[4][orderable]", "false"),
+            ("columns[4][search][value]", ""),
+            ("columns[4][search][regex]", "false"),
+            
+            ("columns[5][data]", ""),
+            ("columns[5][name]", ""),
+            ("columns[5][searchable]", "true"),
+            ("columns[5][orderable]", "false"),
+            ("columns[5][search][value]", ""),
+            ("columns[5][search][regex]", "false"),
+            
+            ("order[0][column]", "2"),
+            ("order[0][dir]", "desc")
+        ]
+        form_data.extend(column_defs)
+        
+        # Add search parameters
+        daire_value = self._enum_to_form_value(params.yargilama_dairesi, "daire")
+        kamu_idaresi_value = self._enum_to_form_value(params.kamu_idaresi_turu, "kamu_idaresi")
+        web_karar_konusu_value = self._enum_to_form_value(params.web_karar_konusu, "web_karar_konusu")
+        
+        form_data.extend([
+            ("KararlarDaireAra.YARGILAMADAIRESI", daire_value),
+            ("KararlarDaireAra.KARARTRHBaslangic", params.karar_tarih_baslangic or ""),
+            ("KararlarDaireAra.KARARTRHBitis", params.karar_tarih_bitis or ""),
+            ("KararlarDaireAra.ILAMNO", params.ilam_no or ""),
+            ("KararlarDaireAra.KAMUIDARESITURU", kamu_idaresi_value if kamu_idaresi_value != "Tüm Kurumlar" else ""),
+            ("KararlarDaireAra.HESAPYILI", params.hesap_yili or ""),
+            ("KararlarDaireAra.WEBKARARKONUSU", web_karar_konusu_value if web_karar_konusu_value != "Tüm Konular" else ""),
+            ("KararlarDaireAra.WEBKARARMETNI", params.web_karar_metni or ""),
+            ("__RequestVerificationToken", self.csrf_tokens.get('daire', ''))
+        ])
+        
+        return form_data
+
+    async def search_genel_kurul_decisions(self, params: GenelKurulSearchRequest) -> GenelKurulSearchResponse:
+        """
+        Search Sayıştay Genel Kurul (General Assembly) decisions.
+        
+        Args:
+            params: Search parameters for Genel Kurul decisions
+            
+        Returns:
+            GenelKurulSearchResponse with matching decisions
+        """
+        # Initialize session if needed
+        if 'genel_kurul' not in self.csrf_tokens:
+            if not await self._initialize_session_for_endpoint('genel_kurul'):
+                raise Exception("Failed to initialize session for Genel Kurul endpoint")
+        
+        form_data = self._build_genel_kurul_form_data(params)
+        encoded_data = urlencode(form_data, encoding='utf-8')
+        
+        logger.info(f"Searching Genel Kurul decisions with parameters: {params.model_dump(exclude_none=True)}")
+        
+        try:
+            # Update headers with cookies
+            headers = self.http_client.headers.copy()
+            if self.session_cookies:
+                cookie_header = "; ".join([f"{k}={v}" for k, v in self.session_cookies.items()])
+                headers["Cookie"] = cookie_header
+            
+            response = await self.http_client.post(
+                self.GENEL_KURUL_ENDPOINT,
+                data=encoded_data,
+                headers=headers
+            )
+            response.raise_for_status()
+            response_json = response.json()
+            
+            # Parse response
+            decisions = []
+            for item in response_json.get('data', []):
+                decisions.append(GenelKurulDecision(
+                    id=item['Id'],
+                    karar_no=item['KARARNO'],
+                    karar_tarih=item['KARARTARIH'],
+                    karar_ozeti=item['KARAROZETI']
+                ))
+            
+            return GenelKurulSearchResponse(
+                decisions=decisions,
+                total_records=response_json.get('recordsTotal', 0),
+                total_filtered=response_json.get('recordsFiltered', 0),
+                draw=response_json.get('draw', 1)
+            )
+            
+        except httpx.RequestError as e:
+            logger.error(f"HTTP error during Genel Kurul search: {e}")
+            raise
+        except Exception as e:
+            logger.error(f"Error processing Genel Kurul search: {e}")
+            raise
+
+    async def search_temyiz_kurulu_decisions(self, params: TemyizKuruluSearchRequest) -> TemyizKuruluSearchResponse:
+        """
+        Search Sayıştay Temyiz Kurulu (Appeals Board) decisions.
+        
+        Args:
+            params: Search parameters for Temyiz Kurulu decisions
+            
+        Returns:
+            TemyizKuruluSearchResponse with matching decisions
+        """
+        # Initialize session if needed
+        if 'temyiz_kurulu' not in self.csrf_tokens:
+            if not await self._initialize_session_for_endpoint('temyiz_kurulu'):
+                raise Exception("Failed to initialize session for Temyiz Kurulu endpoint")
+        
+        form_data = self._build_temyiz_kurulu_form_data(params)
+        encoded_data = urlencode(form_data, encoding='utf-8')
+        
+        logger.info(f"Searching Temyiz Kurulu decisions with parameters: {params.model_dump(exclude_none=True)}")
+        
+        try:
+            # Update headers with cookies
+            headers = self.http_client.headers.copy()
+            if self.session_cookies:
+                cookie_header = "; ".join([f"{k}={v}" for k, v in self.session_cookies.items()])
+                headers["Cookie"] = cookie_header
+            
+            response = await self.http_client.post(
+                self.TEMYIZ_KURULU_ENDPOINT,
+                data=encoded_data,
+                headers=headers
+            )
+            response.raise_for_status()
+            response_json = response.json()
+            
+            # Parse response
+            decisions = []
+            for item in response_json.get('data', []):
+                decisions.append(TemyizKuruluDecision(
+                    id=item['Id'],
+                    temyiz_tutanak_tarihi=item['TEMYIZTUTANAKTARIHI'],
+                    ilam_dairesi=item['ILAMDAIRESI'],
+                    temyiz_karar=item['TEMYIZKARAR']
+                ))
+            
+            return TemyizKuruluSearchResponse(
+                decisions=decisions,
+                total_records=response_json.get('recordsTotal', 0),
+                total_filtered=response_json.get('recordsFiltered', 0),
+                draw=response_json.get('draw', 1)
+            )
+            
+        except httpx.RequestError as e:
+            logger.error(f"HTTP error during Temyiz Kurulu search: {e}")
+            raise
+        except Exception as e:
+            logger.error(f"Error processing Temyiz Kurulu search: {e}")
+            raise
+
+    async def search_daire_decisions(self, params: DaireSearchRequest) -> DaireSearchResponse:
+        """
+        Search Sayıştay Daire (Chamber) decisions.
+        
+        Args:
+            params: Search parameters for Daire decisions
+            
+        Returns:
+            DaireSearchResponse with matching decisions
+        """
+        # Initialize session if needed
+        if 'daire' not in self.csrf_tokens:
+            if not await self._initialize_session_for_endpoint('daire'):
+                raise Exception("Failed to initialize session for Daire endpoint")
+        
+        form_data = self._build_daire_form_data(params)
+        encoded_data = urlencode(form_data, encoding='utf-8')
+        
+        logger.info(f"Searching Daire decisions with parameters: {params.model_dump(exclude_none=True)}")
+        
+        try:
+            # Update headers with cookies
+            headers = self.http_client.headers.copy()
+            if self.session_cookies:
+                cookie_header = "; ".join([f"{k}={v}" for k, v in self.session_cookies.items()])
+                headers["Cookie"] = cookie_header
+            
+            response = await self.http_client.post(
+                self.DAIRE_ENDPOINT,
+                data=encoded_data,
+                headers=headers
+            )
+            response.raise_for_status()
+            response_json = response.json()
+            
+            # Parse response
+            decisions = []
+            for item in response_json.get('data', []):
+                decisions.append(DaireDecision(
+                    id=item['Id'],
+                    yargilama_dairesi=item['YARGILAMADAIRESI'],
+                    karar_tarih=item['KARARTRH'],
+                    karar_no=item['KARARNO'],
+                    ilam_no=item.get('ILAMNO'),  # Use get() to handle None values
+                    madde_no=item['MADDENO'],
+                    kamu_idaresi_turu=item['KAMUIDARESITURU'],
+                    hesap_yili=item['HESAPYILI'],
+                    web_karar_konusu=item['WEBKARARKONUSU'],
+                    web_karar_metni=item['WEBKARARMETNI']
+                ))
+            
+            return DaireSearchResponse(
+                decisions=decisions,
+                total_records=response_json.get('recordsTotal', 0),
+                total_filtered=response_json.get('recordsFiltered', 0),
+                draw=response_json.get('draw', 1)
+            )
+            
+        except httpx.RequestError as e:
+            logger.error(f"HTTP error during Daire search: {e}")
+            raise
+        except Exception as e:
+            logger.error(f"Error processing Daire search: {e}")
+            raise
+
+    def _convert_html_to_markdown(self, html_content: str) -> Optional[str]:
+        """Convert HTML content to Markdown using MarkItDown."""
+        if not html_content:
+            return None
+            
+        temp_file_path = None
+        try:
+            md_converter = MarkItDown()
+            
+            # Write HTML to temp file
+            with tempfile.NamedTemporaryFile(mode="w", delete=False, suffix=".html", encoding="utf-8") as tmp:
+                tmp.write(html_content)
+                temp_file_path = tmp.name
+            
+            # Convert
+            result = md_converter.convert(temp_file_path)
+            markdown_content = result.text_content
+            
+            logger.info("Successfully converted HTML to Markdown")
+            return markdown_content
+            
+        except Exception as e:
+            logger.error(f"Error converting HTML to Markdown: {e}")
+            return f"Error converting HTML content: {str(e)}"
+        finally:
+            if temp_file_path and os.path.exists(temp_file_path):
+                os.remove(temp_file_path)
+
+    async def get_document_as_markdown(self, decision_id: str, decision_type: str) -> SayistayDocumentMarkdown:
+        """
+        Retrieve full text of a Sayıştay decision and convert to Markdown.
+        
+        Args:
+            decision_id: Unique decision identifier
+            decision_type: Type of decision ('genel_kurul', 'temyiz_kurulu', 'daire')
+            
+        Returns:
+            SayistayDocumentMarkdown with converted content
+        """
+        logger.info(f"Retrieving document for {decision_type} decision ID: {decision_id}")
+        
+        # Validate decision_id
+        if not decision_id or not decision_id.strip():
+            return SayistayDocumentMarkdown(
+                decision_id=decision_id,
+                decision_type=decision_type,
+                source_url="",
+                markdown_content=None,
+                error_message="Decision ID cannot be empty"
+            )
+        
+        # Map decision type to URL path
+        url_path_mapping = {
+            'genel_kurul': 'KararlarGenelKurul',
+            'temyiz_kurulu': 'KararlarTemyiz',
+            'daire': 'KararlarDaire'
+        }
+        
+        if decision_type not in url_path_mapping:
+            return SayistayDocumentMarkdown(
+                decision_id=decision_id,
+                decision_type=decision_type,
+                source_url="",
+                markdown_content=None,
+                error_message=f"Invalid decision type: {decision_type}. Must be one of: {list(url_path_mapping.keys())}"
+            )
+        
+        # Build document URL
+        url_path = url_path_mapping[decision_type]
+        document_url = f"{self.BASE_URL}/{url_path}/Detay/{decision_id}/"
+        
+        try:
+            # Make HTTP GET request to document URL
+            headers = {
+                "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+                "Accept-Language": "tr-TR,tr;q=0.9,en-US;q=0.8,en;q=0.7",
+                "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36",
+                "Sec-Fetch-Dest": "document",
+                "Sec-Fetch-Mode": "navigate",
+                "Sec-Fetch-Site": "same-origin"
+            }
+            
+            # Include session cookies if available
+            if self.session_cookies:
+                cookie_header = "; ".join([f"{k}={v}" for k, v in self.session_cookies.items()])
+                headers["Cookie"] = cookie_header
+            
+            response = await self.http_client.get(document_url, headers=headers)
+            response.raise_for_status()
+            html_content = response.text
+            
+            if not html_content or not html_content.strip():
+                logger.warning(f"Received empty HTML content from {document_url}")
+                return SayistayDocumentMarkdown(
+                    decision_id=decision_id,
+                    decision_type=decision_type,
+                    source_url=document_url,
+                    markdown_content=None,
+                    error_message="Document content is empty"
+                )
+            
+            # Convert HTML to Markdown using existing method
+            markdown_content = self._convert_html_to_markdown(html_content)
+            
+            if markdown_content and "Error converting HTML content" not in markdown_content:
+                logger.info(f"Successfully retrieved and converted document {decision_id} to Markdown")
+                return SayistayDocumentMarkdown(
+                    decision_id=decision_id,
+                    decision_type=decision_type,
+                    source_url=document_url,
+                    markdown_content=markdown_content,
+                    retrieval_date=None  # Could add datetime.now().isoformat() if needed
+                )
+            else:
+                return SayistayDocumentMarkdown(
+                    decision_id=decision_id,
+                    decision_type=decision_type,
+                    source_url=document_url,
+                    markdown_content=None,
+                    error_message=f"Failed to convert HTML to Markdown: {markdown_content}"
+                )
+                
+        except httpx.HTTPStatusError as e:
+            error_msg = f"HTTP error {e.response.status_code} when fetching document: {e}"
+            logger.error(f"HTTP error fetching document {decision_id}: {error_msg}")
+            return SayistayDocumentMarkdown(
+                decision_id=decision_id,
+                decision_type=decision_type,
+                source_url=document_url,
+                markdown_content=None,
+                error_message=error_msg
+            )
+        except httpx.RequestError as e:
+            error_msg = f"Network error when fetching document: {e}"
+            logger.error(f"Network error fetching document {decision_id}: {error_msg}")
+            return SayistayDocumentMarkdown(
+                decision_id=decision_id,
+                decision_type=decision_type,
+                source_url=document_url,
+                markdown_content=None,
+                error_message=error_msg
+            )
+        except Exception as e:
+            error_msg = f"Unexpected error when fetching document: {e}"
+            logger.error(f"Unexpected error fetching document {decision_id}: {error_msg}")
+            return SayistayDocumentMarkdown(
+                decision_id=decision_id,
+                decision_type=decision_type,
+                source_url=document_url,
+                markdown_content=None,
+                error_message=error_msg
+            )
+
+    async def close_client_session(self):
+        """Close HTTP client session."""
+        if hasattr(self, 'http_client') and self.http_client and not self.http_client.is_closed:
+            await self.http_client.aclose()
+            logger.info("SayistayApiClient: HTTP client session closed.")

sayistay_mcp_module/enums.py

@@ -0,0 +1,49 @@
+# sayistay_mcp_module/enums.py
+
+from typing import Literal
+
+# Chamber/Daire options for Temyiz Kurulu and Daire endpoints (1-8 + All)
+DaireEnum = Literal[
+    "ALL",           # All chambers/departments
+    "1",             # 1. Daire
+    "2",             # 2. Daire  
+    "3",             # 3. Daire
+    "4",             # 4. Daire
+    "5",             # 5. Daire
+    "6",             # 6. Daire
+    "7",             # 7. Daire
+    "8"              # 8. Daire
+]
+
+# Public Administration Types (Kamu İdaresi Türü)
+KamuIdaresiTuruEnum = Literal[
+    "ALL",                                      # All institutions
+    "Genel Bütçe Kapsamındaki İdareler",       # General Budget Administrations
+    "Yüksek Öğretim Kurumları",                # Higher Education Institutions
+    "Diğer Özel Bütçeli İdareler",             # Other Special Budget Administrations
+    "Düzenleyici ve Denetleyici Kurumlar",     # Regulatory and Supervisory Institutions
+    "Sosyal Güvenlik Kurumları",               # Social Security Institutions
+    "Özel İdareler",                           # Special Administrations
+    "Belediyeler ve Bağlı İdareler",           # Municipalities and Affiliated Administrations
+    "Diğer"                                    # Other
+]
+
+# Decision Subject Categories (Web Karar Konusu)
+WebKararKonusuEnum = Literal[
+    "ALL",                                                          # All subjects
+    "Harcırah Mevzuatı ile İlgili Kararlar",                      # Travel Allowance Legislation Related Decisions
+    "İhale Mevzuatı ile İlgili Kararlar",                         # Procurement Legislation Related Decisions
+    "İş Mevzuatı ile İlgili Kararlar",                            # Labor Legislation Related Decisions
+    "Personel Mevzuatı ile İlgili Kararlar",                      # Personnel Legislation Related Decisions
+    "Sorumluluk ve Yargılama Usulleri ile İlgili Kararlar",       # Liability and Trial Procedures Related Decisions
+    "Vergi Resmi Harç ve Diğer Gelirlerle İlgili Kararlar",       # Tax, Official Fee and Other Revenue Related Decisions
+    "Çeşitli Konuları İlgilendiren Kararlar"                      # Decisions Concerning Various Topics
+]
+
+# Year ranges for different endpoints
+GENEL_KURUL_YEARS = [str(year) for year in range(2006, 2025)]  # 2006-2024
+TEMYIZ_KURULU_YEARS = [str(year) for year in range(1993, 2023)]  # 1993-2022
+DAIRE_YEARS = [str(year) for year in range(2012, 2026)]  # 2012-2025
+
+# Account years for Temyiz Kurulu and Daire endpoints
+HESAP_YILLARI = [str(year) for year in range(1993, 2024)]  # 1993-2023

sayistay_mcp_module/models.py

@@ -0,0 +1,242 @@
+# sayistay_mcp_module/models.py
+
+from pydantic import BaseModel, Field
+from typing import Optional, List, Union
+from .enums import DaireEnum, KamuIdaresiTuruEnum, WebKararKonusuEnum
+
+# ============================================================================
+# Genel Kurul (General Assembly) Models
+# ============================================================================
+
+class GenelKurulSearchRequest(BaseModel):
+    """
+    Search request for Sayıştay Genel Kurul (General Assembly) decisions.
+    
+    Genel Kurul decisions are precedent-setting rulings made by the full assembly
+    of the Turkish Court of Accounts, typically addressing interpretation of
+    audit and accountability regulations.
+    """
+    karar_no: Optional[str] = Field(None, description="Decision number (e.g., '5415')")
+    karar_ek: Optional[str] = Field(None, description="Decision appendix number (max 99)")
+    
+    karar_tarih_baslangic: Optional[str] = Field(None, description="""
+        Decision start year for date range filtering.
+        Available years: 2006-2024. Format: 'YYYY' (e.g., '2020')
+        Use with karar_tarih_bitis for date range filtering.
+    """)
+    
+    karar_tarih_bitis: Optional[str] = Field(None, description="""
+        Decision end year for date range filtering.
+        Available years: 2006-2024. Format: 'YYYY' (e.g., '2024')
+        Use with karar_tarih_baslangic for date range filtering.
+    """)
+    
+    karar_tamami: Optional[str] = Field(None, description="""
+        Content/text search within decision summaries (max 400 characters).
+        Searches in decision abstracts and main content.
+        Example: 'belediye taşınmaz tahsis'
+    """)
+    
+    # DataTables pagination
+    start: int = Field(0, description="Starting record for pagination (0-based)")
+    length: int = Field(10, description="Number of records per page (1-100)")
+
+class GenelKurulDecision(BaseModel):
+    """Single Genel Kurul decision entry from search results."""
+    id: int = Field(..., description="Unique decision ID")
+    karar_no: str = Field(..., description="Decision number (e.g., '5415/1')")
+    karar_tarih: str = Field(..., description="Decision date in DD.MM.YYYY format")
+    karar_ozeti: str = Field(..., description="Decision summary/abstract")
+
+class GenelKurulSearchResponse(BaseModel):
+    """Response from Genel Kurul search endpoint."""
+    decisions: List[GenelKurulDecision] = Field(default_factory=list, description="List of matching decisions")
+    total_records: int = Field(0, description="Total number of matching records")
+    total_filtered: int = Field(0, description="Number of records after filtering")
+    draw: int = Field(1, description="DataTables draw counter")
+
+# ============================================================================
+# Temyiz Kurulu (Appeals Board) Models
+# ============================================================================
+
+class TemyizKuruluSearchRequest(BaseModel):
+    """
+    Search request for Sayıştay Temyiz Kurulu (Appeals Board) decisions.
+    
+    Temyiz Kurulu reviews appeals against audit chamber decisions,
+    providing higher-level review of audit findings and sanctions.
+    """
+    ilam_dairesi: DaireEnum = Field("ALL", description="""
+        Chamber/Department filter for appeals board decisions.
+        • ALL: All chambers (default)
+        • 1-8: Specific chamber number (1. Daire through 8. Daire)
+        Each chamber specializes in different types of public institutions.
+    """)
+    
+    yili: Optional[str] = Field(None, description="""
+        Account year filter (Hesap Yılı).
+        Available years: 1993-2022. Format: 'YYYY' (e.g., '2020')
+        Refers to the fiscal year being audited, not decision date.
+    """)
+    
+    karar_tarih_baslangic: Optional[str] = Field(None, description="""
+        Decision start year for date range filtering.
+        Available years: 2000, 2006-2024. Format: 'YYYY' (e.g., '2020')
+        Use with karar_tarih_bitis for date range filtering.
+    """)
+    
+    karar_tarih_bitis: Optional[str] = Field(None, description="""
+        Decision end year for date range filtering. 
+        Available years: 2000, 2006-2024. Format: 'YYYY' (e.g., '2024')
+        Use with karar_tarih_baslangic for date range filtering.
+    """)
+    
+    kamu_idaresi_turu: KamuIdaresiTuruEnum = Field("ALL", description="""
+        Public administration type filter:
+        • ALL: All institutions (default)
+        • Genel Bütçe Kapsamındaki İdareler: General budget administrations
+        • Yüksek Öğretim Kurumları: Higher education institutions
+        • Belediyeler ve Bağlı İdareler: Municipalities and affiliates
+        • Other specific institution types
+    """)
+    
+    ilam_no: Optional[str] = Field(None, description="Audit report number (İlam No, max 50 chars)")
+    dosya_no: Optional[str] = Field(None, description="File number for the case")
+    temyiz_tutanak_no: Optional[str] = Field(None, description="Appeals board meeting minutes number")
+    
+    temyiz_karar: Optional[str] = Field(None, description="""
+        Content search within appeals decisions.
+        Searches decision text and reasoning.
+        Example: 'araç kiralama kasko'
+    """)
+    
+    web_karar_konusu: WebKararKonusuEnum = Field("ALL", description="""
+        Decision subject category filter:
+        • ALL: All subjects (default)
+        • İhale Mevzuatı ile İlgili Kararlar: Procurement legislation
+        • Personel Mevzuatı ile İlgili Kararlar: Personnel legislation
+        • Harcırah Mevzuatı ile İlgili Kararlar: Travel allowance legislation
+        • Other specialized legal areas
+    """)
+    
+    # DataTables pagination
+    start: int = Field(0, description="Starting record for pagination (0-based)")
+    length: int = Field(10, description="Number of records per page (1-100)")
+
+class TemyizKuruluDecision(BaseModel):
+    """Single Temyiz Kurulu decision entry from search results."""
+    id: int = Field(..., description="Unique decision ID")
+    temyiz_tutanak_tarihi: str = Field(..., description="Appeals board meeting date in DD.MM.YYYY format")
+    ilam_dairesi: int = Field(..., description="Chamber number (1-8)")
+    temyiz_karar: str = Field(..., description="Appeals decision summary and reasoning")
+
+class TemyizKuruluSearchResponse(BaseModel):
+    """Response from Temyiz Kurulu search endpoint."""
+    decisions: List[TemyizKuruluDecision] = Field(default_factory=list, description="List of matching appeals decisions")
+    total_records: int = Field(0, description="Total number of matching records")
+    total_filtered: int = Field(0, description="Number of records after filtering")
+    draw: int = Field(1, description="DataTables draw counter")
+
+# ============================================================================
+# Daire (Chamber) Models  
+# ============================================================================
+
+class DaireSearchRequest(BaseModel):
+    """
+    Search request for Sayıştay Daire (Chamber) decisions.
+    
+    Daire decisions are first-instance audit findings and sanctions
+    issued by individual audit chambers before potential appeals.
+    """
+    yargilama_dairesi: DaireEnum = Field("ALL", description="""
+        Audit chamber filter:
+        • ALL: All chambers (default)
+        • 1-8: Specific chamber number (1. Daire through 8. Daire)
+        Each chamber audits different types of public institutions.
+    """)
+    
+    karar_tarih_baslangic: Optional[str] = Field(None, description="""
+        Decision start year for date range filtering.
+        Available years: 2012-2025. Format: 'YYYY' (e.g., '2020')
+        Use with karar_tarih_bitis for date range filtering.
+    """)
+    
+    karar_tarih_bitis: Optional[str] = Field(None, description="""
+        Decision end year for date range filtering.
+        Available years: 2012-2025. Format: 'YYYY' (e.g., '2024')
+        Use with karar_tarih_baslangic for date range filtering.
+    """)
+    
+    ilam_no: Optional[str] = Field(None, description="Audit report number (İlam No, max 50 chars)")
+    
+    kamu_idaresi_turu: KamuIdaresiTuruEnum = Field("ALL", description="""
+        Public administration type filter:
+        • ALL: All institutions (default)
+        • Genel Bütçe Kapsamındaki İdareler: General budget administrations
+        • Yüksek Öğretim Kurumları: Higher education institutions
+        • Belediyeler ve Bağlı İdareler: Municipalities and affiliates
+        • Other specific institution types
+    """)
+    
+    hesap_yili: Optional[str] = Field(None, description="""
+        Account year filter (Hesap Yılı).
+        Available years: 2005, 2008-2023. Format: 'YYYY' (e.g., '2020')
+        Refers to the fiscal year being audited, not decision date.
+    """)
+    
+    web_karar_konusu: WebKararKonusuEnum = Field("ALL", description="""
+        Decision subject category filter:
+        • ALL: All subjects (default)
+        • İhale Mevzuatı ile İlgili Kararlar: Procurement legislation
+        • Personel Mevzuatı ile İlgili Kararlar: Personnel legislation
+        • Vergi Resmi Harç ve Diğer Gelirlerle İlgili Kararlar: Tax and fee legislation
+        • Other specialized legal areas
+    """)
+    
+    web_karar_metni: Optional[str] = Field(None, description="""
+        Content search within chamber decisions.
+        Searches decision text and audit findings.
+        Example: 'birim fiyat revize edilmemesi'
+    """)
+    
+    # DataTables pagination
+    start: int = Field(0, description="Starting record for pagination (0-based)")
+    length: int = Field(10, description="Number of records per page (1-100)")
+
+class DaireDecision(BaseModel):
+    """Single Daire decision entry from search results."""
+    id: int = Field(..., description="Unique decision ID")
+    yargilama_dairesi: int = Field(..., description="Chamber number (1-8)")
+    karar_tarih: str = Field(..., description="Decision date in DD.MM.YYYY format")
+    karar_no: str = Field(..., description="Decision number")
+    ilam_no: Optional[str] = Field(None, description="Audit report number (may be null)")
+    madde_no: int = Field(..., description="Article/item number within the decision")
+    kamu_idaresi_turu: str = Field(..., description="Public administration type")
+    hesap_yili: int = Field(..., description="Account year being audited")
+    web_karar_konusu: str = Field(..., description="Decision subject category")
+    web_karar_metni: str = Field(..., description="Decision text/summary")
+
+class DaireSearchResponse(BaseModel):
+    """Response from Daire search endpoint."""
+    decisions: List[DaireDecision] = Field(default_factory=list, description="List of matching chamber decisions")
+    total_records: int = Field(0, description="Total number of matching records")
+    total_filtered: int = Field(0, description="Number of records after filtering")
+    draw: int = Field(1, description="DataTables draw counter")
+
+# ============================================================================
+# Document Models
+# ============================================================================
+
+class SayistayDocumentMarkdown(BaseModel):
+    """
+    Sayıştay decision document converted to Markdown format.
+    
+    Used for retrieving full text of decisions from any of the three
+    decision types (Genel Kurul, Temyiz Kurulu, Daire).
+    """
+    decision_id: str = Field(..., description="Unique decision identifier")
+    decision_type: str = Field(..., description="Type of decision: 'genel_kurul', 'temyiz_kurulu', or 'daire'")
+    source_url: str = Field(..., description="Original URL where the document was retrieved")
+    markdown_content: Optional[str] = Field(None, description="Full decision text converted to Markdown format")
+    retrieval_date: Optional[str] = Field(None, description="Date when document was retrieved (ISO format)")
+    error_message: Optional[str] = Field(None, description="Error message if document retrieval failed")

starlette_app.py

@@ -0,0 +1,159 @@
+"""
+Starlette integration example for Yargı MCP Server
+
+This module demonstrates how to integrate the Yargı MCP server
+with a Starlette application, including authentication middleware
+and custom routing.
+
+Usage:
+    uvicorn starlette_app:app --host 0.0.0.0 --port 8000
+"""
+
+import os
+from starlette.applications import Starlette
+from starlette.routing import Mount, Route
+from starlette.requests import Request
+from starlette.responses import JSONResponse, PlainTextResponse, RedirectResponse
+from starlette.middleware import Middleware
+from starlette.middleware.cors import CORSMiddleware
+from starlette.middleware.authentication import AuthenticationMiddleware
+from starlette.authentication import (
+    AuthenticationBackend, AuthCredentials, SimpleUser, AuthenticationError
+)
+
+# Import the main MCP app
+from mcp_server_main import app as mcp_server
+
+# Simple token authentication backend
+class TokenAuthBackend(AuthenticationBackend):
+    async def authenticate(self, request):
+        auth_header = request.headers.get("Authorization")
+        expected_token = os.getenv("API_TOKEN")
+        
+        # Skip auth for health check and public endpoints
+        if request.url.path in ["/health", "/", "/login"]:
+            return None
+            
+        if not expected_token:
+            # No token configured, allow all
+            return AuthCredentials(["authenticated"]), SimpleUser("anonymous")
+            
+        if not auth_header:
+            raise AuthenticationError("Authorization header required")
+            
+        try:
+            scheme, token = auth_header.split()
+            if scheme.lower() != "bearer":
+                raise AuthenticationError("Invalid authentication scheme")
+                
+            if token != expected_token:
+                raise AuthenticationError("Invalid token")
+                
+            return AuthCredentials(["authenticated"]), SimpleUser("user")
+        except ValueError:
+            raise AuthenticationError("Invalid authorization header format")
+
+# Homepage
+async def homepage(request: Request):
+    return JSONResponse({
+        "service": "Yargı MCP Server",
+        "version": "0.1.0",
+        "endpoints": {
+            "mcp": "/mcp-server/mcp/",
+            "api": "/api/",
+            "health": "/health"
+        }
+    })
+
+# API info endpoint
+async def api_info(request: Request):
+    if not request.user.is_authenticated:
+        return JSONResponse({"error": "Authentication required"}, status_code=401)
+        
+    return JSONResponse({
+        "authenticated_as": request.user.display_name,
+        "available_tools": len(mcp_server._tool_manager._tools),
+        "databases": [
+            "Yargıtay", "Danıştay", "Emsal", "Uyuşmazlık",
+            "Anayasa", "KIK", "Rekabet", "Bedesten"
+        ]
+    })
+
+# Health check
+async def health_check(request: Request):
+    return JSONResponse({
+        "status": "healthy",
+        "service": "Yargı MCP Server"
+    })
+
+# Login example (returns token for demo)
+async def login(request: Request):
+    token = os.getenv("API_TOKEN", "demo-token")
+    return JSONResponse({
+        "message": "Use this token in Authorization header",
+        "example": f"Authorization: Bearer {token}",
+        "note": "Set API_TOKEN environment variable to change token"
+    })
+
+# Create MCP ASGI app
+mcp_app = mcp_server.http_app(path='/mcp')
+
+# Configure middleware
+middleware = [
+    Middleware(
+        CORSMiddleware,
+        allow_origins=os.getenv("ALLOWED_ORIGINS", "*").split(","),
+        allow_credentials=True,
+        allow_methods=["*"],
+        allow_headers=["*"],
+    ),
+    Middleware(AuthenticationMiddleware, backend=TokenAuthBackend()),
+]
+
+# Create routes
+routes = [
+    Route("/", homepage),
+    Route("/health", health_check),
+    Route("/login", login),
+    Route("/api/info", api_info),
+    Mount("/mcp-server", app=mcp_app),
+]
+
+# Create Starlette app
+app = Starlette(
+    routes=routes,
+    middleware=middleware,
+    lifespan=mcp_app.lifespan
+)
+
+# Nested mount example
+def create_nested_app():
+    """Example of nested mounting for complex routing structures"""
+    
+    # Create inner app with MCP
+    inner_app = Starlette(
+        routes=[Mount("/services", app=mcp_app)],
+        middleware=middleware
+    )
+    
+    # Create outer app
+    outer_app = Starlette(
+        routes=[
+            Route("/", homepage),
+            Mount("/v1", app=inner_app),
+        ],
+        lifespan=mcp_app.lifespan
+    )
+    
+    # MCP would be available at /v1/services/mcp/
+    return outer_app
+
+# Export both apps
+nested_app = create_nested_app()
+
+if __name__ == "__main__":
+    import uvicorn
+    print("Starting Starlette app with authentication...")
+    print("Set API_TOKEN environment variable to enable authentication")
+    print("Example: API_TOKEN=secret-token python starlette_app.py")
+    uvicorn.run(app, host="0.0.0.0", port=8000)

stripe_webhook.py

@@ -0,0 +1,25 @@
+import os, stripe
+from clerk_backend_api import Clerk                         # Clerk backend SDK
+from fastapi import APIRouter, Request, HTTPException
+
+router = APIRouter()
+stripe.api_key = os.getenv("STRIPE_SECRET")
+clerk         = Clerk(bearer_auth=os.getenv("CLERK_SECRET_KEY"))
+
+@router.post("/stripe/webhook")
+async def stripe_hook(req: Request):
+    payload, sig = await req.body(), req.headers["stripe-signature"]
+    try:
+        event = stripe.Webhook.construct_event(             # Stripe-recommended verify
+            payload, sig, os.getenv("STRIPE_WEBHOOK_SECRET"))
+    except stripe.error.SignatureVerificationError:
+        raise HTTPException(400, "Bad sig")
+
+    if event["type"] == "customer.subscription.updated":
+        item   = event["data"]["object"]["items"]["data"][0]
+        plan   = item["price"]["nickname"]                  # "Pro", "Enterprise"…
+        userID = event["data"]["object"]["metadata"]["clerk_user_id"]
+        clerk.users.update_user_metadata(                   # merge into unsafe_metadata
+            userID, unsafe_metadata={"plan": plan})
+    return {"ok": True}
+    

uyusmazlik_mcp_module/client.py

@@ -31,13 +31,15 @@ BOLUM_ENUM_TO_ID_MAP = {
     UyusmazlikBolumEnum.CEZA_BOLUMU: "f6b74320-f2d7-4209-ad6e-c6df180d4e7c",
     UyusmazlikBolumEnum.GENEL_KURUL_KARARLARI: "e4ca658d-a75a-4719-b866-b2d2f1c3b1d9",
     UyusmazlikBolumEnum.HUKUK_BOLUMU: "96b26fc4-ef8e-4a4f-a9cc-a3de89952aa1",
-    UyusmazlikBolumEnum.TUMU: "" # Represents "...Seçiniz..." or all
+    UyusmazlikBolumEnum.TUMU: "", # Represents "...Seçiniz..." or all - empty string for API
+    "ALL": "" # Also map the new "ALL" literal to empty string for backward compatibility
 }
 
 UYUSMAZLIK_TURU_ENUM_TO_ID_MAP = {
     UyusmazlikTuruEnum.GOREV_UYUSMAZLIGI: "7b1e2cd3-8f09-418a-921c-bbe501e1740c",
     UyusmazlikTuruEnum.HUKUM_UYUSMAZLIGI: "19b88402-172b-4c1d-8339-595c942a89f5",
-    UyusmazlikTuruEnum.TUMU: "" # Represents "...Seçiniz..." or all
+    UyusmazlikTuruEnum.TUMU: "", # Represents "...Seçiniz..." or all - empty string for API
+    "ALL": "" # Also map the new "ALL" literal to empty string for backward compatibility
 }
 
 KARAR_SONUCU_ENUM_TO_ID_MAP = {
@@ -196,7 +198,7 @@ class UyusmazlikApiClient:
         markdown_text = None
         temp_file_path = None
         try:
-            md_converter = MarkItDown(enable_plugins=False)
+            md_converter = MarkItDown()
             with tempfile.NamedTemporaryFile(mode="w", delete=False, suffix=".html", encoding="utf-8") as tmp_file:
                 tmp_file.write(html_input_for_markdown)
                 temp_file_path = tmp_file.name

uyusmazlik_mcp_module/models.py

@@ -7,14 +7,14 @@ from enum import Enum
 # Enum definitions for user-friendly input based on the provided HTML form
 class UyusmazlikBolumEnum(str, Enum):
     """User-friendly names for 'BolumId'."""
-    TUMU = "" # Represents "...Seçiniz..." or all
+    TUMU = "ALL" # Represents "...Seçiniz..." or all
     CEZA_BOLUMU = "Ceza Bölümü"
     GENEL_KURUL_KARARLARI = "Genel Kurul Kararları"
     HUKUK_BOLUMU = "Hukuk Bölümü"
 
 class UyusmazlikTuruEnum(str, Enum):
     """User-friendly names for 'UyusmazlikId'."""
-    TUMU = "" # Represents "...Seçiniz..." or all
+    TUMU = "ALL" # Represents "...Seçiniz..." or all
     GOREV_UYUSMAZLIGI = "Görev Uyuşmazlığı"
     HUKUM_UYUSMAZLIGI = "Hüküm Uyuşmazlığı"
 

yargitay_mcp_module/client.py

@@ -110,7 +110,7 @@ class YargitayOfficialApiClient:
         markdown_output = None
         temp_file_path = None
         try:
-            md_converter = MarkItDown(enable_plugins=False) # Plugins disabled as per basic usage
+            md_converter = MarkItDown() # Plugins disabled as per basic usage
             
             # Write the HTML to a temporary file for MarkItDown to process
             with tempfile.NamedTemporaryFile(mode="w", delete=False, suffix=".html", encoding="utf-8") as tmp_html_file:
@@ -130,15 +130,15 @@ class YargitayOfficialApiClient:
         
         return markdown_output
 
-    async def get_decision_document_as_markdown(self, document_id: str) -> YargitayDocumentMarkdown:
+    async def get_decision_document_as_markdown(self, id: str) -> YargitayDocumentMarkdown:
         """
         Retrieves a specific Yargitay decision by its ID and returns its content
         as Markdown.
         Based on user-provided /getDokuman response structure.
         """
-        document_api_url = f"{self.DOCUMENT_ENDPOINT}?id={document_id}"
+        document_api_url = f"{self.DOCUMENT_ENDPOINT}?id={id}"
         source_url = f"{self.BASE_URL}{document_api_url}" # The original URL of the document
-        logger.info(f"YargitayOfficialApiClient: Fetching document for Markdown conversion (ID: {document_id})")
+        logger.info(f"YargitayOfficialApiClient: Fetching document for Markdown conversion (ID: {id})")
 
         try:
             response = await self.http_client.get(document_api_url)
@@ -149,24 +149,24 @@ class YargitayOfficialApiClient:
             html_content_from_api = response_json.get("data")
 
             if not isinstance(html_content_from_api, str):
-                logger.error(f"YargitayOfficialApiClient: 'data' field in API response is not a string or not found (ID: {document_id}).")
+                logger.error(f"YargitayOfficialApiClient: 'data' field in API response is not a string or not found (ID: {id}).")
                 raise ValueError("Expected HTML content not found in API response's 'data' field.")
 
             markdown_content = self._convert_html_to_markdown(html_content_from_api)
 
             return YargitayDocumentMarkdown(
-                document_id=document_id,
+                id=id,
                 markdown_content=markdown_content,
                 source_url=source_url
             )
         except httpx.RequestError as e:
-            logger.error(f"YargitayOfficialApiClient: HTTP error fetching document for Markdown (ID: {document_id}): {e}")
+            logger.error(f"YargitayOfficialApiClient: HTTP error fetching document for Markdown (ID: {id}): {e}")
             raise
         except ValueError as e: # For JSON parsing errors or missing 'data' field
-             logger.error(f"YargitayOfficialApiClient: Error processing document response for Markdown (ID: {document_id}): {e}")
+             logger.error(f"YargitayOfficialApiClient: Error processing document response for Markdown (ID: {id}): {e}")
              raise
         except Exception as e: # For other unexpected errors
-            logger.error(f"YargitayOfficialApiClient: General error fetching/processing document for Markdown (ID: {document_id}): {e}")
+            logger.error(f"YargitayOfficialApiClient: General error fetching/processing document for Markdown (ID: {id}): {e}")
             raise
 
     async def close_client_session(self):

yargitay_mcp_module/models.py

@@ -1,7 +1,32 @@
 # yargitay_mcp_module/models.py
 
-from pydantic import BaseModel, Field, HttpUrl
-from typing import List, Optional, Dict, Any
+from pydantic import BaseModel, Field, HttpUrl, ConfigDict
+from typing import List, Optional, Dict, Any, Literal
+
+# Yargıtay Chamber/Board Options
+YargitayBirimEnum = Literal[
+    "ALL",  # "ALL" for all chambers
+    # Hukuk (Civil) Chambers
+    "Hukuk Genel Kurulu",
+    "1. Hukuk Dairesi", "2. Hukuk Dairesi", "3. Hukuk Dairesi", "4. Hukuk Dairesi",
+    "5. Hukuk Dairesi", "6. Hukuk Dairesi", "7. Hukuk Dairesi", "8. Hukuk Dairesi",
+    "9. Hukuk Dairesi", "10. Hukuk Dairesi", "11. Hukuk Dairesi", "12. Hukuk Dairesi",
+    "13. Hukuk Dairesi", "14. Hukuk Dairesi", "15. Hukuk Dairesi", "16. Hukuk Dairesi",
+    "17. Hukuk Dairesi", "18. Hukuk Dairesi", "19. Hukuk Dairesi", "20. Hukuk Dairesi",
+    "21. Hukuk Dairesi", "22. Hukuk Dairesi", "23. Hukuk Dairesi",
+    "Hukuk Daireleri Başkanlar Kurulu",
+    # Ceza (Criminal) Chambers
+    "Ceza Genel Kurulu", 
+    "1. Ceza Dairesi", "2. Ceza Dairesi", "3. Ceza Dairesi", "4. Ceza Dairesi",
+    "5. Ceza Dairesi", "6. Ceza Dairesi", "7. Ceza Dairesi", "8. Ceza Dairesi",
+    "9. Ceza Dairesi", "10. Ceza Dairesi", "11. Ceza Dairesi", "12. Ceza Dairesi",
+    "13. Ceza Dairesi", "14. Ceza Dairesi", "15. Ceza Dairesi", "16. Ceza Dairesi",
+    "17. Ceza Dairesi", "18. Ceza Dairesi", "19. Ceza Dairesi", "20. Ceza Dairesi",
+    "21. Ceza Dairesi", "22. Ceza Dairesi", "23. Ceza Dairesi",
+    "Ceza Daireleri Başkanlar Kurulu",
+    # General Assembly
+    "Büyük Genel Kurulu"
+]
 
 class YargitayDetailedSearchRequest(BaseModel):
     """
@@ -9,45 +34,88 @@ class YargitayDetailedSearchRequest(BaseModel):
     to Yargitay's detailed search endpoint (e.g., /aramadetaylist).
     Based on the payload provided by the user.
     """
-    arananKelime: Optional[str] = Field("", description="Keyword to search for.")
-    # Department/Board selection. Based on user provided payload.
-    # birimYrg* fields seem to be the ones used for filtering.
-    birimYrgKurulDaire: Optional[str] = Field("", description="Yargitay Board Unit (e.g., 'Hukuk Genel Kurulu').")
-    birimYrgHukukDaire: Optional[str] = Field("", description="Yargitay Civil Chamber (e.g., '1. Hukuk Dairesi').")
-    birimYrgCezaDaire: Optional[str] = Field("", description="Yargitay Criminal Chamber.")
+    arananKelime: Optional[str] = Field("", description="""Keyword to search for with advanced operators support:
+        • Simple words: 'arsa payı' (OR logic - finds documents with ANY word)
+        • Exact phrases: '"arsa payı"' (finds exact phrase)
+        • AND logic: 'arsa+payı' (both words required)
+        • Wildcards: 'bozma*' (matches bozma, bozması, bozmanın, etc.)
+        • Multiple required: '+"arsa payı" +"bozma sebebi"'
+        • Exclusion: '+"arsa payı" -"inşaat sözleşmesi"'
+        Examples: arsa payı | "arsa payı" | +"mülkiyet hakkı" +"bozma sebebi" | hukuk*""")
+    # Department/Board selection - Complete Court of Cassation chamber hierarchy
+    birimYrgKurulDaire: Optional[str] = Field("ALL", description="""
+        Court of Cassation (Yargıtay) chamber/board selection. Options include:
+        - 'ALL' for all chambers
+        - Civil: 'Civil General Assembly (Hukuk Genel Kurulu)', '1st Civil Chamber (1. Hukuk Dairesi)' through '23rd Civil Chamber (23. Hukuk Dairesi)', 'Civil Chambers Presidents Board (Hukuk Daireleri Başkanlar Kurulu)'
+        - Criminal: 'Criminal General Assembly (Ceza Genel Kurulu)', '1st Criminal Chamber (1. Ceza Dairesi)' through '23rd Criminal Chamber (23. Ceza Dairesi)', 'Criminal Chambers Presidents Board (Ceza Daireleri Başkanlar Kurulu)'
+        - General: 'Grand General Assembly (Büyük Genel Kurulu)'
+        Total: 52 possible values (including 'ALL' for all chambers)
+    """)
+    birimYrgHukukDaire: Optional[str] = Field("", description="Legacy field - use birimYrgKurulDaire instead for chamber selection")
+    birimYrgCezaDaire: Optional[str] = Field("", description="Legacy field - use birimYrgKurulDaire instead for chamber selection")
     
-    esasYil: Optional[str] = Field("", description="Case year for 'Esas No'.")
-    esasIlkSiraNo: Optional[str] = Field("", description="Starting sequence number for 'Esas No'.")
-    esasSonSiraNo: Optional[str] = Field("", description="Ending sequence number for 'Esas No'.")
+    esasYil: Optional[str] = Field("", description="""Case year for 'Esas No' filtering. 
+        Format: YYYY (e.g., '2024')
+        Use with sequence numbers for precise case targeting""")
+    esasIlkSiraNo: Optional[str] = Field("", description="""Starting sequence number for 'Esas No' range filtering.
+        Format: numeric string (e.g., '1', '100')
+        Use with esasSonSiraNo for range: cases 100-200 in specified year""")
+    esasSonSiraNo: Optional[str] = Field("", description="""Ending sequence number for 'Esas No' range filtering.
+        Format: numeric string (e.g., '500', '1000')
+        Creates range from esasIlkSiraNo to this number""")
     
-    kararYil: Optional[str] = Field("", description="Decision year for 'Karar No'.")
-    kararIlkSiraNo: Optional[str] = Field("", description="Starting sequence number for 'Karar No'.")
-    kararSonSiraNo: Optional[str] = Field("", description="Ending sequence number for 'Karar No'.")
+    kararYil: Optional[str] = Field("", description="""Decision year for 'Karar No' filtering.
+        Format: YYYY (e.g., '2024')
+        Filters decisions by the year they were issued""")
+    kararIlkSiraNo: Optional[str] = Field("", description="""Starting sequence number for 'Karar No' range filtering.
+        Format: numeric string (e.g., '1', '50')
+        Use with kararSonSiraNo for decision number ranges""")
+    kararSonSiraNo: Optional[str] = Field("", description="""Ending sequence number for 'Karar No' range filtering.
+        Format: numeric string (e.g., '100', '500')
+        Creates range from kararIlkSiraNo to this number""")
     
-    baslangicTarihi: Optional[str] = Field("", description="Start date for decision search (DD.MM.YYYY).")
-    bitisTarihi: Optional[str] = Field("", description="End date for decision search (DD.MM.YYYY).")
+    baslangicTarihi: Optional[str] = Field("", description="""Start date for decision search.
+        Format: DD.MM.YYYY (e.g., '01.01.2024')
+        Use with bitisTarihi for date range filtering
+        Examples: '01.01.2024', '15.06.2023'""")
+    bitisTarihi: Optional[str] = Field("", description="""End date for decision search.
+        Format: DD.MM.YYYY (e.g., '31.12.2024')
+        Creates date range from baslangicTarihi to this date
+        Examples: '31.12.2024', '30.06.2023'""")
     
-    siralama: Optional[str] = Field("3", description="Sorting criteria (1: Esas No, 2: Karar No, 3: Karar Tarihi).") # Default to 'Karar Tarihine Göre'
-    siralamaDirection: Optional[str] = Field("desc", description="Sorting direction ('asc' or 'desc').") # Default to 'Büyükten Küçüğe'
+    siralama: Optional[str] = Field("3", description="""Sorting criteria for search results:
+        • '1': Esas No (Case Number) - sorts by case registration order
+        • '2': Karar No (Decision Number) - sorts by decision issuance order  
+        • '3': Karar Tarihi (Decision Date) - sorts by chronological order [DEFAULT]
+        Recommended: Use '3' for most recent decisions first""")
+    siralamaDirection: Optional[str] = Field("desc", description="""Sorting direction for results:
+        • 'desc': Descending order (newest/highest first) [DEFAULT]
+        • 'asc': Ascending order (oldest/lowest first)
+        Most common: 'desc' for latest decisions first""")
     
-    pageSize: int = Field(10, ge=1, le=100, description="Number of results per page.")
-    pageNumber: int = Field(1, ge=1, description="Page number to retrieve.")
+    pageSize: int = Field(10, ge=1, le=100, description="""Number of results per page.
+        Range: 1-100 results per page
+        Recommended: 10-50 for balanced performance and coverage
+        Large values (50-100) for comprehensive analysis""")
+    pageNumber: int = Field(1, ge=1, description="""Page number to retrieve (1-indexed).
+        Start with 1 for first page
+        Use with pageSize to navigate through large result sets
+        Example: pageSize=50, pageNumber=3 gets results 101-150""")
 
 class YargitayApiDecisionEntry(BaseModel):
     """Model for an individual decision entry from the Yargitay API search response."""
     id: str # Unique system ID of the decision
-    daire: Optional[str] = Field(None, description="The chamber that made the decision.")
-    esasNo: Optional[str] = Field(None, alias="esasNo", description="Case registry number ('Esas No').")
-    kararNo: Optional[str] = Field(None, alias="kararNo", description="Decision number ('Karar No').")
-    kararTarihi: Optional[str] = Field(None, alias="kararTarihi", description="Date of the decision.")
-    arananKelime: Optional[str] = Field(None, alias="arananKelime", description="Matched keyword in the search result item.")
+    daire: Optional[str] = Field(None, description="The chamber (Daire) that made the decision.")
+    esasNo: Optional[str] = Field(None, alias="esasNo", description="Case registry number (Esas No).")
+    kararNo: Optional[str] = Field(None, alias="kararNo", description="Decision number (Karar No).")
+    kararTarihi: Optional[str] = Field(None, alias="kararTarihi", description="Date of the decision (Karar Tarihi).")
+    arananKelime: Optional[str] = Field(None, alias="arananKelime", description="Matched keyword (Aranan Kelime) in the search result item.")
     # 'index' and 'siraNo' from API response are not critical for MCP tool, so omitted for brevity
     
     # This field will be populated by the client after fetching the search list
-    document_url: Optional[HttpUrl] = Field(None, description="Direct URL to the decision document.")
+    document_url: Optional[HttpUrl] = Field(None, description="Direct URL (Belge URL) to the decision document.")
 
-    class Config:
-        populate_by_name = True # To allow populating by alias from API response
+    model_config = ConfigDict(populate_by_name=True)  # To allow populating by alias from API response
 
 
 class YargitayApiResponseInnerData(BaseModel):
@@ -64,9 +132,9 @@ class YargitayApiSearchResponse(BaseModel):
 
 class YargitayDocumentMarkdown(BaseModel):
     """Model for a Yargitay decision document, containing only Markdown content."""
-    document_id: str = Field(..., description="The unique ID of the document.")
-    markdown_content: Optional[str] = Field(None, description="The decision content converted to Markdown.")
-    source_url: HttpUrl = Field(..., description="The source URL of the original document.")
+    id: str = Field(..., description="The unique ID (Belge Kimliği) of the document.")
+    markdown_content: Optional[str] = Field(None, description="The decision content (Karar İçeriği) converted to Markdown.")
+    source_url: HttpUrl = Field(..., description="The source URL (Kaynak URL) of the original document.")
 
 class CompactYargitaySearchResult(BaseModel):
     """A more compact search result model for the MCP tool to return."""