Skip to main content
Glama
@theyahia/sber-mcp

@theyahia/sber-mcp

by theYahia

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

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

npm CI License: MIT

Часть серии 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-mcp

VS 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-кредов:

Переменная

Обязательна

Описание

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

Available Tools

8 tools
create_paymentA
DestructiveIdempotent

Создание платёжного поручения. Денежная операция: идемпотентна по RqUID (повтор с тем же ключом не создаёт дубль).

Inputs: amount (required), purpose (required), payee_name (required), payee_account (required), +3 more.

get_accountsA
Read-only

Список счетов клиента в Сбербанке.

Inputs: no named parameters.

get_balanceC
Read-only

Баланс по счёту.

Inputs: account_id (required).

get_company_infoA
Read-only

Сведения об организации-клиенте (реквизиты, ИНН, список счетов).

Inputs: no named parameters.

get_payment_statusC
Read-only

Статус платежа по ID.

Inputs: payment_id (required).

get_statementA
Read-only

Выписка по счёту за период (список транзакций). Поддерживает пагинацию.

Inputs: account_id (required), page, date_to, date_from.

list_counterpartiesB
Read-only

Список сохранённых контрагентов (получателей платежей).

Inputs: no named parameters.

summarize_transactionsB
Read-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

    B3.4/5.0

    Scored across 8 tools

    Disambiguation4/5

    Tools are mostly distinct, but get_accounts and get_company_info both provide account lists, causing slight ambiguity. Other tools have clear boundaries.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern using snake_case (e.g., get_balance, create_payment, list_counterparties). No deviations or mixed styles.

    Tool Count5/5

    8 tools is well-scoped for a banking MCP server, covering account info, transactions, payments, and counterparties without being excessive.

    Completeness4/5

    Core operations are covered, but missing features like transaction details, payment cancellation, and counterparty management limit full lifecycle coverage.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      MCP 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 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for bePaid payment gateway enabling payment operations including create, capture, void, refund, card tokenization, and subscriptions through natural language prompts.
      17 npm
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Unofficial MCP server for the Privat24 Business API that provides tools for account statements, balances, transactions, payment creation, and exchange-rate lookups.
      12
      3
      MIT