MCP Fns Check

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:

pip install atomno-mcp-fns-check

The executable starts a stdio MCP server by default:

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.