# @theyahia/casebook-mcp

MCP server for **Casebook/Pravo.ru** -- Russian legal case search, court documents, participant lookup, judge statistics, and hearing schedules.

## Tools

| Tool | Description |
|------|-------------|
| `search_cases` | Search cases by query, INN, court, dates, type |
| `get_case` | Get case details and participants |
| `get_case_events` | Get hearing schedule and decisions |
| `search_participants` | Search participants by name or INN |
| `get_participant_cases` | Get all cases for a participant |
| `get_judge_stats` | Get judge case statistics |
| `get_court_info` | Get court information |
| `get_document` | Get court document by ID |

## Install

### Claude Desktop / Cline / Cursor

```json
{
  "mcpServers": {
    "casebook": {
      "command": "npx",
      "args": ["-y", "@theyahia/casebook-mcp"],
      "env": { "CASEBOOK_TOKEN": "<YOUR_TOKEN>" }
    }
  }
}
```

### Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `CASEBOOK_TOKEN` | Yes | API token from [Casebook](https://casebook.ru/) |

## Demo Prompts

- "Search for bankruptcy cases involving INN 7707083893"
- "Get details for case A40-12345/2026"
- "Show hearing schedule for case A40-12345/2026"
- "Find all cases where Sberbank is a participant"
- "Get case statistics for judge Ivanov"
- "Show court info for the Moscow Arbitration Court"
- "Get document doc-789 from case A40-12345/2026"
- "Search for contract dispute cases from 2025"

## API Reference

Casebook API documentation: [https://casebook.ru/](https://casebook.ru/)

## License

MIT