Skip to main content

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

Tool What it does
search_companies Filter legal entities by revenue, region, industry code, headcount, bankruptcy status
get_company Full company card by INN in a single call
get_company_financials Multi-year financial history from official tax filings
get_company_timeline Event feed: bankruptcies, inspections, trademarks, official gazette
check_account Balance, 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

Variable Default Purpose
KONTRAGENTPRO_API_KEY Bearer key from your account (optional)
KONTRAGENTPRO_API_BASE https://kontragentpro.ru/api/v2 API base URL
KONTRAGENTPRO_TIMEOUT 30 HTTP 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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kontragentpro_mcp-0.2.2.tar.gz (9.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kontragentpro_mcp-0.2.2-py3-none-any.whl (10.7 kB view details)

Uploaded Python 3

File details

Details for the file kontragentpro_mcp-0.2.2.tar.gz.

File metadata

  • Download URL: kontragentpro_mcp-0.2.2.tar.gz
  • Upload date:
  • Size: 9.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.3

File hashes

Hashes for kontragentpro_mcp-0.2.2.tar.gz
Algorithm Hash digest
SHA256 c56a16bfec7d9d53d842fd4dd168c79bcdccd051cdae16803bff4d27708cf37e
MD5 a552ed2aaae405d81a2544012d9c8d02
BLAKE2b-256 d6f782954d020385ee82b6f3035c17d8e087bfe027285d6fce055cc236edee9c

See more details on using hashes here.

File details

Details for the file kontragentpro_mcp-0.2.2-py3-none-any.whl.

File metadata

File hashes

Hashes for kontragentpro_mcp-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 bda9479e3fc79e14bcafb5a802d41c2e25c3f31fe41323660c143c272f43f7b4
MD5 ead876baa59e60f12b39c816ad218177
BLAKE2b-256 b423b3dcc414191c6163b1123bd4e9e8efc9137ac89242da5cd48d65dd6f1e16

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.2.2 This release

2 files

0.2.1

2 files

0.2.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page