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.1.tar.gz (8.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.1-py3-none-any.whl (9.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: kontragentpro_mcp-0.2.1.tar.gz
  • Upload date:
  • Size: 8.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.1.tar.gz
Algorithm Hash digest
SHA256 7614d0cde0ee06a2db20e0d5adf85c75fcbcbf08e31fcc6f97735a4f7de3fb92
MD5 5c2aefad1a781be6c7cc185b99ed3cdf
BLAKE2b-256 09a9f513341c7f3e09ffa139409fd7653fa74516a6a5a9d288bd0c57e5dc535e

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for kontragentpro_mcp-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ba2985b892a2cf27ddc18396d575e23a87e41888378a7e108919c38cd7678927
MD5 0e85645e8e619ecb23dd9a8761b07ff7
BLAKE2b-256 99744872d501899fcfab8648e0bfd2948d5a34ac23259951c1d1286492f108fc

See more details on using hashes here.

Release history Release notifications | RSS feed

0.2.2

2 files

This release

0.2.1 This release

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