T-Bank MCP
Unofficial MCP server and skills for a personal T-Bank account: accounts, transfers, bill pay, tickets and groceries
Install
/plugin marketplace add icyberdeveloper/tbank-mcp
/plugin install tbank@tbank-mcp
/reload-pluginsInstalls 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 cancelLimitations
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 | |
|---|---|
| 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.
Related
A CLI and skill giving an agent access to a T-Investments account: portfolio, returns, bond screeners and confirmed orders
A Go library and zm CLI for the ZenMoney API, with a Claude Code skill that answers personal finance questions