About mcp-sudact
mcp-sudact is an MCP server for legal professionals searching Russian court decisions by text, law article, court, instance, and date. It can return full decision text with optional anonymization through a hosted service.
Key features
- 01Full-text case search
- 02Filters by court and instance
- 03Date and law-article filters
- 04Full decision text retrieval
- 05Optional personal-data anonymization
Use cases
- 01Find decisions under a specific law article
- 02Search cases from a court and date range
- 03Retrieve and review a case’s full text
MCP support
Exposes case-search and decision-retrieval tools to MCP clients such as Cursor and Claude. Search and text access use the hosted atomno-mcp service and require an API key.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
uvx atomno-mcp-sudactMCP_SUDACT_TOKENSecretAPI key (Pro tier) for hosted search and document retrieval.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
2Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | Number of cases to return (1-50). |
| norms | any | No | Filter by statute articles (the first goes in the 'Статья закона' field). |
| query | string | Yes | Document text / legal question phrasing. |
| date_to | any | No | End date (YYYY-MM-DD). |
| instance | string | No | Instance: any | first | appeal | cassation | supervision. |
| date_from | any | No | Date from (YYYY-MM-DD). |
| court_type | string | No | vs — Supreme Court of the Russian Federation; arbitr — arbitration courts; soyu — courts of general jurisdiction; ks — Constitutional Court; any — all. |
Details
From the project READMEatomno-mcp-sudact
MCP-сервер судебной практики России: ищет судебные решения по тексту, статье закона, суду, инстанции и дате и отдаёт полный текст выбранного дела. Для юристов и юридических компаний — подключается к Cursor, Claude и любому клиенту MCP.
Russian court practice search for AI agents.
Работает через интернет-сервис atomno-mcp: поиск, кэш и скрытие персональных данных — на нашей стороне, ничего парсить и поднимать не нужно. Нужен только ключ (тариф Pro) — atomno-mcp.ru/pricing.
Быстрый старт
pipx install atomno-mcp-sudact
# или: uvx atomno-mcp-sudact
Конфигурация (env vars)
| Переменная | Описание | Где взять | Обязательна |
|---|---|---|---|
MCP_SUDACT_TOKEN | API-ключ (заголовок X-API-Key) | atomno-mcp.ru/pricing | да |
MCP_SUDACT_API_BASE | Базовый URL бэкенда | по умолчанию прод | нет |
MCP_SUDACT_TIMEOUT | Таймаут HTTP, сек (default 60) | — | нет |
Использование в Cursor (mcp.json)
{
"mcpServers": {
"sudact": {
"command": "uvx",
"args": ["atomno-mcp-sudact"],
"env": { "MCP_SUDACT_TOKEN": "ваш-ключ" }
}
}
}
Использование в Claude Desktop (claude_desktop_config.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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.