T-Invest MCP Server

MCP сервер для работы с API Т-Инвестиций (Тинькофф Инвестиции) из Claude и других LLM-клиентов.

Порт t-invest-mcp-server на Node.js.

Инструменты (30)

Управление счетами

Инструмент	Параметры	Описание
get_accounts	—	Список брокерских счетов
get_bank_accounts	—	Список банковских счетов
get_user_info	—	Профиль пользователя (тариф, квал. инвестор)
get_user_tariff	—	Лимиты API (запросы/мин, стримы)
get_portfolio	accountId*, tickers?	Портфель по счёту с фильтрацией по тикерам
get_positions	accountId*	Позиции счёта (деньги, ценные бумаги, фьючерсы)
get_withdraw_limits	accountId*	Лимиты вывода средств
get_margin_attributes	accountId*	Маржинальные атрибуты (ликвидный портфель, начальная маржа)
get_account_values	accountIds*	Дополнительные показатели счетов
pay_in	fromAccountId, toAccountId, amount*, currency?, confirm?	Пополнить брокерский счёт с банковского
currency_transfer	fromAccountId, toAccountId, amount*, currency?, confirm?	Перевод между брокерскими счетами

Аналитика и инструменты

Инструмент	Параметры	Описание
get_asset_fundamentals	tickers*	Фундаментальные показатели: P/E, ROE, EBITDA и др. (до 100 тикеров)
get_last_prices	tickers*	Текущие рыночные цены (до 100 тикеров)
get_candles	ticker, from, to*, interval?	Исторические свечи OHLCV (1min, 5min, 15min, hour, day, week, month)
get_dividends	tickers*, from?, to?	Дивидендный календарь (до 50 тикеров)
get_bond_coupons	tickers*, from?, to?	Купонные выплаты по облигациям (до 50 тикеров)
get_consensus_forecasts	tickers*	Консенсус-прогнозы аналитиков (до 50 тикеров)
get_order_book	ticker*, depth?	Стакан заявок (глубина 1–50, по умолчанию 10)
get_trading_status	tickers*	Статус торгов по тикерам (до 50)
get_trading_schedules	exchange?, from, to	Расписание торгов (по умолчанию MOEX)
get_tech_analysis	ticker, indicator, from, to, interval?, length?	Технический анализ: BB, EMA, RSI, MACD, SMA
get_signals	tickers?, from?, to?, direction?, limit?	Торговые сигналы
get_max_lots	accountId, ticker, price?	Максимальное количество лотов для покупки/продажи

История операций

Инструмент	Параметры	Описание
get_operations	accountId*, from?, to?, limit?	История операций: сделки, дивиденды, комиссии

Торговые операции

Инструмент	Параметры	Описание
get_orders	accountId*	Активные биржевые заявки
post_order	accountId, ticker, direction, quantity, orderType*, price?, confirm?	Выставить заявку (купить/продать)
cancel_order	accountId, orderId, confirm?	Отменить биржевую заявку
get_stop_orders	accountId*	Активные стоп-заявки
post_stop_order	accountId, ticker, direction, quantity, orderType, stopPrice, limitPrice?, expirationType?, expireDate?, confirm?	Выставить стоп-заявку
cancel_stop_order	accountId, stopOrderId, confirm?	Отменить стоп-заявку

* — обязательный параметр, ? — опциональный

Рабочий процесс: агент сначала вызывает get_accounts, запоминает accountId и использует его в последующих запросах.

Переменные окружения

Переменная	Обязательная	Описание
APP_T_INVEST_BASE_URL	да	URL API T-Invest
APP_T_INVEST_TOKEN	да	Токен API (получить)
APP_T_INVEST_CONFIRM_TRADES	нет	Подтверждение сделок: true (по умолчанию) — превью перед исполнением, false — исполнять сразу

URL для прода: https://invest-public-api.tinkoff.ru/rest/ URL для песочницы: https://sandbox-invest-public-api.tinkoff.ru/rest/

Подтверждение сделок

При APP_T_INVEST_CONFIRM_TRADES=true (по умолчанию) торговые инструменты (post_order, cancel_order, post_stop_order, cancel_stop_order, pay_in, currency_transfer) без параметра confirm: true возвращают только превью — агент показывает его пользователю и запрашивает подтверждение. Для исполнения нужно повторно вызвать инструмент с confirm: true.

При APP_T_INVEST_CONFIRM_TRADES=false операция исполняется сразу.

Настройка в Claude Desktop

Файл конфигурации: ~/Library/Application Support/Claude/claude_desktop_config.json

Через npx

{
  "mcpServers": {
    "t-invest": {
      "command": "npx",
      "args": ["t-invest-mcp-server"],
      "env": {
        "APP_T_INVEST_BASE_URL": "https://invest-public-api.tinkoff.ru/rest/",
        "APP_T_INVEST_TOKEN": "your_token",
        "APP_T_INVEST_CONFIRM_TRADES": "true"
      }
    }
  }
}

Через Docker

{
  "mcpServers": {
    "t-invest": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "APP_T_INVEST_BASE_URL=https://invest-public-api.tinkoff.ru/rest/",
        "-e", "APP_T_INVEST_TOKEN=your_token",
        "-e", "APP_T_INVEST_CONFIRM_TRADES=true",
        "t-invest-mcp-server"
      ]
    }
  }
}

Запуск

npx

APP_T_INVEST_BASE_URL=https://invest-public-api.tinkoff.ru/rest/ \
APP_T_INVEST_TOKEN=your_token \
npx t-invest-mcp-server

Docker

docker build -t t-invest-mcp-server .

docker run -i --rm \
  -e APP_T_INVEST_BASE_URL=https://invest-public-api.tinkoff.ru/rest/ \
  -e APP_T_INVEST_TOKEN=your_token \
  t-invest-mcp-server

Из исходников

npm install
npm run build
npm start

Лицензия

MIT