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
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
Install
- Works in
- 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 reviewBroad 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 purchaseMCP
- 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.
Related
All T-Bank toolsUnofficial MCP server and skills for a personal T-Bank account: accounts, transfers, bill pay, tickets and groceries
T-Bank Invest MCP server, read-only
T-Bank Invest MCP Server (read-only)
An MCP server for a T-Bank Invest portfolio with no trading rights: positions, operations, market data, and technical and fundamental analytics
PHP REST API and MCP for T-Invest
tbank_mcp_and_api
PHP wrapper over T-Invest API: REST endpoints and MCP server with a shared catalog of over 90 methods, trading disabled by default
Mock T-Bank API server for development
Mock T-Bank API Server
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
MOEX and T-Bank Invest market data MCP
market-mcp
A read-only MOEX ISS and T-Bank Invest market data MCP server: quotes, candles, a screener, and optional portfolio access
An unofficial local T-Invest MCP server: portfolio analysis, screening and rebalance plans, with orders only after confirmation
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.