# RuLegal MCP

> MCP-сервер с доступом к более чем 24 млн документов судебной практики и законодательства России. Гибридный поиск, нормативный граф, дословные цитаты, полный текст по требованию.

## Как подключиться

- MCP (streamable HTTP): https://mcp-rulegacy.shedai.ru/mcp
- Заголовок: `Authorization: Bearer <ключ>` (ключ выдаётся на https://mcp-rulegacy.shedai.ru/register)
- Версия протокола: 2026-07-28, поддерживаются также 2025-11-25 и 2025-06-18
- Начните с `server/discover`, затем `tools/list`, затем `tools/call search`
- REST-вариант: https://mcp-rulegacy.shedai.ru/v1/search, спецификация https://mcp-rulegacy.shedai.ru/v1/openapi.json

## Инструменты

- `search` (Поиск по корпусу): гибридный поиск по более чем 24 млн актов и НПА, фильтры по категории, суду, датам. Возвращает hits[] с готовой цитатой и сниппетом.
- `document` (Полный текст акта): дословный текст, постранично, offset/max_chars. Возвращает text, total_chars, next_offset, text_sha256.
- `passages` (Фрагменты под вопрос): лучшие отрывки документа с позициями. Возвращает passages[] с offset и text.
- `requisites` (Поиск по реквизитам): точный поиск по номеру дела или УИД. Возвращает hits[].
- `bases` (Состав корпуса): категории и объёмы, дата снимка. Возвращает corpus[].
- `norms` (Разбор нормы): «ст. 333 ГК» → идентификатор и число актов. Возвращает norm, documents.
- `practice_by_norm` (Практика по норме): акты по норме, свежие первыми. Возвращает hits[].

## Правила работы с корпусом

1. Правовой вопрос = норма + факты. Начинайте с `norms`, затем `practice_by_norm`.
2. Строка без пассажа это указатель: перед цитированием вызовите `passages` или `document`.
3. Цитируйте дословно с судом, датой и номером дела.
4. «Обычно суды решают так» формулируйте только по множеству прочитанных актов.
5. Пустая выдача означает, что в этом индексе акта нет, а не что практики не существует.

## Машинные файлы

- /integrations.json: конфигурации клиентов, эндпоинты, лимиты
- /.well-known/mcp.json: описание MCP-сервера
- /install.sh: установщик конфигураций
- /v1/openapi.json: спецификация REST

## Ограничения данных

Сервис не является официальной публикацией: перед юридически значимым использованием сверяйте акт с первоисточником.