English Français العربية

Ru Business MCP

Community Developer tools

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 (Civil Code art. 395), production calendar with business-day math, and bank details by BIK.

Source code Documentation

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ru-business-mcp — бизнес-данные России для ИИ-агентов
  2. Инструменты
  3. Установка
  4. Ограничения
  5. Смотрите также
  6. Нужна настройка или доработка?
  7. English
  8. Лицензия

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

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

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

Инструменты

ИнструментЧто делаетИсточник
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 18+ — сервер запускается прямо с GitHub через npx.

Claude Desktop

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

{
  "mcpServers": {
    "ru-business": {
      "command": "npx",
      "args": ["-y", "github:penmadebykisss/ru-business-mcp"]
    }
  }
}
Claude Code
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 запросов в минуту. Свой экземпляр:

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 — аналитика товаров Wildberries для ИИ-агентов.

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

Подключу этот сервер под ключ: установка, настройка под ваши данные и процессы, доработка под нестандартные поля, ежедневные сводки. Пишите в Telegram @penmadebykisss или оставьте заявку на penmadebykisss.github.io.

Need help setting this up or a custom MCP server? Telegram @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.

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

Ready-made agent skill: 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.

Лицензия

MIT

Frequently asked questions

What is Ru Business MCP?

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 (Civil Code art. 395), production calendar with business-day math, and bank details by BIK.

How do I install Ru Business MCP?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is Ru Business MCP open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Ru Business MCP?

It is published by penmadebykisss. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.