{
  "markdown": "<!-- mcp-name: io.github.kontragentpro/kontragentpro-mcp -->\n\n# KontragentPro MCP server\n\n[![PyPI](https://img.shields.io/pypi/v/kontragentpro-mcp.svg)](https://pypi.org/project/kontragentpro-mcp/)\n[![Python](https://img.shields.io/pypi/pyversions/kontragentpro-mcp.svg)](https://pypi.org/project/kontragentpro-mcp/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\nLook up Russian companies by INN (tax ID) directly from **Claude Desktop, Cursor**\nand any MCP-compatible client. A thin wrapper over the public\n[KontragentPro API v2](https://kontragentpro.ru/api/v2/docs), serving data from\nRussian open registries: EGRUL (company registry), Federal Tax Service financial\nstatements, bankruptcy register, state inspections, trademarks, sanctions and\nforeign-agent lists.\n\n**Works without an API key** — anonymous free tier is enabled by default, so you\ncan try it in under a minute.\n\n*Русское описание — [ниже](#по-русски).*\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `search_companies` | Filter legal entities by annual income (FNS open data), region, industry code, headcount, bankruptcy status |\n| `get_company` | Full company card by INN in a single call |\n| `get_company_financials` | Multi-year financial history from official tax filings |\n| `get_company_timeline` | Event feed: bankruptcies, inspections, trademarks, official gazette |\n| `check_account` | Balance, plan and daily quota (requires API key) |\n\n## Install\n\nRun without installing, via [`uv`](https://docs.astral.sh/uv/):\n\n```bash\nuvx kontragentpro-mcp\n```\n\nOr with pip:\n\n```bash\npip install kontragentpro-mcp\nkontragentpro-mcp\n```\n\n## Claude Desktop\n\nOpen `Settings → Developer → Edit Config` and add to `mcpServers`:\n\n```json\n{\n  \"mcpServers\": {\n    \"kontragentpro\": {\n      \"command\": \"uvx\",\n      \"args\": [\"kontragentpro-mcp\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop — the tools will appear in the list. To raise rate limits,\nadd `\"env\": {\"KONTRAGENTPRO_API_KEY\": \"your_key\"}`.\n\n## Cursor\n\n`Settings → MCP → Add new server`, type **command**:\n\n```json\n{\n  \"command\": \"uvx\",\n  \"args\": [\"kontragentpro-mcp\"]\n}\n```\n\n## Example\n\n> \"Check the company with INN 7736207543 and show its revenue over the last 5 years\"\n\nThe client calls `get_company` and `get_company_financials`, returning the company\ncard and the financial series.\n\n## Environment variables\n\n| Variable | Default | Purpose |\n|---|---|---|\n| `KONTRAGENTPRO_API_KEY` | — | Bearer key from your account (optional) |\n| `KONTRAGENTPRO_API_BASE` | `https://kontragentpro.ru/api/v2` | API base URL |\n| `KONTRAGENTPRO_TIMEOUT` | `30` | HTTP timeout, seconds |\n\nGet a free key at **https://kontragentpro.ru/developers**.\n\n## Data sources\n\nAll data comes from official Russian open registries — EGRUL/EGRIP, the Federal\nTax Service (financial statements, tax regimes), the federal bankruptcy register,\nthe Prosecutor General's inspection registry, Rospatent trademarks, and public\nsanctions lists. Each block on a company card carries its source and retrieval date.\n\n---\n\n<a name=\"по-русски\"></a>\n\n## По-русски\n\nПроверка российских контрагентов по ИНН прямо в **Claude Desktop, Cursor** и любом\nMCP-совместимом клиенте. Тонкая обёртка над публичным\n[API KontragentPro v2](https://kontragentpro.ru/api/v2/docs) — данные из открытых\nреестров: ЕГРЮЛ, ФНС (ГИР БО и открытые данные), ЕФРСБ (банкротства), Генпрокуратура (проверки),\nРоспатент, реестры санкций и иноагентов.\n\n**Ключ необязателен:** без него сервер работает в анонимном free-tier\nс пониженным лимитом запросов — попробовать можно сразу. Ключ для повышенных\nлимитов и `check_account` выдаётся в личном кабинете:\n**https://kontragentpro.ru/developers**\n\n### Инструменты\n\n| Инструмент | Что делает |\n|---|---|\n| `search_companies` | Подбор списка ЮЛ по фильтрам: годовой доход (открытые данные ФНС), регион, ОКВЭД, штат, статус банкротства |\n| `get_company` | Сводная карточка компании одним запросом по ИНН |\n| `get_company_financials` | Многолетняя динамика из ГИР БО ФНС; при её отсутствии — годовой снимок открытых данных ФНС |\n| `get_company_timeline` | Лента событий: банкротства, проверки, иноагенты, ТЗ, Вестник |\n| `check_account` | Баланс депозита, план, дневная квота (нужен ключ) |\n\n### Установка\n\n```bash\nuvx kontragentpro-mcp        # запуск без установки\npip install kontragentpro-mcp # либо через pip\n```\n\n### Пример\n\n> «Проверь контрагента с ИНН 7736207543 и покажи динамику выручки за 5 лет»\n\nКлиент вызовет `get_company` и `get_company_financials`, вернёт карточку\nи финансовый ряд.\n\n## Лицензия / License\n\nMIT. Данные предоставляются «как есть» из открытых источников; сервис не является\nзаменой официальной выписки.\n\nMIT. Data is provided as-is from public sources and is not a substitute for an\nofficial registry extract.\n",
  "bytes": 4760,
  "sha": "21c53b9706e8d966ee438af7cb34e7da7c02755a0346fd85e7cf40839956bbfd",
  "repo_slug": "kontragentpro/kontragentpro-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_kontragentpro_kontragentpro_mc_e84f2538/readme"
}