English Français العربية

KontragentPro

السجل الرسمي أخرى

Russian company data by INN: registry, financials, bankruptcy, inspections, sanctions

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package kontragentpro-mcp
Claude Code 
claude mcp add kontragentpro -e 'KONTRAGENTPRO_API_KEY=<your kontragentpro_api_key>' -- uvx kontragentpro-mcp==0.2.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "kontragentpro": {
            "command": "uvx",
            "args": [
                "kontragentpro-mcp==0.2.2"
            ],
            "env": {
                "KONTRAGENTPRO_API_KEY": "<your kontragentpro_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • KONTRAGENTPRO_API_KEY سري Optional API key from https://kontragentpro.ru/developers. Without it the anonymous free tier is used.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. KontragentPro MCP server
  2. Tools
  3. Install
  4. Claude Desktop
  5. Cursor
  6. Example
  7. Environment variables
  8. Data sources
  9. По-русски
  10. Лицензия / License

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

ToolWhat it does
search_companiesFilter legal entities by annual income (FNS open data), region, industry code, headcount, bankruptcy status
get_companyFull company card by INN in a single call
get_company_financialsMulti-year financial history from official tax filings
get_company_timelineEvent feed: bankruptcies, inspections, trademarks, official gazette
check_accountBalance, 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

VariableDefaultPurpose
KONTRAGENTPRO_API_KEY—Bearer key from your account (optional)
KONTRAGENTPRO_API_BASEhttps://kontragentpro.ru/api/v2API base URL
KONTRAGENTPRO_TIMEOUT30HTTP 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.

الأسئلة الشائعة

ما هو KontragentPro؟

Russian company data by INN: registry, financials, bankruptcy, inspections, sanctions

كيف أثبّت KontragentPro؟

يعمل على جهازك. في Claude Code: claude mcp add kontragentpro -e 'KONTRAGENTPRO_API_KEY=<your kontragentpro_api_key>' -- uvx kontragentpro-mcp==0.2.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج KontragentPro إلى مفتاح API؟

نعم. يتطلب KONTRAGENTPRO_API_KEY، وتضبطها في إعداداته.

هل KontragentPro مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون KontragentPro؟

ينشره kontragentpro. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.