Yargitay MCP Server

A FastMCP server that provides tools to search and retrieve court decisions from the Yargitay Karar Arama website (https://karararama.yargitay.gov.tr/).

Features

• Search court decisions using keywords and various parameters
• Retrieve full text of court decisions by ID
• Quick search functionality for simple keyword-based searches

Installation

Using uv (recommended)

1. Clone this repository
2. Install dependencies using uv:

   uv sync
   

Alternatively, you can create a virtual environment:

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv sync

Using pip

1. Clone this repository
2. Install dependencies:

   pip install -r requirements.txt
   

Project Structure

yargitay-mcp/
├── yargitay/           # Main package
│   ├── __init__.py     # Package initialization
│   ├── models.py       # Data models
│   ├── client.py       # API client for Yargitay
│   └── server.py       # FastMCP server implementation
├── tests/              # Test suite
│   └── test_yargitay.py # Tests for the Yargitay server
├── examples/           # Example scripts
│   └── client_example.py # Example client usage
├── server.py           # Main entry point
├── pyproject.toml      # Project configuration
└── requirements.txt    # Dependencies (for pip)

Usage

Running the server with FastMCP

There are several ways to run the server:

Development mode (recommended for testing)

fastmcp dev server.py

This launches the interactive MCP Inspector for testing.

Install for Claude Desktop integration

fastmcp install server.py --name "Yargitay Karar Arama"

Direct execution

python server.py

This will start the server with SSE transport on http://localhost:8888.

Running the tests

To run the test suite with pytest:

pytest

Or with the unittest module:

python -m unittest discover tests

Example Client

You can find a simple example client in the examples/client_example.py file:

python examples/client_example.py

Available Tools

The MCP server provides the following tools:

1. quick_search(keyword, page, page_size) - Simplified search with just a keyword
2. search_court_decisions(search_params) - Advanced search with multiple parameters
3. get_decision_by_id(decision_id) - Retrieve the full text of a court decision

Example Usage

1. Search for decisions containing the word "test":

   quick_search(keyword="test")
   

2. Get the full text of a decision by its ID:

   get_decision_by_id(decision_id="1126134100")
   

3. Advanced search with multiple parameters:

   search_court_decisions(
       search_params={
           "keyword": "test", 
           "department": "10. Hukuk Dairesi", 
           "karar_yil": "2025"
       }
   )
   

Development

Setting up the development environment

# Install development dependencies
uv sync --dev

# Run tests
pytest

Implementation Notes

This server follows the FastMCP pattern of directly exporting a mcp variable, which is the FastMCP instance, as recommended in the FastMCP documentation. This allows for direct access to the MCP instance by the FastMCP CLI and other tools.