SkillFoxx

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

  • 0 ★ on the repository
  • Last commit
MCP server

Broad access

Why this level

  • Once TINKOFF_LIVE_TRADING is explicitly enabled, the server places and cancels real exchange orders with account money
  • Start with TINKOFF_MODE=sandbox and a read-only token, and enable live trading deliberately, one trade at a time
All reasons and checks
Russian stack

inmozel/tinkoff-trader-mcpAuthor:INMozel

Install

Services

Manual install

pip install tinkoff-trader-mcp

Install from PyPI; TINKOFF_TOKEN and TINKOFF_ACCOUNT_ID are needed afterward.

Access and checks

How we review

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

  • Once TINKOFF_LIVE_TRADING is explicitly enabled, the server places and cancels real exchange orders with account money
  • Start with TINKOFF_MODE=sandbox and a read-only token, and enable live trading deliberately, one trade at a time

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

What it does

A Python server provides 12 tools for the Russian stock market: a market scan with regime classification (trending, ranging, volatile), momentum, RSI, ADX, deep single-instrument analysis, Engle-Granger cointegrated pair search, backtesting five built-in strategies (Donchian breakout, ATR-trailed momentum, Bollinger mean reversion, RSI mean reversion, moving-average crossover), ATR-based and Kelly-fraction position sizing, portfolio and operation views, and placing and canceling orders. Live trading is off by default: place_order requires both the TINKOFF_LIVE_TRADING=YES_I_KNOW environment variable and the dry_run=false argument at the same time; without both it returns a simulated response with the hypothetical order details.

Who it is for. For traders who want to backtest strategies and analyze the market with an agent, with real trading turned on deliberately and explicitly.

Good fit when

  • You want to scan the market and find stocks in a given regime with specific indicators
  • You want to backtest a ready strategy before trying it live
  • You need ATR-based or Kelly-fraction position risk sizing before a trade

Not a fit when

  • You are not ready to explicitly enable live trading through the dual condition: by default place_order only simulates the order
  • You need a profitability guarantee: the author states plainly this is not investment advice and backtests do not predict future returns
  • You are not prepared for the risk of total capital loss: the README warns about this directly in the disclaimer

Example request

Scan the market, find the top 3 stocks in a trending regime with RSI under 60, and backtest momentum_atr on each over 2 years

MCP

Transport
stdio
Authentication
API key

Environment variables

TINKOFF_TOKEN required, secret
T-Invest API token; a read-only token is enough for analysis
TINKOFF_ACCOUNT_ID required
Account ID, needed for portfolio and orders
TINKOFF_MODE
real or sandbox
TINKOFF_LIVE_TRADING
Only the value YES_I_KNOW together with dry_run=false enables real orders

Limitations

The license in GitHub's metadata is marked Other, though the README text references MIT, so check the LICENSE file directly. The author states plainly the project is for educational and research purposes and the authors are not registered investment advisors. Live trading needs explicit dual confirmation, but once enabled the server places real orders on the exchange.

How to disable. Remove the tinkoff entry from your MCP client config and make sure TINKOFF_LIVE_TRADING is not set anywhere in your environment.

FAQ

Could the agent accidentally buy or sell shares?

No, that needs both the TINKOFF_LIVE_TRADING=YES_I_KNOW variable and dry_run=false in the call itself; without both it only returns a simulation.

Can I test without a real account?

Yes, TINKOFF_MODE=sandbox switches the server into T-Bank Invest's sandbox.

Discussion

No questions or reviews yet.

All T-Bank tools
Russian stack

A T-Invest MCP server: portfolio, operations and market data, with a mandatory single-account lock and a sandbox mode

MCP serverExtended access

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 access3
Russian stack

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

MCP serverBroad access1
Russian stack

A console C# MCP server for T-Bank Invest: accounts, portfolio, dividends, operations and broker reports, read-only

MCP serverBroad access
Russian stack

A Kotlin MCP server for the T-Invest API: market data, orders and stop orders, and a sandbox with virtual money

MCP serverBroad access13
Official

T-Investments official remote MCP: an agent reads the portfolio and quotes and can place orders on the brokerage account itself

MCP serverBroad access

README in short

The README describes installing via pip, environment variables including the dual condition for live trading, connecting to Hermes Agent and Claude Desktop, a table of 12 tools, five built-in backtest strategies, a safety model with two conditions and a 1-lot order minimum, example prompts in Russian, and an explicit disclaimer about the project's educational nature and the risks of trading the Russian stock market.

README badge

Report a problem