Skip to main content
Glama

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 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)

Related MCP server: rekvizit-mcp-

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.

Available Tools

5 tools
check_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

    A4.2/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      12
      23 PyPI
      13
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      5
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      8
      Apache 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Russian 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.
      10
      MIT