English Français العربية

KontragentPro

Official registry Other

Russian company data by INN: registry, financials, bankruptcy, inspections, sanctions

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package kontragentpro-mcp
Claude Code 
claude mcp add kontragentpro -e 'KONTRAGENTPRO_API_KEY=<your kontragentpro_api_key>' -- uvx kontragentpro-mcp==0.2.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "kontragentpro": {
            "command": "uvx",
            "args": [
                "kontragentpro-mcp==0.2.2"
            ],
            "env": {
                "KONTRAGENTPRO_API_KEY": "<your kontragentpro_api_key>"
            }
        }
    }
}

Environment variables

  • KONTRAGENTPRO_API_KEY secret Optional API key from https://kontragentpro.ru/developers. Without it the anonymous free tier is used.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. KontragentPro MCP server
  2. Tools
  3. Install
  4. Claude Desktop
  5. Cursor
  6. Example
  7. Environment variables
  8. Data sources
  9. По-русски
  10. Лицензия / License

KontragentPro MCP server

Look up Russian companies by INN (tax ID) directly from Claude Desktop, Cursor and any MCP-compatible client. A thin wrapper over the public KontragentPro API v2, serving data from Russian open registries: EGRUL (company registry), Federal Tax Service financial statements, bankruptcy register, state inspections, trademarks, sanctions and foreign-agent lists.

Works without an API key — anonymous free tier is enabled by default, so you can try it in under a minute.

Русское описание — ниже.

Tools

ToolWhat it does
search_companiesFilter legal entities by annual income (FNS open data), region, industry code, headcount, bankruptcy status
get_companyFull company card by INN in a single call
get_company_financialsMulti-year financial history from official tax filings
get_company_timelineEvent feed: bankruptcies, inspections, trademarks, official gazette
check_accountBalance, plan and daily quota (requires API key)

Install

Run without installing, via uv:

uvx kontragentpro-mcp

Or with pip:

pip install kontragentpro-mcp
kontragentpro-mcp

Claude Desktop

Open Settings → Developer → Edit Config and add to mcpServers:

{
  "mcpServers": {
    "kontragentpro": {
      "command": "uvx",
      "args": ["kontragentpro-mcp"]
    }
  }
}

Restart Claude Desktop — the tools will appear in the list. To raise rate limits, add "env": {"KONTRAGENTPRO_API_KEY": "your_key"}.

Cursor

Settings → MCP → Add new server, type command:

{
  "command": "uvx",
  "args": ["kontragentpro-mcp"]
}

Example

"Check the company with INN 7736207543 and show its revenue over the last 5 years"

The client calls get_company and get_company_financials, returning the company card and the financial series.

Environment variables

VariableDefaultPurpose
KONTRAGENTPRO_API_KEY—Bearer key from your account (optional)
KONTRAGENTPRO_API_BASEhttps://kontragentpro.ru/api/v2API base URL
KONTRAGENTPRO_TIMEOUT30HTTP timeout, seconds

Get a free key at **https://kontragentpro.ru/developers**.

Data sources

All data comes from official Russian open registries — EGRUL/EGRIP, the Federal Tax Service (financial statements, tax regimes), the federal bankruptcy register, the Prosecutor General's inspection registry, Rospatent trademarks, and public sanctions lists. Each block on a company card carries its source and retrieval date.

По-русски

Проверка российских контрагентов по ИНН прямо в Claude Desktop, Cursor и любом MCP-совместимом клиенте. Тонкая обёртка над публичным API KontragentPro v2 — данные из открытых реестров: ЕГРЮЛ, ФНС (ГИР БО и открытые данные), ЕФРСБ (банкротства), Генпрокуратура (проверки), Роспатент, реестры санкций и иноагентов.

Ключ необязателен: без него сервер работает в анонимном free-tier с пониженным лимитом запросов — попробовать можно сразу. Ключ для повышенных лимитов и check_account выдаётся в личном кабинете: **https://kontragentpro.ru/developers**

Инструменты
ИнструментЧто делает
search_companiesПодбор списка ЮЛ по фильтрам: годовой доход (открытые данные ФНС), регион, ОКВЭД, штат, статус банкротства
get_companyСводная карточка компании одним запросом по ИНН
get_company_financialsМноголетняя динамика из ГИР БО ФНС; при её отсутствии — годовой снимок открытых данных ФНС
get_company_timelineЛента событий: банкротства, проверки, иноагенты, ТЗ, Вестник
check_accountБаланс депозита, план, дневная квота (нужен ключ)
Установка
uvx kontragentpro-mcp        # запуск без установки
pip install kontragentpro-mcp # либо через pip
Пример

«Проверь контрагента с ИНН 7736207543 и покажи динамику выручки за 5 лет»

Клиент вызовет get_company и get_company_financials, вернёт карточку и финансовый ряд.

Лицензия / License

MIT. Данные предоставляются «как есть» из открытых источников; сервис не является заменой официальной выписки.

MIT. Data is provided as-is from public sources and is not a substitute for an official registry extract.

Frequently asked questions

What is KontragentPro?

Russian company data by INN: registry, financials, bankruptcy, inspections, sanctions

How do I install KontragentPro?

It runs on your machine. In Claude Code: claude mcp add kontragentpro -e 'KONTRAGENTPRO_API_KEY=<your kontragentpro_api_key>' -- uvx kontragentpro-mcp==0.2.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does KontragentPro need an API key?

Yes. It expects KONTRAGENTPRO_API_KEY, which you set in its configuration.

Is KontragentPro open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains KontragentPro?

It is published by kontragentpro. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.