Sber Mcp

io.github.theYahiaPublished by GitHub account theYahiav1.0.0Updated Oct 24, 2026

MCP server for Sberbank API — accounts, statements. Bearer token auth.

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

MCP server for the Sberbank business API that lets an assistant list accounts, read balances and statements, and create payments.

What you can do
List accounts and read balances for the client's accounts and a chosen account, with company details and saved counterparties available alongside them. Retrieve account statements for a period with transaction lists and pagination, and summarize transactions into counts, credits, debits and net total. Create payment orders idempotently by request ID and check the status of a payment by its ID.
When to use it
Useful when you want to check Sberbank business account balances, review or summarize statement activity, or draft and track payment orders from a chat assistant instead of the internet bank. Best suited to users who already have Sberbank business API access and credentials.
Requirements
Runs locally via npx (Node.js) over stdio, or as a Streamable HTTP server with a port. Needs Sberbank API credentials: either a bearer token (SBER_TOKEN or SBER_ACCESS_TOKEN) or OAuth client credentials (SBER_CLIENT_ID and SBER_CLIENT_SECRET). Optional mTLS certificate settings and base URL, OAuth URL, scope and timeout overrides. Network access to Sberbank hosts.
Before you install
Handles banking credentials and, if used, mTLS certificate files and passphrases; keep them out of shared configs. The create_payment tool initiates real payment orders, which move money, so review amounts and recipients before confirming. The README states the implementation has not been verified against the live Sberbank environment, so endpoint paths and parameters should be checked against your integration contract.

Installation

In SourceWeft

  1. Open Sber Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

MCP-сервер для бизнес-API Сбербанка — счета, выписки и платежи через ИИ

Если вы искали, как подключить СберБизнес API к нейросети, посмотреть баланс и выписку по расчётному счёту или собрать платёж не открывая интернет-банк — это оно. 8 инструментов: счета, баланс, выписки, платежи, контрагенты. Спрашиваете «сколько пришло на счёт за неделю» — получаете сумму и список поступлений.

[npm] [CI] [License: MIT] [smithery badge]

Часть серии WWmcp от @theYahia.

Быстрый старт

Claude Desktop

json
{  "mcpServers": {    "sber": {      "command": "npx",      "args": ["-y", "@theyahia/sber-mcp"],      "env": {        "SBER_TOKEN": "ваш-bearer-токен"      }    }  }}

Claude Code

bash
claude mcp add sber -e SBER_TOKEN=ваш-токен -- npx -y @theyahia/sber-mcp

VS Code / Cursor

json
{  "servers": {    "sber": {      "command": "npx",      "args": ["-y", "@theyahia/sber-mcp"],      "env": {        "SBER_TOKEN": "ваш-bearer-токен"      }    }  }}

Windsurf

json
{  "mcpServers": {    "sber": {      "command": "npx",      "args": ["-y", "@theyahia/sber-mcp"],      "env": {        "SBER_TOKEN": "ваш-bearer-токен"      }    }  }}

Streamable HTTP (удалённо / Docker)

bash
PORT=3000 npx -y @theyahia/sber-mcp --http

Эндпоинты:

  • POST /mcp — MCP Streamable HTTP транспорт
  • GET /health — проверка здоровья ({ "status": "ok", "tools": 8 })

Переменные окружения

Авторизация — либо прямой Bearer-токен, либо пара OAuth-кредов:

ПеременнаяОбязательнаОписание
SBER_TOKENодин изПрямой Bearer-токен API (синоним SBER_ACCESS_TOKEN)
SBER_CLIENT_ID + SBER_CLIENT_SECRETодин изOAuth client_credentials
SBER_BASE_URLнетAPI-хост (дефолт https://fintech.sberbank.ru:9443)
SBER_OAUTH_URLнетOAuth-эндпоинт (дефолт https://api.sberbank.ru:8443/prod/tokens/v2/oauth)
SBER_OAUTH_SCOPEнетSpace-separated scope (дефолт GET_STATEMENT_ACCOUNT PAY_DOC_RU GET_CLIENT_ACCOUNTS)
SBER_TIMEOUT_MSнетТаймаут запроса в мс (дефолт 30000)
SBER_PFX_PATH / SBER_PFX_PASSPHRASEнетmTLS: путь к .p12/.pfx и пароль
SBER_CERT_PATH / SBER_KEY_PATH / SBER_CA_PATHнетmTLS: отдельные PEM-файлы (альтернатива PFX)
PORTнетПорт HTTP-транспорта (дефолт 3000)

Инструменты (8)

Счета

ИнструментОписание
get_accountsСписок счетов клиента
get_balanceБаланс по счёту

Выписки

ИнструментОписание
get_statementВыписка по счёту за период (список транзакций, пагинация)
summarize_transactionsСводка: количество, поступления, списания, чистый итог

Платежи

ИнструментОписание
create_paymentСоздание платёжного поручения (идемпотентно по RqUID)
get_payment_statusСтатус платежа по ID

Контрагенты / Организация

ИнструментОписание
list_counterpartiesСписок сохранённых контрагентов
get_company_infoСведения об организации (реквизиты, ИНН, счета)

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.

Часть WWmcp · Telegram: @vhodvai

Source: README.md at commit d9b7d34

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts