T-Bank MCP

Unofficial MCP server and skills for a personal T-Bank account: accounts, transfers, bill pay, tickets and groceries

MCP serverHigh riskRussian stack

icyberdeveloper/tbank-mcp

Install

/plugin marketplace add icyberdeveloper/tbank-mcp
/plugin install tbank@tbank-mcp
/reload-plugins

Installs the server and all skills. The venv is created on first start.

This is third-party code. Review the repository files before installing.

What it does

Gives an agent 90 tools for the T-Bank mobile bank: accounts, cards, operations, documents, transfers and payment by requisites, grocery orders, cinema and concert tickets, trains, flights, hotels and investments. It ships with a set of skills entered through the tbank router skill. Password and PIN are typed into a local CLI and never reach the model, and payments are confirmed with an MCP elicitation button.

Who it is for. T-Bank customers who want to manage personal finances and purchases through Claude Code or another MCP agent.

Good fit when

  • Analyze spending by category and find unneeded subscriptions
  • Build a grocery cart from a recipe and place the order
  • Buy cinema, train or flight tickets in one conversation
  • Look up card requisites, limits or document expiry dates

Not a fit when

  • The account is corporate or not yours: it is meant for personal use of your own account
  • Your client lacks MCP elicitation and you need payments
  • Session tokens must not be stored on this machine

Example request

Show my spending by category for the last month and find subscriptions I could cancel

Limitations

Not affiliated with T-Bank; it talks to the bank app backend rather than a public API. Login needs an SMS code, so there is no unattended login. Payments work only in clients with MCP elicitation, such as Claude Code 2.1.76 and later; Claude Desktop is read-only. Grocery checkout needs Chromium via Playwright, about 150 MB. Tools and answers are in Russian.

How to disable. Remove the server with claude mcp remove tbank or uninstall the tbank plugin. Delete ~/.local/share/tbank-mcp/session.json manually so tokens do not stay on disk.

MCP

Transport
stdio
Authentication
API key
Environment variables
Environment variables
TBANK_CONFIRM_ABOVE
Ruble threshold from which payments require confirmation, default 0
TBANK_SESSION
Session file path instead of ~/.local/share/tbank-mcp/session.json
TBANK_PASSWORD
secret
Password for the login CLI in scripts and CI; never read by the server or the model
TBANK_TRACE
0 disables the calls.jsonl call log
TBANK_EXTRA_CA
Extra root certificates for a root rotation

Security check

  • Operates a real bank account and can transfer money and pay for purchases
  • Stores bank session tokens on disk
  • Unofficial client for the bank app, not affiliated with T-Bank
  • May download Chromium for checkout

README in short

T-Bank MCP provides 90 tools and 11 skills for a personal T-Bank account. It installs as a Claude Code plugin, from PyPI or from source, with configs for Cursor, Cherry Studio and Goose. The README details secure login, pinned root certificates, redacted diagnostic logs and payment confirmation via elicitation. The project is not affiliated with the bank and is intended for personal use.

SKILL.md

---
name: tbank
description: |
  Точка входа в T-Bank MCP: что банк умеет через агента и каким тулом это делать.
  Используй когда пользователь говорит про Т-Банк, банк, свои счета, карты, деньги,
  финансы, поезд, самолёт, рейс, авиабилет, отель, маркетплейс — или спрашивает,
  что тут вообще можно. Отсюда уходи в узкий скил, если задача попадает в него; если нет —
  здесь названы тулы для остального.
---

# T-Bank MCP — с чего начать

MCP работает с **настоящим банковским счётом пользователя**. Читающие тулы
безопасны, пишущие двигают реальные деньги. Сессия обновляется сама — вручную
`refresh_session` вызывать не нужно, пока тул не вернул `SESSION EXPIRED`.

## Куда идти за задачей

| Задача | Скил |
|---|---|
| Заказать продукты, собрать корзину, КБЖУ | `tbank-grocery-order` |
| Билеты в кино, на концерт, афиша | `tbank-tickets` |
| Поезда и самолёты — от поиска до купленного билета и возврата; отели и маркетплейс — поиск | `tbank-travel` |
| Перевести деньги человеку, между своими счетами, юрлицу по реквизитам или по QR со счёта | `tbank-transfer-money` |
| Оплатить счёт — ЖКХ, налог, штраф, интернет; пополнить телефон | `tbank-bill-pay` |
| Анализ трат, подписки, экономия | `tbank-budget-analyzer` |
| Портфель, бумаги, доходность | `tbank-invest-advisor` |
| Карты, лимиты, реквизиты, паспорт и документы | `tbank-cards-documents` |
| Чаты и поддержка банка | `tbank-messenger` |
| Первый вход, проблемы с сессией | `tbank-login` |

## Если скила нет

Не всё покрыто скилами. Вот тулы для остального — вызывай напрямую:

- **Счета и операции:** `list_accounts()` → `list_operations(account_id, days, limit)`,
  `spending_categories(account_id, days)`, `operations_histogram(...)`.
- **Заказы:** `orders(kind)` — продукты, кино, концерты, авиа, поезда, отели в одной
  выдаче; `order_details(order_id)` — места и код брони;
  `travel_order_details(order_id)` — детали поездки: у ЖД вагон, места и статус
  электронной регистрации, у авиа маршрут и документы, у отеля номер и гости.
  Сами поездки одной лентой — `trips()`; билет в файл —
  `travel_ticket_file(order_id)`.

FAQ

Does the model see my password?

No, if you log in with tbank-mcp-login or login_cli.py: the password is read via getpass in the terminal. Logging in through the agent works but puts the password into context and logs.

Where is the session stored?

In ~/.local/share/tbank-mcp/session.json with 0600 permissions. TBANK_SESSION changes the path.

Can small payments skip confirmation?

The ruble threshold is set by TBANK_CONFIRM_ABOVE. The default is 0, so every payment asks. grocery_checkout always requires a client with elicitation.

A CLI and skill giving an agent access to a T-Investments account: portfolio, returns, bond screeners and confirmed orders

SkillHigh riskRussian stack44

A Go library and zm CLI for the ZenMoney API, with a Claude Code skill that answers personal finance questions

CLIMedium riskRussian stack2