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
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.
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 bookLimitations
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.
MCP
- Transport
- stdio
- Authentication
- not required
| Environment variables | |
|---|---|
| SPRING_PROFILES_ACTIVE | Profile set: read-mcp, trade-mcp, sandbox-mcp. All three are enabled by default |
Security check
- 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
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.
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.
Related
Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data
The official CCXT MCP server and skills: market data, balances and opt-in trading across crypto exchanges and prediction markets
Skill plugins for analyzing stocks, earnings, options and startups, plus readers for social feeds and market data
Skills and an MCP server for options traders: quotes, technical analysis, Greeks, spreads, scanners and Interactive Brokers portfolio