atomno-mcp-sudact
MCP-клиент для поиска судебной практики и карточек дел ФАС через подключённый API ATOMNO. Это тонкий клиент, а не собственная полная база судебных решений. Python >=3.11.
Установка и подключение
pip install atomno-mcp-sudact
atomno-mcp-sudact --help
atomno-mcp-sudact --version
Для подключения используйте ключ и адрес активированной услуги из кабинета/инструкции. Ключ задаётся переменной MCP_SUDACT_TOKEN, адрес — MCP_SUDACT_API_BASE. По умолчанию адрес https://api.atomno-mcp.ru/sudact; конкретный доступ и подключённые источники определяет услуга. MCP_SUDACT_TIMEOUT задаёт HTTP-таймаут в секундах (по умолчанию 60).
{"mcpServers":{"sudact":{"command":"atomno-mcp-sudact","env":{"MCP_SUDACT_TOKEN":"YOUR_API_KEY","MCP_SUDACT_API_BASE":"https://api.atomno-mcp.ru/sudact"}}}}
Не сохраняйте настоящий ключ в репозитории. Получение ключа не означает автоматическое подключение всех источников.
Инструменты
search_cases: текст от 3 символов,court_type=any|vs|arbitr|soyu|ks|fas, толькоinstance=any, статьиnorms, датыYYYY-MM-DD,limit=1..50. Исходные поля, предупреждения, provenance и сведения о лимитах сохраняются.search_fas_decisions: карточки ФАС; текст, органbody, законlaw(44-ФЗ/223-ФЗ/135-ФЗ/38-ФЗ), вид актаact_type, даты, лимит. Передаётся/v1/searchсcourt_type=fas. Карточка не обязательно содержит полный текст решения.get_citation:urlилиcase_idиз выдачи,include_full_text,anonymize_level=none|physical_persons|all_persons. Наличие полного текста и результат анонимизации определяет backend.
У search_cases есть соответствующие поля fas_body, fas_law, fas_act_type, допустимые только для any/fas. Виды актов: решение, предписание, постановление, постановление о штрафе, определение, предупреждение, жалоба, уведомление.
page=1..5 допустим только для одного раздела vs/arbitr/soyu/ks, без фильтров ФАС, при page*limit<=50. Такой запрос не смешивает корпуса и fallback. Обёртка проверки норм на конкретной услуге может отклонить page с 422 — в этом случае запросите без page. Клиент не отключает серверную проверку норм.
source и collegium не являются подтверждёнными фильтрами действующего REST-контракта и не экспортируются. Поле source в ответе — происхождение записи. Разделы soyu/ks, выбор ФАС и установленный клиент не гарантируют права на все источники, полный корпус или свежесть всех данных.
Ошибки и учёт
Пустая успешная выдача отличается от ошибки источника. 401/403/429/5xx сохраняются как backend_error со статусом; таймаут/сетевая ошибка — unavailable. Ошибочный/необъектный JSON не становится пустым результатом. Отсутствующий ключ — missing_token, неправильный ключ не называется отсутствующим.
Каждый вызов выполняет одну попытку POST. Автоматического повтора при timeout, 429 или 502–504 нет: повтор может быть новым учитываемым запросом. Таймаут не доказывает, что сервер не учёл обращение; клиент не обещает возврат квоты. Права и учёт определяет действующая услуга.
Запуск
По умолчанию — stdio. Поддерживаются --transport/-t stdio|http|sse|streamable-http, --host, --port, --log-level/-l DEBUG|INFO|WARNING|ERROR|CRITICAL, --version/-V. Для HTTP-транспортов по умолчанию используются 127.0.0.1:8000; публичное размещение требует отдельной настройки доступа. Уровень CLI имеет приоритет над MCP_SUDACT_LOG_LEVEL; неправильный уровень — ошибка запуска. Баннер не попадает в stdio.
Разработка
pip install -e ".[dev,release]"
ruff check .
pytest --cov=atomno_mcp_sudact --cov-fail-under=85
python -m build
python -m twine check dist/*
Тесты используют изолированные HTTP-ответы, а не доказывают работу production или платного клиентского доступа. MIT распространяется на клиентский код; условия источников и услуги определяются отдельно.
Metadata
Release files for atomno-mcp-sudact 0.1.10
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| atomno_mcp_sudact-0.1.10.tar.gz | 16.2 kB | Without provenance | Details for atomno_mcp_sudact-0.1.10.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| atomno_mcp_sudact-0.1.10-py3-none-any.whl | Python 3 | none | any | Details for atomno_mcp_sudact-0.1.10-py3-none-any.whl |
Total release size: 29.4 kB
Release files / atomno_mcp_sudact-0.1.10.tar.gz
| Download URL | atomno_mcp_sudact-0.1.10.tar.gz |
|---|---|
| Size | 16.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0476291ec5f7881f0636b5f9f9d32ecc6665d84b20f6c2588662e1965120596a
|
|
BLAKE2b-256 checksum How to use checksums |
a8484d0274f086d3751dbb3a04033b8d32dcac22097b87d804ff946ae10d13a1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
Release files / atomno_mcp_sudact-0.1.10-py3-none-any.whl
| Download URL | atomno_mcp_sudact-0.1.10-py3-none-any.whl |
|---|---|
| Size | 13.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b9bf38ddef16160c668e76e654832b89c5fb6ca3bac0a3f52f3e3bc562b1ec02
|
|
BLAKE2b-256 checksum How to use checksums |
611fbbf3f594c5e6e0875a5ca1b236a9cfcd75ba5ed3a74995740defc6cee2e1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
Security for atomno-mcp-sudact 0.1.10
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.