@theyahia/sber-mcp
This server is an MCP bridge to SberBank's business API, letting AI assistants interact with accounts, statements, payments, and company data.
List accounts: Get the client's SberBank accounts (
get_accounts).Check balance: View the balance for a specific account (
get_balance).Get statements: Fetch account transactions for a date range, with pagination (
get_statement).Summarize transactions: Get totals for inflows, outflows, count, and net result over a period (
summarize_transactions).Create payments: Issue a payment order with payer/payee details, amount, currency, and purpose; idempotent via RqUID to avoid duplicates (
create_payment).Check payment status: Look up the status of a payment by its ID (
get_payment_status).List counterparties: Retrieve saved payees/recipients (
list_counterparties).Get company info: View organization details, requisites, INN, and linked accounts (
get_company_info).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@theyahia/sber-mcp Покажи мои счета и баланс"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP-сервер для бизнес-API Сбербанка — счета, выписки и платежи через ИИ
Если вы искали, как подключить СберБизнес API к нейросети, посмотреть баланс и выписку по расчётному счёту или собрать платёж не открывая интернет-банк — это оно. 8 инструментов: счета, баланс, выписки, платежи, контрагенты. Спрашиваете «сколько пришло на счёт за неделю» — получаете сумму и список поступлений.
Часть серии WWmcp от @theYahia.
Быстрый старт
Claude Desktop
{
"mcpServers": {
"sber": {
"command": "npx",
"args": ["-y", "@theyahia/sber-mcp"],
"env": {
"SBER_TOKEN": "ваш-bearer-токен"
}
}
}
}Claude Code
claude mcp add sber -e SBER_TOKEN=ваш-токен -- npx -y @theyahia/sber-mcpVS Code / Cursor
{
"servers": {
"sber": {
"command": "npx",
"args": ["-y", "@theyahia/sber-mcp"],
"env": {
"SBER_TOKEN": "ваш-bearer-токен"
}
}
}
}Windsurf
{
"mcpServers": {
"sber": {
"command": "npx",
"args": ["-y", "@theyahia/sber-mcp"],
"env": {
"SBER_TOKEN": "ваш-bearer-токен"
}
}
}
}Streamable HTTP (удалённо / Docker)
PORT=3000 npx -y @theyahia/sber-mcp --httpЭндпоинты:
POST /mcp— MCP Streamable HTTP транспортGET /health— проверка здоровья ({ "status": "ok", "tools": 8 })
Related MCP server: bepaid-mcp
Переменные окружения
Авторизация — либо прямой Bearer-токен, либо пара OAuth-кредов:
Переменная | Обязательна | Описание |
| один из | Прямой Bearer-токен API (синоним |
| один из | OAuth client_credentials |
| нет | API-хост (дефолт |
| нет | OAuth-эндпоинт (дефолт |
| нет | Space-separated scope (дефолт |
| нет | Таймаут запроса в мс (дефолт 30000) |
| нет | mTLS: путь к |
| нет | mTLS: отдельные PEM-файлы (альтернатива PFX) |
| нет | Порт HTTP-транспорта (дефолт 3000) |
Инструменты (8)
Счета
Инструмент | Описание |
| Список счетов клиента |
| Баланс по счёту |
Выписки
Инструмент | Описание |
| Выписка по счёту за период (список транзакций, пагинация) |
| Сводка: количество, поступления, списания, чистый итог |
Платежи
Инструмент | Описание |
| Создание платёжного поручения (идемпотентно по RqUID) |
| Статус платежа по ID |
Контрагенты / Организация
Инструмент | Описание |
| Список сохранённых контрагентов |
| Сведения об организации (реквизиты, ИНН, счета) |
Demo-промпты
Покажи мои счета и баланс по рублёвому счётуСделай сводку транзакций по счёту 40702… за май: сколько пришло, сколько ушло, чистый итогСоздай платёжку на 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 в исходниках указывают на места,
требующие сверки.
Лицензия
MIT — часть серии WWmcp.
Available Tools
8 toolscreate_paymentADestructiveIdempotent
Создание платёжного поручения. Денежная операция: идемпотентна по RqUID (повтор с тем же ключом не создаёт дубль).
Inputs: amount (required), purpose (required), payee_name (required), payee_account (required), +3 more.
get_accountsARead-only
Список счетов клиента в Сбербанке.
Inputs: no named parameters.
get_balanceCRead-only
Баланс по счёту.
Inputs: account_id (required).
get_company_infoARead-only
Сведения об организации-клиенте (реквизиты, ИНН, список счетов).
Inputs: no named parameters.
get_payment_statusCRead-only
Статус платежа по ID.
Inputs: payment_id (required).
get_statementARead-only
Выписка по счёту за период (список транзакций). Поддерживает пагинацию.
Inputs: account_id (required), page, date_to, date_from.
list_counterpartiesBRead-only
Список сохранённых контрагентов (получателей платежей).
Inputs: no named parameters.
summarize_transactionsBRead-only
Сводка по выписке: количество, суммы поступлений/списаний, чистый итог за период.
Inputs: account_id (required), date_to, date_from.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Tools are mostly distinct, but get_accounts and get_company_info both provide account lists, causing slight ambiguity. Other tools have clear boundaries.
All tools follow a consistent verb_noun pattern using snake_case (e.g., get_balance, create_payment, list_counterparties). No deviations or mixed styles.
8 tools is well-scoped for a banking MCP server, covering account info, transactions, payments, and counterparties without being excessive.
Core operations are covered, but missing features like transaction details, payment cancellation, and counterparty management limit full lifecycle coverage.
Maintenance
Related MCP Connectors
MCP server for Modern Treasury — payment orders, transactions, counterparties and ledgers.
MCP server for Codat — companies, connections, invoices, bills and financial statements.
Demo banking MCP server: accounts, transactions and payments. OAuth 2.1 with DPoP.
MCP server for Mekari Jurnal — company accounting, sales, purchases and customer/vendor creation.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceMCP server for T-Kassa (T-Bank/Tinkoff) payment API. Provides 16 tools for payments, refunds, recurring charges, customer management, saved cards, SBP, receipts, and T-Invest portfolio.57 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server for bePaid payment gateway enabling payment operations including create, capture, void, refund, card tokenization, and subscriptions through natural language prompts.17 npmMIT
- AlicenseBqualityDmaintenanceUnofficial MCP server for the Privat24 Business API that provides tools for account statements, balances, transactions, payment creation, and exchange-rate lookups.123MIT
- AlicenseAqualityDmaintenanceMCP server for interacting with Tochka Bank API, enabling balance checks, payments, invoices, and other banking operations through Claude.44MIT