Unofficial read-only T-Bank CLI and MCP

tbank-cli-mcp

A local read-only CLI and MCP for a T-Bank personal account via a web session: operations, receipts and statements, no payments

  • 0 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • It uses the bank's unofficial internal API via a browser session, and use may conflict with T-Bank's terms
  • The local file with cookies and session_id grants read access to the personal account and must be stored as carefully as a password
All reasons and checks
Russian stack

tlmonko/tbank-mcp

Install

Services

Manual install

python3 -m venv .venv && . .venv/bin/activate && python -m pip install ".[dev]"

Install into a virtual environment per the README; a session file must be prepared afterward.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • It uses the bank's unofficial internal API via a browser session, and use may conflict with T-Bank's terms
  • The local file with cookies and session_id grants read access to the personal account and must be stored as carefully as a password

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

What it does

The tool reads a personal T-Bank account's data through the internal web API, using the user's already authenticated browser session: the list of products and accounts, operations over a period with details, a receipt for an operation, and statements. Dates and auth are not re-entered, and no password or SMS code is asked for via the CLI: the user manually prepares a local JSON with cookies and a session_id from their own browser. There is both a plain CLI and a stdio MCP server running on the same code. There is no persistent server, cloud service or Docker, only a local process.

Who it is for. For people who want to read their own T-Bank operations and statements through an agent, accepting the risks of an unofficial API.

Good fit when

  • You only need to view your own account's operations, receipts and statements, with no payments
  • You are willing to manually extract cookies and a session_id from an authorized browser
  • You accept the risk that the internal API contract may change after a site update

Not a fit when

  • You need payments, transfers, top-ups or card and limit management: these are deliberately not implemented
  • You are not willing to use an unofficial internal API client that may conflict with T-Bank's terms
  • You need access to a corporate or business account rather than a personal one

Example request

Show my T-Bank card operations for the last week and pull the receipt for the largest purchase

MCP

Transport
stdio
Authentication
not required

Limitations

The README explicitly calls the project an unofficial client of T-Bank's internal web API, unaffiliated with the bank: the contract may change after a site update, and use may conflict with T-Bank's terms of service. Payments, transfers, top-ups, card and limit management, applications, settings and messages to the bank are deliberately not implemented. Authorization is manual, via preparing a local file with cookies and a session_id from the browser; there is no automatic password-based login.

How to disable. Delete the local session file and remove the server from your MCP client configuration.

FAQ

Can the tool make a transfer or payment?

No, the README states this is deliberately not implemented.

Do I need a password or SMS code?

No, passwords and SMS codes are not entered via the CLI; an already authenticated browser session is used instead.

Discussion

No questions or reviews yet.

Russian stack

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

MCP serverBroad access57Repository stars

T-Bank Invest MCP server, read-only

T-Bank Invest MCP Server (read-only)

Russian stack

An MCP server for a T-Bank Invest portfolio with no trading rights: positions, operations, market data, and technical and fundamental analytics

MCP serverBroad access3Repository stars
Russian stack

PHP wrapper over T-Invest API: REST endpoints and MCP server with a shared catalog of over 90 methods, trading disabled by default

MCP serverBroad access
Russian stack

A FastAPI stand-in for the T-Bank Business API for local development and testing of tbank-mcp: 20-plus endpoints, three months of seeded data

CLIExtended access
Russian stack

A read-only MOEX ISS and T-Bank Invest market data MCP server: quotes, candles, a screener, and optional portfolio access

MCP serverBroad access
Russian stack

An unofficial local T-Invest MCP server: portfolio analysis, screening and rebalance plans, with orders only after confirmation

MCP serverBroad access1Repository stars

README in short

The Russian README describes in detail the verified read-only contracts of T-Bank's internal API: products and accounts, operations, receipts, statements, checked as of August 19, 2026, with a reference to the jfk9w-go/tinkoff-api project. A separate Status and risks section plainly warns that this is an unofficial client, the contract may change, and use may conflict with T-Bank's terms.

README badge

Report a problem