
T Invest MCP: три сервера Т-Инвестиций для Claude, Cursor и Codex
Подключает агента к T-Invest API: свечи, стакан, портфель, история операций и заявки на вашем счёте или в песочнице. Все три сервера сторонние и работают по вашему токену.
Заточен под фьючерсы MOEX: портфель, свободная маржа, расчёт размера позиции по риску, стопы и тейки; торговлю отключает одна переменная.
Как подключить
Что сделать до подключения
Python 3.10 или новее
Поставить сервер: pip install git+https://github.com/viptdv333-boop/t-invest-tinkoff-mcp.git
Токен T-Invest API
TINKOFF_TOKENТ-Инвестиции → настройки → API (tbank.ru/invest/settings/api), для работы без ордеров выпустите токен только на чтение
TINKOFF_ACCOUNT_IDномер счёта, необязательно: без него берётся первый счёт
TINVEST_ALLOW_TRADING0 — отключить торговые инструменты
TINVEST_SANDBOX1 — работать в песочнице с токеном песочницы
Конфиг для вашего клиента
Впишите ключи, и они встанут во все конфиги ниже. Конфиг собирается в браузере.
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --env 'TINKOFF_TOKEN=<токен T-Invest API>' --env 'TINKOFF_ACCOUNT_ID=<номер счёта>' --transport stdio t-investitsii \
-- tinvest-mcpПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.t-investitsii]
command = "tinvest-mcp"
args = []
[mcp_servers.t-investitsii.env]
TINKOFF_TOKEN = "<токен T-Invest API>"
TINKOFF_ACCOUNT_ID = "<номер счёта>"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"t-investitsii": {
"command": "tinvest-mcp",
"args": [],
"env": {
"TINKOFF_TOKEN": "<токен T-Invest API>",
"TINKOFF_ACCOUNT_ID": "<номер счёта>"
}
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"t-investitsii": {
"type": "stdio",
"command": "tinvest-mcp",
"args": [],
"env": {
"TINKOFF_TOKEN": "<токен T-Invest API>",
"TINKOFF_ACCOUNT_ID": "<номер счёта>"
}
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"t-investitsii": {
"command": "tinvest-mcp",
"args": [],
"env": {
"TINKOFF_TOKEN": "<токен T-Invest API>",
"TINKOFF_ACCOUNT_ID": "<номер счёта>"
}
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"t-investitsii": {
"command": "tinvest-mcp",
"args": [],
"env": {
"TINKOFF_TOKEN": "<токен T-Invest API>",
"TINKOFF_ACCOUNT_ID": "<номер счёта>"
}
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"t-investitsii": {
"type": "local",
"command": ["tinvest-mcp"],
"environment": {
"TINKOFF_TOKEN": "<токен T-Invest API>",
"TINKOFF_ACCOUNT_ID": "<номер счёта>"
}
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"t-investitsii": {
"command": "tinvest-mcp",
"args": [],
"env": {
"TINKOFF_TOKEN": "<токен T-Invest API>",
"TINKOFF_ACCOUNT_ID": "<номер счёта>"
}
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"t-investitsii": {
"command": "tinvest-mcp",
"args": [],
"env": {
"TINKOFF_TOKEN": "<токен T-Invest API>",
"TINKOFF_ACCOUNT_ID": "<номер счёта>"
}
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
get_candlesотдаёт свечи OHLCVget_last_priceпоказывает последнюю ценуget_orderbookчитает стакан заявокget_instrument_specsпоказывает ГО и шаг ценыget_phaseпоказывает фазу торгов MOEXget_portfolioчитает позиции, доходность и маржуget_active_ordersпоказывает активные заявки и стопыget_free_depositсчитает свободную маржуget_operationsчитает историю операцийcalculate_position_sizeсчитает размер позиции по рискуplace_market_orderставит рыночный ордерplace_limit_orderставит лимитный ордерplace_stop_lossставит стоп-лоссplace_take_profitставит тейк-профитcancel_orderотменяет заявку или стопclose_positionзакрывает позицию по рынкуСервер на Kotlin и Spring Boot с тремя профилями: чтение данных, торговля и песочница; кроме котировок отдаёт отчёты эмитентов, фундаментальные метрики и консенсус-прогнозы.
Как подключить
Что сделать до подключения
Java 21 или новее
Склонировать репозиторий, вписать токен в src/main/resources/application.yml (tinkoff.token) и собрать проект командой ./gradlew build
Токен T-Invest API
tinkoff.tokenтокен из личного кабинета Т-Инвестиций, вписывается в application.yml до сборки
SPRING_PROFILES_ACTIVEнабор профилей: read-mcp, trade-mcp, sandbox-mcp; trade-mcp требует торговый токен
Конфиг для вашего клиента
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --env SPRING_PROFILES_ACTIVE=read-mcp,sandbox-mcp --transport stdio tinkoff-investments-mcp-server \
-- java -jar /path/to/rich-0.0.1-SNAPSHOT.jarПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.tinkoff-investments-mcp-server]
command = "java"
args = ["-jar", "/path/to/rich-0.0.1-SNAPSHOT.jar"]
[mcp_servers.tinkoff-investments-mcp-server.env]
SPRING_PROFILES_ACTIVE = "read-mcp,sandbox-mcp"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"tinkoff-investments-mcp-server": {
"command": "java",
"args": ["-jar", "/path/to/rich-0.0.1-SNAPSHOT.jar"],
"env": {
"SPRING_PROFILES_ACTIVE": "read-mcp,sandbox-mcp"
}
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"tinkoff-investments-mcp-server": {
"type": "stdio",
"command": "java",
"args": ["-jar", "/path/to/rich-0.0.1-SNAPSHOT.jar"],
"env": {
"SPRING_PROFILES_ACTIVE": "read-mcp,sandbox-mcp"
}
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"tinkoff-investments-mcp-server": {
"command": "java",
"args": ["-jar", "/path/to/rich-0.0.1-SNAPSHOT.jar"],
"env": {
"SPRING_PROFILES_ACTIVE": "read-mcp,sandbox-mcp"
}
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"tinkoff-investments-mcp-server": {
"command": "java",
"args": ["-jar", "/path/to/rich-0.0.1-SNAPSHOT.jar"],
"env": {
"SPRING_PROFILES_ACTIVE": "read-mcp,sandbox-mcp"
}
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"tinkoff-investments-mcp-server": {
"type": "local",
"command": ["java", "-jar", "/path/to/rich-0.0.1-SNAPSHOT.jar"],
"environment": {
"SPRING_PROFILES_ACTIVE": "read-mcp,sandbox-mcp"
}
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"tinkoff-investments-mcp-server": {
"command": "java",
"args": ["-jar", "/path/to/rich-0.0.1-SNAPSHOT.jar"],
"env": {
"SPRING_PROFILES_ACTIVE": "read-mcp,sandbox-mcp"
}
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"tinkoff-investments-mcp-server": {
"command": "java",
"args": ["-jar", "/path/to/rich-0.0.1-SNAPSHOT.jar"],
"env": {
"SPRING_PROFILES_ACTIVE": "read-mcp,sandbox-mcp"
}
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
getCandlesотдаёт исторические свечиgetOrderBookчитает стакан котировокgetLastTradesпоказывает последние сделкиgetClosePricesотдаёт цены закрытияgetTradingStatusпоказывает статус торговgetAssetFundamentalsотдаёт фундаментальные метрикиgetAssetReportsпоказывает отчёты эмитентовgetConsensusForecastsотдаёт консенсус-прогнозыgetForecastByпоказывает прогнозы по инструментуgetAccountsпоказывает список счетовgetUserTariffпоказывает тариф и лимитыpostOrderсоздаёт ордерpostStopOrderсоздаёт стоп-ордерcancelStopOrderотменяет стоп-ордерopenSandboxAccountоткрывает счёт в песочницеsandboxPayInпополняет счёт песочницыpostSandboxOrderставит ордер в песочницеgetSandboxPortfolioчитает портфель песочницыПоказано 18 из 35.
По умолчанию работает в песочнице и только с одним счётом; ищет акции, облигации и ETF по тикеру, ISIN или названию.
Как подключить
Что сделать до подключения
Python 3.12 или 3.13 и uv
Поставить сервер: uv tool install git+https://github.com/akaGelo/tinkoff-invest-mcp.git
TINKOFF_TOKENAPI-токен Т-Инвестиций
TINKOFF_ACCOUNT_IDID счёта, обязателен: операции ограничены этим счётом
TINKOFF_MODEsandbox по умолчанию, production — реальный счёт
Конфиг для вашего клиента
Впишите ключи, и они встанут во все конфиги ниже. Конфиг собирается в браузере.
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --env 'TINKOFF_TOKEN=<токен T-Invest API>' --env 'TINKOFF_ACCOUNT_ID=<ID счёта>' --env TINKOFF_MODE=sandbox --transport stdio tinkoff-invest-mcp \
-- tinkoff-invest-mcpПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.tinkoff-invest-mcp]
command = "tinkoff-invest-mcp"
args = []
[mcp_servers.tinkoff-invest-mcp.env]
TINKOFF_TOKEN = "<токен T-Invest API>"
TINKOFF_ACCOUNT_ID = "<ID счёта>"
TINKOFF_MODE = "sandbox"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"tinkoff-invest-mcp": {
"command": "tinkoff-invest-mcp",
"args": [],
"env": {
"TINKOFF_TOKEN": "<токен T-Invest API>",
"TINKOFF_ACCOUNT_ID": "<ID счёта>",
"TINKOFF_MODE": "sandbox"
}
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"tinkoff-invest-mcp": {
"type": "stdio",
"command": "tinkoff-invest-mcp",
"args": [],
"env": {
"TINKOFF_TOKEN": "<токен T-Invest API>",
"TINKOFF_ACCOUNT_ID": "<ID счёта>",
"TINKOFF_MODE": "sandbox"
}
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"tinkoff-invest-mcp": {
"command": "tinkoff-invest-mcp",
"args": [],
"env": {
"TINKOFF_TOKEN": "<токен T-Invest API>",
"TINKOFF_ACCOUNT_ID": "<ID счёта>",
"TINKOFF_MODE": "sandbox"
}
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"tinkoff-invest-mcp": {
"command": "tinkoff-invest-mcp",
"args": [],
"env": {
"TINKOFF_TOKEN": "<токен T-Invest API>",
"TINKOFF_ACCOUNT_ID": "<ID счёта>",
"TINKOFF_MODE": "sandbox"
}
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"tinkoff-invest-mcp": {
"type": "local",
"command": ["tinkoff-invest-mcp"],
"environment": {
"TINKOFF_TOKEN": "<токен T-Invest API>",
"TINKOFF_ACCOUNT_ID": "<ID счёта>",
"TINKOFF_MODE": "sandbox"
}
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"tinkoff-invest-mcp": {
"command": "tinkoff-invest-mcp",
"args": [],
"env": {
"TINKOFF_TOKEN": "<токен T-Invest API>",
"TINKOFF_ACCOUNT_ID": "<ID счёта>",
"TINKOFF_MODE": "sandbox"
}
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"tinkoff-invest-mcp": {
"command": "tinkoff-invest-mcp",
"args": [],
"env": {
"TINKOFF_TOKEN": "<токен T-Invest API>",
"TINKOFF_ACCOUNT_ID": "<ID счёта>",
"TINKOFF_MODE": "sandbox"
}
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
get_cash_balanceпоказывает денежный балансget_portfolioчитает состав портфеля и P&Lget_operationsчитает операции за периодget_candlesотдаёт свечи за периодget_last_pricesпоказывает последние ценыget_order_bookчитает стакан заявокget_trading_schedulesпоказывает расписание торговfind_instrumentищет инструмент по тикеру или ISINget_sharesвыводит список акцийget_bondsвыводит список облигацийget_etfsвыводит список ETFcreate_orderсоздаёт заявкуcancel_orderотменяет заявкуpost_stop_orderсоздаёт стоп-заявкуget_active_stop_ordersпоказывает активные стоп-заявкиПоказано 15 из 18.
Что попросить агента
Для каких задач
Ограничения
Все три сервера сторонние и молодые: 11, 13 и 0 звёзд на GitHub; akaGelo не обновлялся с сентября 2025 года
В t-invest-tinkoff-mcp торговые инструменты включены по умолчанию и работают с реальным счётом: для режима чтения задайте TINVEST_ALLOW_TRADING=0 или выпустите токен только на чтение
t-invest-tinkoff-mcp работает только с фьючерсами MOEX: тикер — код контракта вроде NGZ6
Sprytin нужно собирать из исходников на Java 21, токен вписывается в файл application.yml; портфель и операции в нём есть только у песочницы
Если не работает
Сервер пишет TINKOFF_TOKEN not set
Ответ «Trading disabled» на просьбу поставить заявку
Ошибка прав при постановке ордера
Ответ «<тикер> not found»
Клиент не находит команду tinvest-mcp
Какую реализацию выбрать
| Реализация | Кто делает | Звёзды | Запуск | Ключ | Инструменты | Обновлён |
|---|---|---|---|---|---|---|
| t-invest-tinkoff-mcp | viptdv333-boop | 11 | локально | токен | 16 | 2 октября 2026 |
| Tinkoff Invest MCP Server | Sprytin | 13 | локально | токен | 35 | 29 мая 2026 |
| tinkoff-invest-mcp | akaGelo | 0 | локально | токен | 18 | 13 сентября 2025 |