Metadata-Version: 2.5
Name: kontragentpro-mcp
Version: 0.2.0
Summary: MCP-сервер KontragentPro — проверка контрагентов РФ (ЕГРЮЛ, ФНС, ЕФРСБ, санкции) прямо из Claude Desktop, Cursor и любого MCP-клиента.
Project-URL: Homepage, https://kontragentpro.ru
Project-URL: Documentation, https://kontragentpro.ru/api/v2/docs
Project-URL: API keys, https://kontragentpro.ru/developers
Author-email: KontragentPro <support@kontragentpro.ru>
License: MIT
Keywords: counterparty,due-diligence,egrul,kontragentpro,mcp,russia
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.2.0
Description-Content-Type: text/markdown

# KontragentPro MCP server

Проверка российских контрагентов по ИНН прямо в **Claude Desktop, Cursor** и
любом MCP-совместимом клиенте. Тонкая обёртка над публичным
[API KontragentPro v2](https://kontragentpro.ru/api/v2/docs) — данные из
открытых реестров: ЕГРЮЛ, ФНС (ГИР БО), ЕФРСБ (банкротства), Генпрокуратура
(проверки), Роспатент, реестры санкций и иноагентов.

## Инструменты

| Инструмент | Что делает |
|---|---|
| `search_companies` | Подбор списка ЮЛ по фильтрам: выручка, регион, ОКВЭД, штат, статус банкротства |
| `get_company` | Сводная карточка компании одним запросом по ИНН |
| `get_company_financials` | Многолетняя финансовая динамика (ГИР БО ФНС) |
| `get_company_timeline` | Лента событий: банкротства, проверки, иноагенты, ТЗ, Вестник |
| `check_account` | Баланс депозита, план, дневная квота (нужен ключ) |

## Установка

Через [`uv`](https://docs.astral.sh/uv/) (запуск без установки):

```bash
uvx kontragentpro-mcp
```

или через pip:

```bash
pip install kontragentpro-mcp
kontragentpro-mcp
```

## Подключение к Claude Desktop

Откройте `Settings → Developer → Edit Config` и добавьте в `mcpServers`:

```json
{
  "mcpServers": {
    "kontragentpro": {
      "command": "uvx",
      "args": ["kontragentpro-mcp"],
      "env": {
        "KONTRAGENTPRO_API_KEY": "ваш_ключ"
      }
    }
  }
}
```

Перезапустите Claude Desktop — инструменты появятся в списке.

## Подключение к Cursor

`Settings → MCP → Add new server`, тип **command**:

```json
{
  "command": "uvx",
  "args": ["kontragentpro-mcp"],
  "env": { "KONTRAGENTPRO_API_KEY": "ваш_ключ" }
}
```

## API-ключ

Ключ **необязателен**: без него сервер работает в анонимном free-tier
(пониженный rate-limit) — можно попробовать сразу. Для стабильной работы,
повышенных лимитов и `check_account` получите ключ в личном кабинете:
**https://kontragentpro.ru/developers**

## Переменные окружения

| Переменная | По умолчанию | Назначение |
|---|---|---|
| `KONTRAGENTPRO_API_KEY` | — | Bearer-ключ из ЛК (опционально) |
| `KONTRAGENTPRO_API_BASE` | `https://kontragentpro.ru/api/v2` | Базовый URL API |
| `KONTRAGENTPRO_TIMEOUT` | `30` | Таймаут HTTP, сек |

## Пример

> «Проверь контрагента с ИНН 7736207543 и покажи динамику выручки за 5 лет»

Клиент вызовет `get_company` и `get_company_financials`, вернёт карточку и
финансовый ряд.

## Лицензия

MIT. Данные предоставляются «как есть» из открытых источников; сервис не
является заменой официальной выписки.
