Tinkoff Invest MCP Server
A Kotlin MCP server for the T-Invest API: market data, orders and stop orders, and a sandbox with virtual money
- 13 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Can place and cancel orders on a real brokerage account
- The trading profile is enabled by default
- The brokerage token is stored in a config file
Install
- Works in
- Services
Manual install
git clone https://github.com/Sprytin/tinkoff-investments-mcp-server.git
cd tinkoff-investments-mcp-server
./gradlew buildBefore building, put the token into src/main/resources/application.yml (tinkoff.token). Java 21 is required.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Can place and cancel orders on a real brokerage account
- The trading profile is enabled by default
- The brokerage token is stored in a config file
This is third-party code. Review the repository files before installing.
What it does
A Spring Boot server that exposes the T-Invest API to the agent. Read tools return candles, order books, trading statuses, recent trades, fundamentals, issuer reports, consensus forecasts, accounts and tariff. Trade tools place market and limit orders and create or cancel stop orders on a real account. The sandbox opens a virtual account, funds it and tests orders without real money. Tool sets are switched on with Spring profiles: read-mcp, trade-mcp and sandbox-mcp.
Who it is for. For trading strategy developers and technically skilled private investors with a T-Invest account.
Good fit when
- You need candles or an order book for an instrument in a chat with the agent
- You need to test order logic in the sandbox
- You need fundamentals and forecasts for a security
Not a fit when
- A model must never send orders to a real account on its own
- You lack Java 21 and experience building Gradle projects
Example request
Show yesterday's hourly candles for instrument BBG004730N88 and the current 20-level order bookMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
SPRING_PROFILES_ACTIVE- Profile set: read-mcp, trade-mcp, sandbox-mcp. All three are enabled by default
Limitations
Requires Java 21 and a T-Invest API token. There is no prebuilt release: you clone the repo, put the token in application.yml and build with Gradle. All profiles, including trading, are enabled by default, so restrict them explicitly for safe use. Unofficial project, and it gives no investment advice.
How to disable. Delete the tinkoff-invest block from your MCP client config and revoke the token in T-Invest API settings.
FAQ
How do I block real trades?
Run the server with SPRING_PROFILES_ACTIVE=read-mcp,sandbox-mcp so the trading tools are not loaded.
Where do I get a token?
In the API settings of your T-Invest account. The trading profile needs a token with trading rights.
Discussion
No questions or reviews yet.
Related
All T-Bank toolsT-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
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
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
An unofficial local T-Invest MCP server: portfolio analysis, screening and rebalance plans, with orders only after confirmation
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
README in short
The Russian README describes three tool groups, read, trade and sandbox, with method signatures. Setup is cloning, writing the token into application.yml and building with Gradle, and a Claude Desktop config via java -jar is given. Spring profiles and config parameters are explained, with Kotlin call examples. The security section recommends testing strategies in the sandbox. MIT licensed.