KontragentPro

io.github.kontragentproPublished by GitHub account kontragentprov0.2.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Looks up Russian companies by INN tax ID, returning registry cards, multi-year financials, event timelines and filtered company searches.

What you can do
Search legal entities by income, region, industry code, headcount or bankruptcy status, and fetch a full company card by INN in one call. Retrieve multi-year financial history from official tax filings. Read an event feed covering bankruptcies, inspections, trademarks and official gazette notices. Check account balance, plan and daily quota when an API key is configured.
When to use it
Useful for due diligence on Russian counterparties, supplier or customer vetting, and quick checks of a company's finances and risk events from an MCP client such as Claude Desktop or Cursor.
Requirements
Runs locally as a Python package via uvx or pip, with network access to the KontragentPro API. An optional KONTRAGENTPRO_API_KEY raises rate limits and enables account checks; without it an anonymous free tier applies. Optional KONTRAGENTPRO_API_BASE and KONTRAGENTPRO_TIMEOUT settings exist.
Before you install
The API key is a bearer credential sent to a third-party service; keep it out of shared configs. Company queries and results pass through the KontragentPro API, and data comes from Russian public registries, so verify important findings against primary sources. The server is read-only and does not modify data.

Installation

In SourceWeft

  1. Open KontragentPro in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

KontragentPro MCP server

[PyPI] [Python] [License: MIT]

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:

bash
uvx kontragentpro-mcp

Or with pip:

bash
pip install kontragentpro-mcpkontragentpro-mcp

Claude Desktop

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

json
{  "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:

json
{  "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Баланс депозита, план, дневная квота (нужен ключ)

Установка

bash
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.

Source: README.md at commit 90ad961

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts