Yargı MCP acts as a specialized bridge that allows AI assistants to navigate the complex world of Turkish law. Instead of users manually searching through various government portals for court rulings or legal precedents, this tool allows them to simply ask an LLM to find and analyze specific cases. It connects to a vast range of Turkish legal databases—including high courts like the Constitutional Court and specialized boards like the Data Protection Authority (KVKK)—and translates official documents into a format that AI can easily understand and summarize. For those needing more precision, the server provides deep filtering capabilities across 79 different judicial departments and boards. It utilizes high-performance optimizations, such as "Dual" and "Triple" API support, to ensure maximum coverage and reliability even if one source is unavailable. Developers can perform highly specific searches using ISO 8601 date ranges or exact phrase matching, while the server automatically converts complex legal PDFs and HTML files into clean Markdown. This ensures the data is immediately ready for analysis, comparison, or drafting legal documents within a chat interface. What makes this tool particularly valuable for developers is its extreme efficiency, featuring a 61.8% token reduction optimization that significantly lowers operational costs and speeds up AI response times. It is designed for seamless integration using the `uvx` package runner, making it compatible with various environments including Claude Desktop, 5ire, and Gemini CLI. By providing a standardized interface for 19 distinct legal tools, it removes the friction of building custom scrapers or handling multiple authentication layers, allowing developers to focus on building sophisticated legal-tech applications.

1. Installation

Before setting up the MCP server, ensure you have the following prerequisites installed on your system:

• Python: Version 3.11 or higher. (Check "Add Python to PATH" during installation).
• uv: Astral's Python package runner.
  • Windows (PowerShell): powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  • Mac/Linux (Terminal): curl -LsSf https://astral.sh/uv/install.sh | sh
• Git: Required for Windows users.
• Microsoft Visual C++ Redistributable: Required for certain Python packages on Windows.

To run the server directly via uvx:

uvx yargi-mcp

2. Configuration

For Claude Desktop

1. Open Claude Desktop.
2. Go to Settings -> Developer -> Edit Config.
3. Add the following to your claude_desktop_config.json file:

{
  "mcpServers": {
    "Yargı MCP": {
      "command": "uvx",
      "args": [
        "yargi-mcp"
      ]
    }
  }
}

1. Restart Claude Desktop.

For Gemini CLI

Edit your settings file (~/.gemini/settings.json on Mac/Linux or %USERPROFILE%\.gemini\settings.json on Windows) and add the following:

{
  "mcpServers": {
    "yargi_mcp": {
      "command": "uvx",
      "args": [
        "yargi-mcp"
      ]
    }
  }
}

For 5ire

1. Open 5ire and go to Tools.
2. Click +Local or New.
3. Set Tool Key to yargimcp, Name to Yargı MCP, and Command to uvx yargi-mcp.
4. Save and enable the tool.

3. Available Tools

The server provides 19 optimized tools for accessing Turkish legal resources:

• Unified Bedesten API (Yargıtay, Danıştay, Local/Appeals Courts):
  • search_bedesten_unified: Search across 5 court types with filters for 79 departments, dates, and exact phrases.
  • get_bedesten_document_markdown: Retrieve any document by ID in Markdown format.
• UYAP Emsal Karar:
  • search_emsal_detailed_decisions: Search precedent decisions with detailed criteria.
  • get_emsal_document_markdown: Get specific precedent text.
• Uyuşmazlık Mahkemesi (Court of Jurisdictional Disputes):
  • search_uyusmazlik_decisions: Form-based search for jurisdictional decisions.
  • get_uyusmazlik_document_markdown_from_url: Retrieve decision text via URL.
• Anayasa Mahkemesi (Constitutional Court):
  • search_anayasa_unified: Unified search for Norm Review and Individual Applications.
  • get_anayasa_document_unified: Retrieve paginated decision content.
• KİK (Public Procurement Board):
  • search_kik_decisions: Search procurement board decisions.
  • get_kik_document_markdown: Retrieve paginated decision text using Base64 IDs.
• Rekabet Kurumu (Competition Authority):
  • search_rekabet_kurumu_decisions: Search for Merger, Acquisition, or Competition decisions.
  • get_rekabet_kurumu_document: Extract and convert PDF pages to Markdown.
• Sayıştay (Court of Accounts):
  • search_sayistay_genel_kurul: Search General Assembly interpretative decisions.
  • search_sayistay_temyiz_kurulu: Search Appeals Board decisions.
  • search_sayistay_daire: Search department-level audit decisions.

4. Example Prompts

• "Yargıtay'ın mülkiyet hakkı ile ilgili son kararlarını ara" (Search for recent Court of Cassation decisions regarding property rights)
• "Danıştay'ın imar planı iptaline ilişkin kararlarını bul" (Find Council of State decisions regarding the cancellation of zoning plans)
• "Anayasa Mahkemesi'nin ifade özgürlüğü kararlarını getir" (Bring Constitutional Court decisions regarding freedom of expression)

Use Case 1: Legal Precedent Research for Litigation

Problem: Lawyers in Turkey often spend hours manually searching through fragmented portals like UYAP, the Supreme Court (Yargıtay), and the Council of State (Danıştay) to find "Emsal Kararlar" (precedents) to support their legal arguments.
Solution: This MCP allows a legal professional to use an AI assistant to search across all major Turkish court databases simultaneously. It retrieves decision texts in Markdown format, making it easy to summarize, compare, and cite within a legal brief.
Example: A lawyer asks their AI assistant: "Find recent Yargıtay decisions from the 4th Civil Chamber regarding 'moral compensation in traffic accidents' from 2023-2024 and summarize the grounds for the rulings."

Use Case 2: Corporate Regulatory Compliance and Risk Assessment

Problem: Compliance officers at large Turkish firms or international companies operating in Turkey need to monitor decisions from regulatory bodies like the Competition Authority (Rekabet Kurumu), KVKK (Data Protection), and BDDK (Banking Regulation) to ensure their company policies match current enforcement trends.
Solution: The MCP provides direct access to these specific regulatory databases. Instead of navigating complex government search forms, the user can perform natural language queries to identify how these boards have ruled on similar business practices.
Example: A compliance officer asks: "Search for KVKK decisions related to 'explicit consent in banking apps' and list the common reasons for administrative fines mentioned in the last 12 months."

Use Case 3: Public Procurement Strategy and Bid Analysis

Problem: Companies bidding on public tenders need to understand the reasoning behind the Public Procurement Board's (KİK) past decisions to avoid disqualification or to challenge unfair tender results effectively.
Solution: Using the search_kik_decisions and get_kik_document_markdown tools, an analyst can quickly pull the full text of past board rulings based on specific keywords or company names involved in previous tenders.
Example: A tender consultant asks: "Retrieve the KİK decisions from the past year regarding 'security service tenders' where the bid was rejected due to 'insufficient work experience documents' and explain the Board's reasoning."

Use Case 4: Constitutional and Human Rights Case Analysis

Problem: Legal scholars and human rights advocates often need to analyze the Constitutional Court’s (AYM) stance on specific topics like "freedom of expression" or "property rights" across both Individual Applications and Norm Reviews.
Solution: The MCP’s token-optimized search_anayasa_unified tool allows researchers to browse massive volumes of AYM decisions and retrieve paginated Markdown content, which is ideal for long-form academic analysis or reporting.
Example: A researcher asks: "Search the AYM Individual Application database for cases mentioning 'freedom of the press' and 'internet blocks' between 2020 and 2024. Provide a list of case numbers and the violated rights identified."