# mcp-fns-check

An MCP server that lets your agent vet a Russian company by INN or OGRN: registry status, bankruptcy, tax debts, bailiff cases and court filings.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 15
- Author: atomno-mcp
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/atomno-mcp/mcp-fns-check
- Updated: 2026-09-04
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-fns-check

## What it does

Seven tools land in the agent's hands. The one you will reach for most is `check_contractor(identifier)`: hand it an INN (10 or 12 digits) or an OGRN (13 or 15) and it assembles one report with a verdict, ranging from `safe_to_proceed` down to `high_risk_do_not_proceed`, plus a list of next steps. The other six cover narrower ground: the company card from the registry, current legal status, OKVED codes decoded, the director and his history, and a separate pass over seven risk flags.

Everything is pulled from public sources: `egrul.nalog.ru` for the company registry, `bankrot.fedresurs.ru` for bankruptcy notices, the FNS debtam dataset, the disqualified-persons register on `service.nalog.ru`, the FSSP enforcement database and `kad.arbitr.ru` for commercial courts. Snapshots of mass-address and mass-director registers sit locally and load through the separate `atomno-mcp-fns-etl` script from FNS Open Data. No API keys are involved.

The company registry is the only hard dependency. When it is down, the call fails outright. The rest are queried best-effort: a CAPTCHA at FSSP, an antibot wall at KAD, any of it ends up in `risks.errors[]` instead of killing the response, though the verdict drops to `manual_review_required`. The package speaks stdio by default, and `--transport`, `--host` and `--port` switch it to network mode.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-fns-check -- uvx atomno-mcp-fns-check
```
uvx runs the command named after the package; if the README names another one, use uvx --from atomno-mcp-fns-check <command>

### Codex

**Platform CLI**
```bash
codex mcp add mcp-fns-check -- uvx atomno-mcp-fns-check
```
uvx runs the command named after the package; if the README names another one, use uvx --from atomno-mcp-fns-check <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-fns-check": {
            "command": "uvx",
            "args": [
                "atomno-mcp-fns-check"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from atomno-mcp-fns-check <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-fns-check": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "atomno-mcp-fns-check"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from atomno-mcp-fns-check <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp-fns-check uvx atomno-mcp-fns-check
```
uvx runs the command named after the package; if the README names another one, use uvx --from atomno-mcp-fns-check <command>

## When to use it
- vet a supplier by INN before signing and get a verdict with recommendations
- see whether a company is heading into liquidation or bankruptcy
- surface unpaid taxes and open enforcement cases
- catch a mass-registration address or a disqualified director
- pull an OKVED-decoded company card into the agent chat

## Example prompts
- Check the counterparty with INN `7707083893` and tell me if it is safe to sign
- Run `check_for_red_flags` on this company and list which flags fired
- Give me the legal status and OKVED codes for OGRN `1027700132195`

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md