mcp-fns-check

by atomno-mcp

13 stars

483 downloads

Not rated

GitHub

About

MCP server for Russian counterparty due diligence via FNS open data. 7 tools: check_contractor (aggregated verdict), check_inn, check_ogrn, get_legal_status, get_okveds, get_directors_history, check_for_red_flags. Source

Details

Author: atomno-mcp
GitHub stars: 13
Downloads: 483
Categories: Other, Security

- Кто это: наименование, адрес, ОКВЭД, руководитель
- Жив ли: действующее, в ликвидации, банкротство, ликвидировано, реорганизация
- egrul.nalog.ru — ЕГРЮЛ/ЕГРИП, карточка контрагента
- bankrot.fedresurs.ru — ЕФРСБ (Единый федеральный реестр сведений о банкротстве)
- pb.nalog.ru — Прозрачный бизнес ФНС (налоговые долги, непредставление отчётности)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name mcp-fns-check

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-fns-check": {
            "fns-check": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-fns-check"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-fns-check": {
            "fns-check": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-fns-check"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-fns-check": {
            "fns-check": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-fns-check"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mcp-fns-check": {
            "fns-check": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-fns-check"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-fns-check": {
            "fns-check": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-fns-check"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-fns-check": {
            "fns-check": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-fns-check"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-fns-check": {
            "fns-check": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-fns-check"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-fns-check": {
            "fns-check": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-fns-check"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-fns-check": {
            "fns-check": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-fns-check"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mcp-fns-check": {
            "fns-check": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-fns-check"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-fns-check": {
            "fns-check": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-fns-check"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-fns-check": {
            "fns-check": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-fns-check"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-fns-check": {
            "fns-check": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-fns-check"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-fns-check": {
            "fns-check": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-fns-check"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-fns-check": {
            "fns-check": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-fns-check"
                ]
            }
        }
    }
}

From the repository

The README includes setup instructions such as python -m venv .venv.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp-fns-check": {
            "fns-check": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-fns-check"
                ]
            }
        }
    }
}

McpServers

{
    "fns-check": {
        "command": "uvx",
        "args": [
            "atomno-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

По умолчанию CLI работает в--dry-run(парсит и печатает sample); для записи нужен явный--commit. Meta-поля<registry>.last_etl,<registry>.last_etl_source,<registry>.last_etl_countсохраняются автоматически — используйте их для cron-мониторинга свежести данных.

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

Transaction-complete hotel booking over MCP — 300K+ properties, real hotel confirmation numbers, loyalty points, secure checkout. Hotels are merchant of record. Builders set their own booking fee via Stripe Connect. Built on proven distribution infrastructure.

An MCP server for AI video generation. MCP server for AI video generation. Lets Claude, ChatGPT, OpenClaw , Hermes & other agents create AI videos and publish them to YouTube, TikTok, Instagram etc..

Institutional research and manager diligence reports on hedge funds, venture capital and private equity managers. Summary of filings, personnel changes, media screening and social signals delivered to you in minutes.

ALTER - identity infrastructure for the AI economy

D2C eCommerce fulfillment platform: manage orders, inventory, shipments, campaigns, and billing via AI agents

Apigene MCP Gateway is the runtime layer that connects AI agents to APIs and MCP servers via Model Context Protocol.

MCP to interface with multiple blockchains, staking, DeFi, swap, bridging, wallet management, DCA, Limit Orders, Coin Lookup, Tracking and more.

MCP server for Bitnovo Pay integration with AI agents. Provides cryptocurrency payment capabilities through Bitnovo Pay API. Features include payment creation, status checking, QR code generation, and webhook management with support for multiple tunnel providers (ngrok, zrok, manual).

Shop for gift cards, esims, phone topups. Pay with cards and crypto.

You built it, now get users! GoToMarket MCP server

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

mcp-fns-check

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

Claude Desktop / Cursor

McpServers

Install

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀