atomno-mcp/mcp-fns-check

MCP-сервер проверки российских контрагентов: ЕГРЮЛ, банкротство, налоговые долги, приставы и арбитражные дела. Для разведки компаний — подключается к Cursor, Claude и любому клиенту MCP.
Russian counterparty check for AI agents.
Готов к подключению в Claude Desktop, Cursor, Claude Code, Cline и любой другой клиент, совместимый с Model Context Protocol (MCP).
---
Зачем
AI-агент (Claude, Cursor, etc.) обычно ничего не знает о российских контрагентах: ЕГРЮЛ не индексируется поисковиками нормально, данные в Прозрачном бизнесе ФНС — за POST-запросами и CAPTCHA, ЕФРСБ отдаёт HTML. Этот MCP-сервер даёт агенту **семь тулзов**, через которые он за один вызов получит полную картину:
- Кто это: наименование, адрес, ОКВЭД, руководитель.
- Жив ли: действующее, в ликвидации, банкротство, ликвидировано, реорганизация.
- Безопасно ли с ним работать: массовый адрес, массовый руководитель, дисквалификация, банкротство, налоговые долги, исполнительные производства, арбитражные дела.
Главный тул — check_contractor(identifier) — принимает ИНН или ОГРН и возвращает **агрегированный отчёт с вердиктом** (safe_to_proceed / manual_review_required / high_risk_do_not_proceed / impossible_contractor_defunct) и список конкретных рекомендаций.
---
Быстрый старт
Установка
Или через uv / pipx:
Проверка работы
По умолчанию пакет запускается как stdio-MCP-сервер: агент общается с ним через stdin/stdout JSON-RPC. Напрямую из шелла вы его не «потыкаете» — подключите к MCP-клиенту. Для сетевых сценариев доступен флаг --transport {http,sse,streamable-http} с --host/--port.
---
Подключение к MCP-клиентам
Cursor
Отредактируйте mcp.json (Cursor → Settings → Cursor Settings → MCP):
Перезапустите Cursor. В чате спросите: «Проверь контрагента ИНН 7707083893» — агент сам вызовет check_contractor.
Claude Desktop
Отредактируйте claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):
Перезапустите Claude Desktop.
Claude Code (CLI)
Cline (VS Code)
В cline_mcp_settings.json:
---
Тулзы
| Тул | Назначение | Вход | Источники |
|---|---|---|---|
| **check_contractor** | **Главный.** Полная проверка по одному идентификатору + детерминированный вердикт и рекомендации | identifier: str (ИНН 10/12 или ОГРН 13/15) | все 5 |
| check_inn | Базовая карточка ЕГРЮЛ | inn: str | egrul.nalog.ru |
| check_ogrn | Базовая карточка по ОГРН/ОГРНИП | ogrn: str | egrul.nalog.ru |
| get_legal_status | Жизненный статус с обогащением | inn или ogrn | ЕГРЮЛ + ЕФРСБ |
| get_okveds | Коды ОКВЭД с расшифровкой | inn или ogrn | ЕГРЮЛ + словарь ОКВЭД-2 |
| get_directors_history | Текущий руководитель (+ история по мере Open Data) | inn: str | ЕГРЮЛ |
| check_for_red_flags | 7 проверок риска (4 базовые + 3 расширенные) | inn: str | все источники |
Используемые публичные источники:
- **egrul.nalog.ru** — ЕГРЮЛ/ЕГРИП, карточка контрагента.
- **bankrot.fedresurs.ru** — ЕФРСБ (Единый федеральный реестр сведений о банкротстве).
- **Открытые данные ФНС, набор «debtam»** — налоговая задолженность (локальная выгрузка).
- **service.nalog.ru** — живой реестр дисквалифицированных лиц.
- **fssp.gov.ru** — Банк данных исполнительных производств ФССП.
- **kad.arbitr.ru** — Картотека арбитражных дел.
- Локальные срезы реестров ФНС — массовые адреса, массовые руководители, дисквалифицированные лица (загружаются скриптом atomno-mcp-fns-etl из Open Data ФНС).
Проверки непредставления налоговой отчётности в наборе **нет**: публичного
источника этих сведений не существует, а отвечать «отчётность сдаётся» без
данных сервис не будет.
Пример ответа check_contractor
Поведение при сбоях источников
- ЕГРЮЛ — единственный **blocking**-источник. Если он недоступен, check_contractor поднимает SourceUnavailableError (агент получит человекочитаемое сообщение).