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, 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) без параметра 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