ru-companies-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SBIS_LOGIN | No | Login for a paid SBS/Saby account to retrieve unmasked company contact details. Optional and experimental. | |
| HH_APP_TOKEN | No | Application token for hh.ru API to fetch company vacancies. Optional; without it the vacancies tool returns a search link. | |
| SBIS_PASSWORD | No | Password for the paid SBS/Saby account. Used only with SBIS_LOGIN and sent only to online.sbis.ru. | |
| SBIS_SESSION_ID | No | Existing SBS/Saby session identifier, used instead of SBIS_LOGIN and SBIS_PASSWORD. | |
| RU_COMPANIES_HOME | No | Directory used to store the company shortlist. | ~/.ru-companies-mcp |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Поиск российских компаний без браузера: каталог Saby (СБИС), отчётность ФНС, вакансии hh.ru. Обычный порядок: find_categories → search_companies (категория + регион) → company_card / company_financials / company_vacancies по ИНН → shortlist_add для понравившихся. Выручка в поиске — млн руб., в company_financials — тыс. руб. Список отсортирован по выручке.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| find_categoriesB | Отраслевые категории каталога Saby. query — часть названия, напр. «отход», «эколог», «очистк». |
| find_regionsA | Регионы РФ для фильтра поиска. query — название, код (77) или сокращение (мск, спб, мо). |
| search_companiesA | Найти компании в каталоге Saby, по убыванию выручки. category — название категории, её slug или id (см. find_categories); region — регион (см. find_regions); query — слова из названия, ИНН или город; min_revenue_mln — отсечь компании с выручкой ниже порога (млн руб.); page_size ≤ 40. |
| company_cardB | Карточка по ИНН: статус, ОКВЭД (все), адреса, директор, выручка, численность, телефоны/email. Без платного входа в СБИС контакты и численность приходят замаскированными (contacts_masked). |
| company_financialsB | Выручка, чистая прибыль и активы по годам из открытой отчётности ФНС (ГИР БО). |
| company_vacanciesB | Открытые вакансии компании на hh.ru (нужен HH_APP_TOKEN; без него — ссылка на поиск). |
| shortlist_addB | Добавить компанию в шорт-лист (или обновить заметку/статус). Данные подтягиваются из Saby. |
| shortlist_showC | Показать шорт-лист. |
| shortlist_removeC | Убрать компанию из шорт-листа. |
| shortlist_exportB | Сохранить шорт-лист в файл: fmt = csv (открывается в Excel) или md. |
| sbis_account_statusA | Проверить вход в платный аккаунт СБИС (если заданы SBIS_LOGIN/SBIS_PASSWORD). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 11 tools
Most tools target a distinct resource+action: category/region lookup helpers, company search, and card/financials/vacancies each cover a different data slice. There is minor overlap between search_companies, company_card, and company_financials (all surface revenue), but the granularity distinction (ranked list vs. full card vs. multi-year financials) is described clearly.
All names are snake_case and follow two clean patterns: verb_noun (find_categories, search_companies, shortlist_add) and noun-only resource names (company_card, company_financials, sbis_account_status). The mix of verb-prefixed and noun-only conventions is the only deviation, but it's predictable and readable.
Eleven tools is well within the ideal range and each earns its place: three lookup/discovery tools, three company-detail tools, four shortlist tools, and one account-status check. No obvious filler or redundancy.
The shortlist lifecycle is fully covered (add, remove, show, export), and company data spans search, card, financials, and vacancies. Minor gaps exist—no bulk clear/compare operation and no pagination beyond page_size—but agents can work around these.