Tinkoff Invest MCP Server
MCP-сервер для T-Invest API на Kotlin: рыночные данные, заявки и стоп-заявки, песочница с виртуальными деньгами
Установка
git clone https://github.com/Sprytin/tinkoff-investments-mcp-server.git
cd tinkoff-investments-mcp-server
./gradlew buildПеред сборкой впишите токен в src/main/resources/application.yml (tinkoff.token). Нужна Java 21.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на Spring Boot открывает агенту API Т-Инвестиций. Инструменты чтения дают свечи, стакан, статусы торгов, последние сделки, фундаментальные показатели, отчеты эмитентов, консенсус-прогнозы, список счетов и тариф. Торговые инструменты выставляют рыночные и лимитные заявки, создают и отменяют стоп-заявки на реальном счете. Песочница позволяет открыть виртуальный счет, пополнить его и проверить заявки без реальных денег. Наборы инструментов включаются профилями Spring: read-mcp, trade-mcp и sandbox-mcp.
Для кого. Для разработчиков торговых стратегий и частных инвесторов с навыками программирования, у которых есть счет в Т-Инвестициях.
Подходит, если
- Нужно получить свечи или стакан по инструменту в разговоре с агентом
- Нужно проверить логику заявок в песочнице
- Нужно посмотреть фундаментальные показатели и прогнозы по бумаге
Не подходит, если
- Нельзя допускать, чтобы модель сама отправляла заявки на реальный счет
- Нет Java 21 и опыта сборки Gradle-проектов
Пример запроса к агенту
Покажи часовые свечи по инструменту BBG004730N88 за вчера и текущий стакан на 20 уровнейОграничения
Нужны Java 21 и токен T-Invest API. Готовой сборки нет: репозиторий клонируют, токен вписывают в application.yml и собирают Gradle. По умолчанию включены все профили, включая торговый, поэтому для безопасной работы профили нужно ограничить явно. Проект неофициальный, сервис не дает инвестиционных рекомендаций.
Как отключить. Удалите блок tinkoff-invest из конфигурации MCP клиента и отзовите токен в настройках T-Invest API.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| SPRING_PROFILES_ACTIVE | Набор профилей: read-mcp, trade-mcp, sandbox-mcp. По умолчанию включены все три |
Проверка безопасности
- Может выставлять и отменять заявки на реальном брокерском счете
- Торговый профиль включен по умолчанию
- Токен брокерского счета хранится в файле конфигурации
Коротко о README
README на русском описывает три группы инструментов: чтение, торговля и песочница, с сигнатурами методов. Установка сводится к клонированию, записи токена в application.yml и сборке Gradle, приведена конфигурация для Claude Desktop через java -jar. Объяснены профили Spring и параметры конфигурации, есть примеры вызовов на Kotlin. Раздел безопасности советует проверять стратегии в песочнице. Лицензия MIT.
Частые вопросы
Как запретить реальные сделки?
Запускайте сервер с SPRING_PROFILES_ACTIVE=read-mcp,sandbox-mcp, тогда торговые инструменты не загружаются.
Где взять токен?
В настройках API в личном кабинете Т-Инвестиций. Для торгового профиля нужен токен с правом торговли.
Похожие
Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта
Скиллы и MCP-сервер для опционных трейдеров: котировки, технический анализ, греки, спреды, сканеры и портфель Interactive Brokers
Square MCP Server
Square Model Context Protocol Server
Официальный MCP-сервер Square: агент вызывает любые методы API Square, от каталога и клиентов до заказов и платежей
CLI и скилл для доступа агента к счету Т-Инвестиций: портфель, доходность, скринеры облигаций и заявки с подтверждением