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
| 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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7614d0cde0ee06a2db20e0d5adf85c75fcbcbf08e31fcc6f97735a4f7de3fb92
|
|
| MD5 |
5c2aefad1a781be6c7cc185b99ed3cdf
|
|
| BLAKE2b-256 |
09a9f513341c7f3e09ffa139409fd7653fa74516a6a5a9d288bd0c57e5dc535e
|
File details
Details for the file kontragentpro_mcp-0.2.1-py3-none-any.whl.
File metadata
- Download URL: kontragentpro_mcp-0.2.1-py3-none-any.whl
- Upload date:
- Size: 9.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ba2985b892a2cf27ddc18396d575e23a87e41888378a7e108919c38cd7678927
|
|
| MD5 |
0e85645e8e619ecb23dd9a8761b07ff7
|
|
| BLAKE2b-256 |
99744872d501899fcfab8648e0bfd2948d5a34ac23259951c1d1286492f108fc
|