KontragentPro
Russian company data by INN: registry, financials, bankruptcy, inspections, sanctions
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
kontragentpro-mcpclaude mcp add kontragentpro -e 'KONTRAGENTPRO_API_KEY=<your kontragentpro_api_key>' -- uvx kontragentpro-mcp==0.2.2
{
"mcpServers": {
"kontragentpro": {
"command": "uvx",
"args": [
"kontragentpro-mcp==0.2.2"
],
"env": {
"KONTRAGENTPRO_API_KEY": "<your kontragentpro_api_key>"
}
}
}
}
Variables d'environnement
KONTRAGENTPRO_API_KEYsecret Optional API key from https://kontragentpro.ru/developers. Without it the anonymous free tier is used.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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 annual income (FNS open data), 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.
Questions fréquentes
Qu'est-ce que KontragentPro ?
Russian company data by INN: registry, financials, bankruptcy, inspections, sanctions
Comment installer KontragentPro ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add kontragentpro -e 'KONTRAGENTPRO_API_KEY=<your kontragentpro_api_key>' -- uvx kontragentpro-mcp==0.2.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour KontragentPro ?
Oui. Il attend KONTRAGENTPRO_API_KEY, à renseigner dans sa configuration.
KontragentPro est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient KontragentPro ?
Il est publié par kontragentpro. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.