# atomno-labs/mcp-fns-check [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/atomno-labs/mcp-fns-check  
**GitHub Stars:** 15  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/atomno-labs-mcp-fns-check

## Description
Russian counterparty due diligence — INN/OGRN lookup against EGRUL/EGRIP, bankruptcy registry (EFRSB), tax debts (Transparent Business), FSSP enforcement proceedings, and arbitration courts (KAD). Aggregated verdict with risk flags and recommendations. No API key required (public Federal Tax Service data).

## Tools
Capabilities this server exposes over MCP:

- **ping** — Диагностический тул: проверяет, что сервер запущен и доступен.
- **check_contractor** — Главный тул: полная проверка контрагента по одному идентификатору.

Принимает ИНН (10 цифр — юр.лицо, 12 — ИП/физлицо) или ОГРН
(13 цифр — юр.лицо, 15 — ИП). Тип определяется строго по длине и
контрольной цифре.
- **check_inn** — Полная карточка контрагента по ИНН (10 цифр — юр.лицо, 12 — ИП).
- **check_ogrn** — Карточка контрагента по ОГРН (13 цифр) или ОГРНИП (15 цифр).
- **get_legal_status** — Текущий жизненный статус: active / liquidating / bankruptcy / liquidated / reorganizing / excluded_inactive.

Минимум один из `inn` или `ogrn` обязателен.
- **get_okveds** — Перечень кодов ОКВЭД основной + дополнительные с расшифровкой по справочнику ОКВЭД-2.
- **get_directors_history** — История смены руководителей и учредителей по ИНН.

На стадии S3 возвращает только текущего руководителя из egrul.nalog.ru
плюс предупреждение о неполноте данных. Полная история (с датами
назначения/увольнения) появится на стадии S5 после загрузки Open Data
slice ЕГРЮЛ.
- **check_for_red_flags** — Агрегированный риск-чек по контрагенту (8 проверок, SPEC §3.5).

Базовые 4 проверки (всегда):
  * `mass_address` — массовый юр.адрес ФНС;
  * `mass_director` — массовый руководитель (≥10 действующих компаний);
  * `disqualified_director` — руководитель в реестре дисквалифицированных;
  * `bankruptcy_records` — активные дела в ЕФРСБ.

Расширенные 4 проверки (`include_extended=True`):
  * `tax_debts` — индикатор задолженности по налогам (Прозрачный бизнес);
  * `no_reporting` — нет налоговой отчётности > 1 года (Прозрачный бизнес);
  * `enforcement_proceedings` — открытые исп.производства (Банк данных ФССП);
  * `active_lawsuits` — активные арбитражные дела где контрагент ответчик
    (КАД), фильтр по сумме иска через `lawsuits_threshold_rub`.

Любая внешняя проверка может вернуть ошибку (CAPTCHA, 5xx, timeout) — она
попадёт в `errors[]` и не сорвёт остальные проверки.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

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

## Documentation

## What atomno-labs/mcp-fns-check MCP server does

The atomno-labs/mcp-fns-check MCP server provides Russian counterparty due diligence through MCP-compatible clients. It accepts a taxpayer identification number (INN) or a primary state registration number (OGRN/OGRNIP), validates the identifier format by length and check digit, and retrieves information from public Russian registries.

The main `check_contractor` tool combines company identification, legal status, registry data, and risk findings into one report. Its output can include the legal name, address, current director, primary OKVED activity, registration identifiers, source status, risk level, errors, and recommendations. The reported verdict distinguishes cases such as proceeding, manual review, high risk, or a defunct counterparty.

## How it works

The server can query EGRUL/EGRIP through `egrul.nalog.ru`, bankruptcy information from EFRSB, Federal Tax Service data, the FSSP enforcement database, and arbitration records from KAD. It also uses local registry databases for mass addresses, mass directors, and disqualified individuals when those datasets have been loaded.

Available tools include `ping`, `check_contractor`, `check_inn`, `check_ogrn`, `get_legal_status`, `get_okveds`, `get_directors_history`, and `check_for_red_flags`. The identifier-specific tools provide narrower results, while the aggregate tools are intended for a broader screening workflow. `get_directors_history` currently returns the current director from EGRUL at the documented S3 stage; full dated history depends on a later Open Data implementation.

Most external checks are best effort. An unavailable secondary source is recorded in the result rather than stopping the entire report. EGRUL is the blocking source for the main contractor check, so its unavailability prevents completion of that check.

## Setup and configuration

Install the package with:

```bash
pip install atomno-mcp-fns-check
```

The executable starts a stdio MCP server by default:

```bash
atomno-mcp-fns-check
```

It can also be configured for HTTP, SSE, or streamable HTTP transports with the documented transport, host, and port flags. The server is described as compatible with Claude Desktop, Cursor, Cline, Claude Code, and other MCP clients. Client configuration uses the `atomno-mcp-fns-check` executable as the command.

Configuration is supplied through environment variables. Cache location, registry database location, cache lifetime, HTTP timeout, HTTP user agent, and log level can be customized with `MCP_FNS_CACHE_DB`, `MCP_FNS_REGISTRIES_DB`, `MCP_FNS_CACHE_TTL_HOURS`, `MCP_FNS_HTTP_TIMEOUT`, `MCP_FNS_USER_AGENT`, and `MCP_FNS_LOG_LEVEL`.

## Tools and capabilities

- Check a counterparty using an INN, OGRN, or OGRNIP.
- Retrieve a basic legal-entity or individual-entrepreneur card.
- Determine statuses such as active, liquidating, bankrupt, liquidated, reorganizing, or excluded as inactive.
- List primary and additional OKVED-2 codes with descriptions.
- Inspect the current director and available management history.
- Detect mass addresses, mass directors, disqualified directors, and bankruptcy records.
- Optionally inspect tax debt indicators, FSSP enforcement proceedings, and active arbitration cases filtered by claim amount.

## Limitations and notes

The atomno-labs/mcp-fns-check MCP server does not require credentials because its documented data sources are public. Public endpoints can still impose CAPTCHA, antibot checks, timeouts, or server errors. Such failures are returned in the report’s error data, and the overall result may require manual review.

The local FNS registries are not automatically populated with production data. Working checks for mass addresses, mass directors, and disqualified persons require loading the relevant open-data extracts with the separate ETL command described by the project. The included seed file is intended for tests and is not loaded into the working database.

The README states that a check for missing tax reporting is not available because it lacks a reliable public source. Results should therefore be treated as open-source due diligence rather than a complete legal or financial assessment.

_Full upstream README: https://allmcps.com/mcp/atomno-labs-mcp-fns-check/readme_