T-Invest MCP server with account-id lock
Tinkoff Invest MCP Server
A T-Invest MCP server: portfolio, operations and market data, with a mandatory single-account lock and a sandbox mode
- 0 ★ on the repository
- Last commit
Extended access
Why this level
- It reads the portfolio, balance and operation history of a real investment account
- The API token grants access to account data within its permissions, even though the server does not place orders
Install
- Works in
- Services
Manual install
uv tool install git+https://github.com/akaGelo/tinkoff-invest-mcp.gitInstallation from source via uv tool install.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- It reads the portfolio, balance and operation history of a real investment account
- The API token grants access to account data within its permissions, even though the server does not place orders
This is third-party code. Review the repository files before installing.
What it does
The server provides 18 Tinkoff Invest API methods: cash balance, portfolio composition with P&L, operations over a period filtered by status and instrument, candles with a chosen interval, and last prices. For safety, the server requires not just a token but also TINKOFF_ACCOUNT_ID, restricting all operations to one specific account, and TINKOFF_MODE defaults to sandbox instead of the live circuit. MCP Inspector can be connected for debugging.
Who it is for. For individual investors and developers who need agent access to one specific T-Invest account without risking other accounts.
Good fit when
- You need agent access to a T-Invest portfolio, balance and operations
- You need the server hard-limited to one account id for safety
- You need a sandbox mode for testing before the live circuit
Not a fit when
- You need to place buy or sell orders: the README only covers reading the portfolio, operations and market data
- You need to work with several accounts at once in a single server run
Example request
Show my T-Invest portfolio with profit and loss for each positionMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
TINKOFF_TOKENrequired, secret- The T-Invest API token.
TINKOFF_ACCOUNT_IDrequired- The account id all server operations are hard-locked to.
TINKOFF_MODE- The mode: sandbox by default or production.
Limitations
The project has a single author with no known releases and only installs from source via uv tool install. The README describes 18 data-reading methods; nothing is said about placing orders or managing the portfolio. The mandatory TINKOFF_ACCOUNT_ID variable restricts the server to one account; a different account needs a separate run.
How to disable. Remove the server from your MCP client configuration and revoke the T-Invest token if needed.
FAQ
Why is TINKOFF_ACCOUNT_ID mandatory?
The README says this restricts operations to one account for safety reasons.
Can it place orders?
The README does not describe such tools; the server focuses on reading the portfolio, operations and market data.
Discussion
No questions or reviews yet.
Related
All T-Bank toolsTinkoff wealth MCP analyst
tinkoff-wealth-mcp
A personal read-only MCP server for a T-Investments portfolio: combined net worth, concentration risk, a coupon calendar, progress toward a financial goal
Autonomous trading MCP for T-Bank Invest
Tinkoff Trader MCP
An MCP server for T-Bank Invest with market analysis, backtesting five strategies, risk management and order placement, with live trading off by default
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
A Kotlin MCP server for the T-Invest API: market data, orders and stop orders, and a sandbox with virtual money
T-Bank Invest MCP server in C#
TInvestMcp
A console C# MCP server for T-Bank Invest: accounts, portfolio, dividends, operations and broker reports, read-only
An unofficial local T-Invest MCP server: portfolio analysis, screening and rebalance plans, with orders only after confirmation
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| T-Invest MCP server with account-id lock (this card) | no | API key | 0 | |
| T-Bank Invest MCP server, read-only | no | API key | 3 | read-only, no trading |
| T-Bank Invest MCP server in Go | no | API key | 1 | accounts and portfolio |
| T-Bank Invest MCP server in C# | no | key is optional | 0 | reports and portfolio |
README in short
The Russian README gives the uv tool install-from-source steps, an environment-variable table (TINKOFF_TOKEN, the mandatory TINKOFF_ACCOUNT_ID, TINKOFF_MODE defaulting to sandbox, TINKOFF_APP_NAME), and a section describing the available methods by group: portfolio and balances, operations and history, and market data with candles and intervals.