How do I use T-Invest MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@T-Invest MCP Server show my portfolio holdings and the current prices for SBER" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

T-Invest MCP Server

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

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

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

Счета и профиль

Инструмент	Параметры	Описание
`get_accounts`	—	Список счетов пользователя
`get_user_info`	—	Профиль пользователя (тариф, статус квал. инвестора)
`get_portfolio`	`accountId`*, `tickers`?	Портфель по счёту с фильтрацией по тикерам
`get_positions`	`accountId`*	Позиции счёта (деньги, ценные бумаги, фьючерсы)
`get_withdraw_limits`	`accountId`*	Лимиты вывода средств
`get_margin_attributes`	`accountId`*	Маржинальные атрибуты (ликвидный портфель, начальная маржа)

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

Инструмент	Параметры	Описание
`get_asset_fundamentals`	`tickers`*	Фундаментальные показатели: P/E, ROE, EBITDA и др. (до 100 тикеров)
`get_last_prices`	`tickers`*	Текущие рыночные цены (до 100 тикеров)
`get_candles`	`ticker`, `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`	Расписание торгов (по умолчанию MOEX)
`get_tech_analysis`	`ticker`, `from`, `interval`?, `length`?	Технический анализ: BB, EMA, RSI, MACD, SMA
`get_signals`	`tickers`?, `from`?, `to`?, `direction`?, `limit`?	Торговые сигналы
`get_max_lots`	`accountId`, `price`?	Максимальное количество лотов для покупки/продажи

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

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

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

Инструмент	Параметры	Описание
`get_orders`	`accountId`*	Активные биржевые заявки
`post_order`	`accountId`, `direction`, `orderType`*, `price`?, `confirm`?	Выставить заявку (купить/продать)
`cancel_order`	`accountId`, `confirm`?	Отменить биржевую заявку
`get_stop_orders`	`accountId`*	Активные стоп-заявки
`post_stop_order`	`accountId`, `direction`, `orderType`, `limitPrice`?, `expirationType`?, `expireDate`?, `confirm`?	Выставить стоп-заявку
`cancel_stop_order`	`accountId`, `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) без параметра 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

Install Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

T-Invest MCP Server

T-Invest MCP Server

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

Счета и профиль

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

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

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

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

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

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

Через npx

Через Docker

Запуск

npx

Docker

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

Лицензия

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API