t-invest-tinkoff-mcp

MCP-сервер для T-Invest (Т-Инвестиции): рыночные данные, портфель и торговые операции по фьючерсам MOEX для ИИ-клиентов (Claude и любых других, поддерживающих Model Context Protocol). Вы подключаете сервер к своему ИИ — и просите его: «покажи свечи NGZ6», «что в моём портфеле», «поставь лимитку».

English: an MCP server that gives AI clients access to T-Invest market data, your portfolio and trading tools for MOEX futures. See the English section below.

⚠️ Предупреждение

Сервер даёт ИИ доступ к реальному счёту. Торговые инструменты (place_market_order, place_limit_order, place_stop_loss, place_take_profit, cancel_order, close_position) включены по умолчанию: подключённый ИИ может ставить и отменять ордера и закрывать позиции. Вы отвечаете за все сделки.

• Только чтение: TINVEST_ALLOW_TRADING=0.
• Проверка без риска: TINVEST_SANDBOX=1 (песочница T-Invest, токен песочницы).
• Токен T-Invest бывает «только чтение» и «торговый»: для работы без ордеров выпустите токен только на чтение.
• Автор не даёт инвестиционных рекомендаций и не несёт ответственности за убытки (см. лицензию).

Что нужно

• Python 3.10+.
• Токен T-Invest API: https://www.tbank.ru/invest/settings/api/ и (по желанию) номер счёта.
• ИИ-клиент с поддержкой MCP (Claude Code, Claude Desktop и др.).

Работает с фьючерсами MOEX: тикер — код фьючерса, например NGZ6, SiZ6, BRZ6.

Установка

pip install git+https://github.com/viptdv333-boop/t-invest-tinkoff-mcp.git

Подключение к Claude

Claude Code:

claude mcp add tinvest -e TINKOFF_TOKEN=ваш_токен -e TINKOFF_ACCOUNT_ID=номер_счёта -- tinvest-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "tinvest": {
      "command": "tinvest-mcp",
      "env": {
        "TINKOFF_TOKEN": "ваш_токен",
        "TINKOFF_ACCOUNT_ID": "номер_счёта"
      }
    }
  }
}

Токен хранится только у вас на машине. Сервер работает локально и обращается только к API T-Invest.

Примеры запросов к ИИ

• «Покажи последние 100 часовых свечей NGZ6 и коротко опиши структуру».
• «Какая цена и стакан у BRZ6?»
• «Что у меня в портфеле, какая свободная маржа?»
• «Посчитай размер позиции для входа 3.05 со стопом 2.98 при риске 1% депозита».
• «Покажи активные заявки и стопы».
• (торговля включена) «Поставь лимитную заявку на покупку 1 контракта NGZ6 по 3.05».

Инструменты

qty — количество контрактов (лотов), цены — в пунктах инструмента.

Настройки (переменные окружения)

Если что-то не работает

• TINKOFF_TOKEN not set — токен не передан клиенту: проверьте блок env в настройках MCP.
• Trading disabled — торговля отключена (TINVEST_ALLOW_TRADING=0).
• Ошибка прав при постановке ордера — токен «только чтение»; нужен торговый токен.
• <тикер> not found — укажите код фьючерса MOEX; проверьте, что контракт не истёк.
• Команда tinvest-mcp не найдена — проверьте, что каталог со скриптами pip в PATH, или укажите полный путь в command.

English

An MCP server for T-Invest (MOEX futures): candles, last price, order book, instrument specs, portfolio, free margin, operations history, position sizing and trading tools (market/limit orders, stop-loss, take-profit, cancel, close).

Install: pip install git+https://github.com/viptdv333-boop/t-invest-tinkoff-mcp.git. Set TINKOFF_TOKEN (and optionally TINKOFF_ACCOUNT_ID) in the MCP client config and run the tinvest-mcp command over stdio.

Warning: trading tools are enabled by default and operate on your real account. Set TINVEST_ALLOW_TRADING=0 for read-only mode or TINVEST_SANDBOX=1 to use the T-Invest sandbox. Not investment advice; use at your own risk.

Лицензия

MIT. См. LICENSE.