Metadata-Version: 2.4
Name: atomno-mcp-sudact
Version: 0.1.1
Summary: Thin MCP client for Russian court practice (Sudact) hosted API: full-text case search + full decision text. Engine is hosted; this package only talks to the Atomno Labs backend.
Project-URL: Homepage, https://github.com/atomno-labs/mcp-sudact
Project-URL: Repository, https://github.com/atomno-labs/mcp-sudact
Project-URL: Issues, https://github.com/atomno-labs/mcp-sudact/issues
Project-URL: Changelog, https://github.com/atomno-labs/mcp-sudact/blob/main/CHANGELOG.md
Project-URL: Documentation, https://atomno-labs.ru/mcp/sudact
Author-email: atomno-labs <hello@atomno-labs.ru>
License: MIT
License-File: LICENSE
Keywords: atomno,court-practice,kad,legal,mcp,model-context-protocol,russia,sudact
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Legal Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Russian
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: fastmcp<4.0.0,>=2.0.0
Requires-Dist: httpx<1.0.0,>=0.27.0
Requires-Dist: pydantic<3.0.0,>=2.6.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: respx>=0.21.1; extra == 'dev'
Requires-Dist: ruff>=0.5.0; extra == 'dev'
Provides-Extra: release
Requires-Dist: build>=1.2.0; extra == 'release'
Requires-Dist: twine>=5.1.0; extra == 'release'
Description-Content-Type: text/markdown

<!-- mcp-name: io.github.atomno-labs/mcp-sudact -->

# atomno-mcp-sudact

[![PyPI](https://img.shields.io/pypi/v/atomno-mcp-sudact)](https://pypi.org/project/atomno-mcp-sudact/)
[![License: MIT](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
[![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)

**Судебная практика РФ для AI-агентов** — Russian court case-law search for AI agents (Cursor, Claude, and any MCP client).

MCP-сервер (Model Context Protocol) для поиска по судебной практике России:
полнотекстовый поиск по текстам решений — по тексту документа, статье закона, суду,
инстанции и датам — и получение полного текста решения по выбранному делу.

> Работает через hosted-API Atomno Labs: движок поиска, кэш и анонимизация ПДн —
> на нашей стороне, вам не нужно ничего парсить или поднимать, данные всегда свежие.
> Нужен только API-ключ (тариф Pro) —
> [atomno-labs.ru/pricing](https://atomno-labs.ru/pricing#sudact-pro).

## Быстрый старт

```bash
pipx install atomno-mcp-sudact
# или: uvx atomno-mcp-sudact
```

## Конфигурация (env vars)

| Переменная | Описание | Где взять | Обязательна |
|---|---|---|---|
| `MCP_SUDACT_TOKEN` | API-ключ (заголовок `X-API-Key`) | [atomno-labs.ru/pricing](https://atomno-labs.ru/pricing#sudact-pro) | да |
| `MCP_SUDACT_API_BASE` | Базовый URL бэкенда | по умолчанию прод | нет |
| `MCP_SUDACT_TIMEOUT` | Таймаут HTTP, сек (default 60) | — | нет |

## Использование в Cursor (`mcp.json`)

```json
{
  "mcpServers": {
    "sudact": {
      "command": "uvx",
      "args": ["atomno-mcp-sudact"],
      "env": { "MCP_SUDACT_TOKEN": "ваш-ключ" }
    }
  }
}
```

## Использование в Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "sudact": {
      "command": "uvx",
      "args": ["atomno-mcp-sudact"],
      "env": { "MCP_SUDACT_TOKEN": "ваш-ключ" }
    }
  }
}
```

## Тулзы

| Тул | Вход | Выход | Описание |
|---|---|---|---|
| `search_cases` | `query`, `court_type`, `instance`, `norms`, `date_from`, `date_to`, `limit` | `total_found` + список дел (`case_id`, `url`, …) | Полнотекстовый поиск как на sudact.ru |
| `get_citation` | `url` \| `case_id`, `include_full_text`, `anonymize_level` | Полный текст решения (+ опц. анонимизация) | Полный текст решения по карточке/ id |

## Disclaimer

Проект не аффилирован с sudact.ru. Данные — из открытых источников; используете на свой риск.
Полнотекстовый доступ предоставляется как hosted-сервис по подписке.

## Лицензия

MIT — см. [LICENSE](./LICENSE).
