MCP server for Sberbank API — accounts, statements. Bearer token auth.
MCP server for the Sberbank API that exposes business-bank functions for accounts, statements, and payments via AI. It uses Bearer token authentication and is implemented with TypeScript. The project is published as @theyahia/sber-mcp and includes eight tools for working with business API resources.
🛠️ Key Features
Sberbank API access for business operations
Bearer token authentication
8 tools: accounts, balance, statements, payments, and counterparties
🚀 Use Cases
Retrieve account balances
View statements for settlement accounts
Build payment requests without using an internet bank interface
Ask for totals (e.g., amount received over a period) and get a list of incoming transfers
⚡ Developer Benefits
Model Context Protocol server implementation
Tool coverage for accounts, balance, statements, payments, and counterparties
TypeScript-based API integration
⚠️ Limitations
Supports Sberbank business API scope (accounts, statements, payments, counterparties)
MCP-сервер для бизнес-API Сбербанка — счета, выписки и платежи через ИИ
Если вы искали, как подключить СберБизнес API к нейросети, посмотреть баланс и выписку по расчётному счёту или собрать платёж не открывая интернет-банк — это оно. 8 инструментов: счета, баланс, выписки, платежи, контрагенты. Спрашиваете «сколько пришло на счёт за неделю» — получаете сумму и список поступлений.
Создание платёжного поручения (идемпотентно по RqUID)
get_payment_status
Статус платежа по ID
Контрагенты / Организация
Инструмент
Описание
list_counterparties
Список сохранённых контрагентов
get_company_info
Сведения об организации (реквизиты, ИНН, счета)
Demo-промпты
code
Покажи мои счета и баланс по рублёвому счёту
code
Сделай сводку транзакций по счёту 40702… за май: сколько пришло, сколько ушло, чистый итог
code
Создай платёжку на 150 000 ₽ контрагенту ООО «Ромашка», БИК 044525225, назначение «Оплата по договору №7», затем проверь статус
Архитектура
Авторизация: прямой Bearer-токен (SBER_TOKEN) или OAuth client_credentials
(SBER_CLIENT_ID/SBER_CLIENT_SECRET, Basic-auth + scope), при необходимости поверх mTLS.
Идемпотентность: каждая денежная операция несёт один стабильный x-Introspect-RqUID
(32 hex) + rq_uid в теле, который переиспользуется на всех ретраях — Сбер дедуплицирует
повтор и не создаёт второй платёж. Можно передать свой ключ.
Таймаут / ретраи: 30с (настраивается), 3 попытки на 429/5xx/таймаут/сетевой сбой с
экспоненциальной задержкой (1с, 2с, 4с). Refresh OAuth-токена защищён от конкуренции.
Транспорт: stdio (по умолчанию) или Streamable HTTP (--http / PORT).
Соответствие API
Боевой СберБизнес API закрыт за mTLS и заявкой в банк, поэтому реализация не проверена
против живого окружения. Дефолты хостов, путей и scope соответствуют официальной документации
(developers.sber.ru/docs/ru/sber-api,
developers.sber.ru) на дату ресёрча, но точные пути
эндпоинтов и имена параметров сверяйте с вашим интеграционным договором — у Сбера сосуществуют
поколения API (v2 direct / v3 partners). Все хосты переопределяются через SBER_BASE_URL,
SBER_OAUTH_URL, SBER_OAUTH_SCOPE. Пометки VERIFY в исходниках указывают на места,
требующие сверки.
