mcp-fns-check

MCP-сервер для проверки российских контрагентов (юридические лица и ИП) через публичные данные ФНС: ЕГРЮЛ/ЕГРИП, ЕФРСБ, «Прозрачный бизнес», ФССП, КАД.

Готов к подключению в 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 pip install atomno-mcp-fns-check # или pipx install atomno-mcp-fns-check

atomno-mcp-fns-check --version # → atomno-mcp-fns-check 0.1.1 atomno-mcp-fns-check --help # → полный список флагов: --transport / --host / --port / --log-level

По умолчанию пакет запускается как stdio-MCP-сервер: агент общается с ним через stdin/stdout JSON-RPC. Напрямую из шелла вы его не «потыкаете» — подключите к MCP-клиенту. Для сетевых сценариев доступен флаг--transport {http,sse,streamable-http}с--host/--port.

Отредактируйтеmcp.json(Cursor → Settings → Cursor Settings → MCP):

{ "mcpServers": { "fns-check": { "command": "atomno-mcp-fns-check" } } }

Перезапустите Cursor. В чате спросите: «Проверь контрагента ИНН 7707083893» — агент сам вызоветcheck_contractor.

Отредактируйтеclaude_desktop_config.json(macOS:~/Library/Application Support/Claude/, Windows:%APPDATA%\Claude\):

{ "mcpServers": { "fns-check": { "command": "atomno-mcp-fns-check" } } }

claude mcp add fns-check atomno-mcp-fns-check

{ "mcpServers": { "fns-check": { "command": "atomno-mcp-fns-check", "disabled": false, "autoApprove": [] } } }

- egrul.nalog.ru— ЕГРЮЛ/ЕГРИП, карточка контрагента.
- bankrot.fedresurs.ru— ЕФРСБ (Единый федеральный реестр сведений о банкротстве).
- pb.nalog.ru— Прозрачный бизнес ФНС (налоговые долги, непредставление отчётности).
- fssp.gov.ru— Банк данных исполнительных производств ФССП.
- kad.arbitr.ru— Картотека арбитражных дел.
- Локальные срезы реестров ФНС — массовые адреса, массовые руководители, дисквалифицированные лица (загружаются скриптомatomno-mcp-fns-etlиз Open Data ФНС).

{ "identifier": "7707083893", "identifier_type": "inn", "inn": "7707083893", "ogrn": "1027700132195", "card": { "name": {"full": "ПАО СБЕРБАНК", "short": "СБЕРБАНК"}, "status": "active", "address": {"full": "117997, Г.Москва, УЛ. ВАВИЛОВА, Д. 19", "is_mass_address": false}, "director": {"full_name": "Греф Г. О.", "position": "Президент"}, "okved_main": {"code": "64.19", "name": "Денежное посредничество прочее"} }, "legal_status": {"status": "active", "status_label_ru": "Действующее", "sources_checked": ["egrul", "efrsb"]}, "risks": {"overall_risk_level": "low", "overall_risk_score": 0, "flags": [], "errors": []}, "verdict_action": "safe_to_proceed", "verdict_reason_ru": "Статус «Действующее», уровень риска — low (score 0/100). Препятствий к заключению сделки по открытым источникам не найдено.", "recommendations": [ "По открытым источникам препятствий к заключению сделки не обнаружено. Соблюдайте стандартные меры должной осмотрительности (ст. 54.1 НК РФ): копия устава, приказ на руководителя, договор." ], "sources": {"sources_queried": ["efrsb", "egrul", "fssp", "kad", "pb_fns", "registries"]}, "tier": "open", "checked_at": "2026-04-24T20:15:00Z" }

- ЕГРЮЛ — единственныйblocking-источник. Если он недоступен,check_contractorподнимаетSourceUnavailableError(агент получит человекочитаемое сообщение).
- Остальные источники подмешиваютсяbest-effort: CAPTCHA на ФССП, antibot на КАД, 5xx на pb.nalog.ru — всё складывается вrisks.errors[]и НЕ валит отчёт. Верхнеуровневый вердикт становитсяmanual_review_required.

Все настройки — через переменные окружения. Никаких креденшелов не требуется (источники публичные).

Реестры массовых адресов / руководителей / дисквалифицированных лиц — это CSV/XML-выгрузки Open Data ФНС. Пакет идёт со встроенным мини-сидом (registries_seed.json, синтетические тестовые записи) — его достаточно, чтобы тулзы работали «из коробки» и показывали флаги на тестовых ИНН.

Для production-проверок обновите реестры полными срезами через CLIatomno-mcp-fns-etl:

atomno-mcp-fns-etl --registry mass_addresses --source ./fns_open_data/ulm.csv --commit atomno-mcp-fns-etl --registry mass_directors --source ./fns_open_data/uchredt.csv --commit atomno-mcp-fns-etl --registry disqualified --source ./fns_open_data/disqualified.csv --commit

- mass_addresses→nalog.gov.ru/opendata/7707329152-massreg/
- mass_directors→nalog.gov.ru/opendata/7707329152-massuchredt/
- disqualified→service.nalog.ru/disqualified.do

git clone https://github.com/atomno-mcp/mcp-fns-check cd mcp-fns-check python -m venv .venv source .venv/bin/activate # Linux/macOS # .venv/Scripts/activate # Windows pip install -e ".[dev]" pytest -v --cov=src/atomno_mcp_fns_check

Внешние API в тестахникогда не вызываются напрямую— только черезrespx(мокинг httpx) + локальные фикстуры вtests/fixtures/.

- Нет history для руководителей— ФНС не отдаёт историю смены через search-API; полная история появится после загрузки Open Data slice ЕГРЮЛ (планируется в v0.5+).
- ФССП / КАД иногда блокируютCAPTCHA / antibot. В этом случае проверка падает вerrors[], а общий вердикт становитсяmanual_review_required.
- Прозрачный бизнесотдаёт только факт («есть задолженность» / «нет отчётности»), без суммы. Сумму надо запрашивать в ИФНС.

Pro-tier (hosted backend вatomno-mcp-fns-check-server— закрытый бэк) убирает эти ограничения через: кэш Redis 24h, ротация прокси для обхода CAPTCHA, полный срез Open Data ЕГРЮЛ, batch-проверки до 100 ИНН, AI-summary через LLM. Сам backend не опубликован.

- Все источники —публично открытые данные ФНСи связанных реестров. Использование легально по 149-ФЗ «Об информации».
- Юридические лица и ИПне подпадаютпод 152-ФЗ (О персональных данных).
- ФИО физических лиц-руководителей публикуются ФНС в ЕГРЮЛ открыто; в outbound-ответах ИНН физлица-руководителя маскируется (форматXXX*YY).
- Никаких write-операций ни в один внешний API.
- Никаких credential'ов / токенов не требуется — источники полностью публичные.

Сервис —агрегатор и удобный интерфейс над публичными данными ФНС. Не аффилирован с ФНС России, ЕФРСБ, КАД, ФССП. Используется на ваш риск.

Информация в ответах сервисане заменяетполноценной юридической или финансовой оценки. Решение о заключении договора с контрагентом принимаете вы.

- GitHub:atomno-mcp/mcp-fns-check
- Больше MCP-серверов под брендом atomno:каталог atomno-mcp.ru
- MCP-спецификация:modelcontextprotocol.io

Query French legal databases using the Legifrance API.