kontragentpro-mcp
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 |
| Filter legal entities by annual income (FNS open data), region, industry code, headcount, bankruptcy status |
| Full company card by INN in a single call |
| Multi-year financial history from official tax filings |
| Event feed: bankruptcies, inspections, trademarks, official gazette |
| Balance, plan and daily quota (requires API key) |
Related MCP server: rekvizit-mcp-
Install
Run without installing, via uv:
uvx kontragentpro-mcpOr with pip:
pip install kontragentpro-mcp
kontragentpro-mcpClaude 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 |
| — | Bearer key from your account (optional) |
|
| API base URL |
|
| 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
Инструменты
Инструмент | Что делает |
| Подбор списка ЮЛ по фильтрам: годовой доход (открытые данные ФНС), регион, ОКВЭД, штат, статус банкротства |
| Сводная карточка компании одним запросом по ИНН |
| Многолетняя динамика из ГИР БО ФНС; при её отсутствии — годовой снимок открытых данных ФНС |
| Лента событий: банкротства, проверки, иноагенты, ТЗ, Вестник |
| Баланс депозита, план, дневная квота (нужен ключ) |
Установка
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.
Available Tools
5 toolscheck_accountA
Состояние API-счёта по текущему ключу: баланс депозита, тарифный план, дневная квота и её использование, список ключей. Требует KONTRAGENTPRO_API_KEY.
Inputs: no named parameters.
get_companyA
Сводная карточка компании одним запросом по ИНН: идентичность (название, ОГРН, адрес), финансы, налоговый режим, риск-флаги (банкротство, санкции, иноагент), товарные знаки и связи. Поле completeness показывает, какие блоки заполнены. Всегда 200 для валидного ИНН.
Inputs: inn (required).
get_company_financialsA
Многолетняя финансовая динамика компании по ИНН (выручка, прибыль, активы, коэффициенты) из ГИР БО ФНС плюс годовой снимок. Для новых компаний многолетний ряд может быть пуст — тогда возвращается годовой снимок и предупреждение (warnings).
Inputs: inn (required), year_to, year_from.
get_company_timelineA
Лента событий компании по датам: банкротные процедуры (ЕФРСБ), включение/ исключение из реестра иноагентов (Минюст), проверки (ЕРКНМ Генпрокуратуры), публикации в Вестнике госрегистрации, регистрации товарных знаков (Роспатент). События отсортированы от новых к старым.
Inputs: inn (required).
search_companiesA
Подобрать список российских юрлиц по фильтрам (доходы, регион, ОКВЭД, штат, статус банкротства). Возвращает items[] с ИНН, названием, финансовыми показателями и флагами риска. Для деталей по одному ИНН зовите get_company.
Inputs: limit, okved, offset, status, +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Every tool targets a distinct purpose: searching, retrieving a company summary, detailed financials, event timeline, or checking account status. Overlap between get_company and get_company_financials is minimal and clearly separated by summary vs. multi-year dynamics.
All tools follow a consistent verb_noun snake_case pattern: search_companies, check_account, get_company, get_company_financials, get_company_timeline. The shared get_company_ prefix for company-specific detail views makes the API predictable.
Five tools is well-scoped for a business intelligence API: search, general company card, financials, event timeline, and account management. No tool is redundant or missing at this abstraction level.
The toolset covers the core lifecycle of company investigation: finding candidates via search, retrieving a full company card, diving into financial history, exploring event timelines, and managing API access. No obvious dead ends or required missing operations.
Maintenance
Related MCP Connectors
Russian company lookup (EGRUL/INN), Cyrillic search, RU page to Markdown. Pay per call in USDC.
RU INN/OGRN, banks, geo, WHOIS. Agent self-registers via register_agent. 20 free/day.
Russian docs for AI agents: invoices/acts PDF, document parsing, INN checks, medical ad checks
CompanyLens is a remote MCP server giving AI agents instant access to official company registry data across 19 jurisdictions in Europe, the Americas, and Asia-Pacific. Eighteen read-only tools let you search companies and people, look up officers and beneficial owners, map corporate networks through shared directors, screen names against the UK disqualified directors register, find every company at a registered address, and pull filing history — all from a single connector. Visit our website: https://companylens.io
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to search and retrieve data about Russian companies, entrepreneurs, and individuals via the Checko.ru API, including financial reports, legal cases, and bankruptcy information.1223 PyPI13MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to validate Russian business requisites (INN, OGRN, bank accounts) via checksums, extract them from text, and retrieve counterparty details by INN using DaData.5MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to perform counterparty due-diligence by Russian INN, aggregating open registries (EGRUL, FSSP, courts, bankruptcies, finances) into a risk traffic light with source-backed signals, sanctions screening, affiliate graph, and fragmentation indicators via read-only MCP tools.8Apache 2.0
- AlicenseAqualityBmaintenanceRussian business data with no API key: company check by INN/OGRN in FNS EGRUL/EGRIP, Bank of Russia exchange rates and key rate, late-payment interest, production calendar with business-day math, and bank details by BIK.10MIT