# ru-business-mcp — бизнес-данные России для ИИ-агентов

[![penmadebykisss/ru-business-mcp MCP server](https://glama.ai/mcp/servers/penmadebykisss/ru-business-mcp/badges/score.svg)](https://glama.ai/mcp/servers/penmadebykisss/ru-business-mcp)
[![CI](https://github.com/penmadebykisss/ru-business-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/penmadebykisss/ru-business-mcp/actions/workflows/ci.yml)

MCP-сервер, который даёт Claude, Cursor и другим ИИ-ассистентам официальные данные для работы с российским бизнесом —
**без регистрации и токенов**: проверка контрагента по ИНН в ЕГРЮЛ/ЕГРИП ФНС, курсы валют и ключевая ставка ЦБ РФ,
расчёт пеней по ст. 395 ГК, производственный календарь и сроки в рабочих днях, реквизиты банка по БИК.

Спросите ассистента: *«Проверь контрагента 7707083893 — можно ли с ним работать?»*, *«Сколько пеней набежало на долг
250 000 ₽ с 1 марта?»*, *«Пересчитай инвойс на 12 400 юаней по курсу ЦБ на дату отгрузки»*, *«Какой срок оплаты,
если 10 рабочих дней с 28 апреля?»* — и он сам вызовет нужные инструменты.

**В Битрикс24 — без настройки:** бесплатное приложение [«Бизнес-справочник РФ»](https://www.bitrix24.ru/apps/app/penmadebykisss.biznes_spravochnik_rf/)
в Битрикс24 Маркете подключает этот сервер к ИИ-ассистенту портала.

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

| Инструмент | Что делает | Источник |
|---|---|---|
| `company_check` | Организация или ИП по ИНН/ОГРН: название, КПП, дата регистрации и возраст, статус, руководитель, регион, недостоверность, ссылка на выписку PDF | ЕГРЮЛ/ЕГРИП ФНС |
| `validate_requisites` | Контрольные суммы ИНН, ОГРН/ОГРНИП, формат БИК, ключ расчётного счёта (офлайн) | — |
| `bank_by_bik` | Банк по БИК: название, корсчёт, адрес | справочник БИК ЦБ |
| `cbr_rates` | Официальные курсы валют на дату | ЦБ РФ |
| `cbr_rate_history` | Динамика курса за период: минимум, максимум, изменение | ЦБ РФ |
| `currency_convert` | Пересчёт суммы по курсу ЦБ на дату | ЦБ РФ |
| `cbr_key_rate` | Ключевая ставка: текущая и история изменений | ЦБ РФ |
| `late_payment_penalty` | Проценты по ст. 395 ГК или пени 1/300, 1/150 с учётом смены ставки | ЦБ РФ |
| `work_calendar` | Производственный календарь: рабочие дни, праздники, переносы, норма часов | isdayoff.ru |
| `work_days_calc` | Прибавить N рабочих дней к дате или посчитать рабочие дни между датами | isdayoff.ru |

## Установка

Нужен только [Node.js](https://nodejs.org) 18+ — сервер запускается прямо с GitHub через `npx`.

### Claude Desktop

`claude_desktop_config.json` (Настройки → Разработчик → Изменить конфиг):

```json
{
  "mcpServers": {
    "ru-business": {
      "command": "npx",
      "args": ["-y", "github:penmadebykisss/ru-business-mcp"]
    }
  }
}
```

### Claude Code

```bash
claude mcp add ru-business -- npx -y github:penmadebykisss/ru-business-mcp
```

### Cursor, Windsurf и другие клиенты

Любой клиент с поддержкой MCP по stdio: команда `npx`, аргументы `-y github:penmadebykisss/ru-business-mcp`.

### Удалённое подключение по ссылке — без установки

Сервер работает и в облаке по Streamable HTTP. Подойдёт для клиентов, которые подключают MCP по адресу:
Битрикс24 MCP Hub (агент Марта / BitrixGPT), Claude и ChatGPT (раздел «Коннекторы»), n8n, Cursor.

```
https://biz.144-31-16-235.sslip.io/mcp
```

Ключ не нужен — данные открытые; действует лимит 60 запросов в минуту. Свой экземпляр:

```bash
MCP_HTTP_PORT=8788 npx -y github:penmadebykisss/ru-business-mcp --http
```

Переменные: `MCP_HTTP_PORT` (порт), `MCP_HTTP_HOST` (по умолчанию `127.0.0.1` — наружу через HTTPS-прокси),
`RATE_PER_MIN` (лимит с одного IP), `MCP_API_KEYS` (ключи через запятую — тогда нужен заголовок
`Authorization: Bearer <ключ>`). Проверка: `GET /health`.

## Ограничения

- Поиск компаний по названию ФНС для внешних запросов не отдаёт — нужен ИНН или ОГРН.
- При частых запросах ФНС может попросить капчу; сервер кэширует ответы на час.
- Календарь на следующий год появляется после постановления Правительства о переносах выходных.
- Расчёт пеней — справочный и не заменяет юридическую консультацию.

## Смотрите также

[rf-marketplaces-mcp](https://github.com/penmadebykisss/rf-marketplaces-mcp) — аналитика товаров Wildberries для ИИ-агентов.

## Нужна настройка или доработка?

Подключу этот сервер под ключ: установка, настройка под ваши данные и процессы, доработка под нестандартные поля,
ежедневные сводки. Пишите в Telegram **[@penmadebykisss](https://t.me/penmadebykisss)** или оставьте заявку на
[penmadebykisss.github.io](https://penmadebykisss.github.io).

*Need help setting this up or a custom MCP server? Telegram [@penmadebykisss](https://t.me/penmadebykisss).*

## English

**ru-business-mcp** gives AI assistants official Russian business data with **no account or API token**: company
lookup by INN/OGRN in the Federal Tax Service registry (EGRUL/EGRIP), Bank of Russia exchange rates and key rate,
late-payment interest (Civil Code art. 395), the Russian production calendar and business-day math, and bank details by BIK.

```bash
npx -y github:penmadebykisss/ru-business-mcp
```

**Ready-made agent skill:** [Russian Company Check, CBR Rates & Business Calendar](https://www.agensi.io/skills/russian-company-check-cbr-rates-business-calendar) on Agensi — free SKILL.md with usage rules and configs for Claude Code, Claude Desktop, Cursor, VS Code, Windsurf and Codex.

**Bitrix24 Market app:** [Бизнес-справочник РФ](https://www.bitrix24.ru/apps/app/penmadebykisss.biznes_spravochnik_rf/) — free app that connects this server to the Bitrix24 AI assistant.

## Лицензия

MIT