mcp-fns-check — MCP-сервер для Claude Code: проверка контрагентов ФНС
MCP-сервер, через который агент проверяет российского контрагента по ИНН или ОГРН: статус в ЕГРЮЛ, банкротство, налоговые долги, приставы и арбитраж.
claude mcp add mcp-fns-check -- uvx atomno-mcp-fns-checkЧто делает mcp-fns-check
Сервер даёт агенту семь инструментов. Главный — check_contractor(identifier): принимает ИНН (10 или 12 цифр) либо ОГРН (13 или 15) и возвращает сводный отчёт с вердиктом — от safe_to_proceed до high_risk_do_not_proceed — и списком рекомендаций. Остальные шесть работают точечно: карточка из ЕГРЮЛ, юридический статус, коды ОКВЭД с расшифровкой, руководитель и история, отдельная проверка по семи риск-флагам.
Данные берутся из открытых источников: egrul.nalog.ru, bankrot.fedresurs.ru, набор ФНС «debtam» по задолженности, реестр дисквалифицированных лиц на service.nalog.ru, банк данных ФССП и картотека kad.arbitr.ru. Срезы массовых адресов и руководителей лежат локально — их загружает отдельный скрипт atomno-mcp-fns-etl из Open Data ФНС. Ключей API не нужно.
ЕГРЮЛ — единственный источник, без которого отчёт не собирается: если он лежит, вызов падает с ошибкой. Остальные опрашиваются по возможности, и сбой любого из них (CAPTCHA на стороне ФССП, антибот на КАД) не рушит ответ, а опускает вердикт до manual_review_required. Пакет запускается как stdio-сервер, для сети есть флаги --transport, --host и --port.
Какие задачи решает
- проверить контрагента по ИНН перед сделкой и увидеть вердикт с рекомендациями
- узнать, не идёт ли компания к ликвидации или банкротству
- найти налоговые долги и исполнительные производства у партнёра
- поймать массовый адрес или дисквалифицированного руководителя
- подтянуть карточку ЕГРЮЛ с ОКВЭД прямо в чат агента
Примеры запросов агенту
- Проверь контрагента по ИНН
7707083893и скажи, можно ли с ним работать - Прогони
check_for_red_flagsпо этой компании и покажи, какие флаги сработали - Дай юридический статус и коды ОКВЭД для ОГРН
1027700132195
Как установить mcp-fns-check
Командой платформы
claude mcp add mcp-fns-check -- uvx atomno-mcp-fns-checkuvx запускает команду с именем пакета; если в README она другая — uvx --from atomno-mcp-fns-check <команда>
Командой платформы
codex mcp add mcp-fns-check -- uvx atomno-mcp-fns-checkuvx запускает команду с именем пакета; если в README она другая — uvx --from atomno-mcp-fns-check <команда>
Файл настроек
{
"mcpServers": {
"mcp-fns-check": {
"command": "uvx",
"args": [
"atomno-mcp-fns-check"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from atomno-mcp-fns-check <команда>
Файл настроек
{
"servers": {
"mcp-fns-check": {
"type": "stdio",
"command": "uvx",
"args": [
"atomno-mcp-fns-check"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from atomno-mcp-fns-check <команда>
Командой платформы
gemini mcp add mcp-fns-check uvx atomno-mcp-fns-checkuvx запускает команду с именем пакета; если в README она другая — uvx --from atomno-mcp-fns-check <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-fns-check
Как установить mcp-fns-check в Claude Code?
Одной командой: claude mcp add mcp-fns-check -- uvx atomno-mcp-fns-check. После этого сервер подключается как stdio и инструменты доступны агенту.
Что делает mcp-fns-check?
Даёт агенту семь инструментов для проверки российских контрагентов: карточка ЕГРЮЛ, статус, ОКВЭД, руководитель, риск-флаги и сводный отчёт check_contractor с готовым вердиктом.
Что будет, если один из источников недоступен?
Отчёт всё равно вернётся, если отвечает ЕГРЮЛ. Сбои остальных источников попадают в risks.errors[], а вердикт становится manual_review_required. Без ЕГРЮЛ вызов завершится ошибкой.
Нужны ли ключи API?
Нет, сервер работает с публичными источниками ФНС и открытыми реестрами.
