PHP REST API и MCP для Т-Инвестиций

tbank_mcp_and_api

PHP-обертка над T-Invest API: REST-эндпоинты и MCP-сервер с общим каталогом из более чем 90 методов, торговля выключена по умолчанию

  • 0 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Широкий доступ

Почему такой уровень

  • При включении TBANK_ALLOW_TRADING сервер может выставлять и отменять заявки на реальном счете
  • Универсальный вызов дает доступ к любому методу T-Invest API, а не только к безопасному поднабору
Все причины и проверки
Российский стек

aei2/tbank_mcp_and_api

Установка

Сервисы

Ручная установка

composer install && cp .env.example .env

Установка из исходников и настройка окружения перед запуском.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • При включении TBANK_ALLOW_TRADING сервер может выставлять и отменять заявки на реальном счете
  • Универсальный вызов дает доступ к любому методу T-Invest API, а не только к безопасному поднабору

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Проект дает и обычный REST API, и MCP-сервер на одном и том же PHP-коде поверх официального прокси T-Invest API: счета, инструменты, свечи, стакан, портфель, заявки, песочница, а также универсальный вызов любого из более чем 90 методов T-Invest без ожидания, пока его добавят отдельным эндпоинтом. MCP работает и как stdio для Cursor и Claude, и как Streamable HTTP с SSE. Торговля выключена, пока явно не включена переменная TBANK_ALLOW_TRADING, значения Quotation и MoneyValue нормализуются в единое поле value, инструмент можно найти по тикеру, FIGI, UID, ISIN или названию, а общая очередь ограничивает частоту запросов, чтобы не превысить квоты Т-Банка.

Для кого. Для PHP-разработчиков, которым нужен и REST API, и MCP-сервер для Т-Инвестиций на одном стеке, с явным выключателем торговли.

Подходит, если

  • Нужен PHP-стек вместо Node.js или Python для Т-Инвестиций
  • Нужен универсальный вызов любого метода T-Invest без ожидания отдельного эндпоинта
  • Важно, чтобы торговля была выключена по умолчанию и включалась явной переменной

Не подходит, если

  • Нет PHP 8.3+ и Composer в инфраструктуре
  • Нужен готовый опубликованный пакет Composer: устанавливается только из исходников

Пример запроса к агенту

Покажи стакан по SBER в Т-Инвестициях и последние свечи за час

MCP

Транспорт
stdio, http, sse
Авторизация
API-ключ

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

TBANK_INVEST_TOKEN обязательная, секрет
Токен T-Invest API.
TBANK_INVEST_ENV обязательная
Режим: sandbox или production.
TBANK_ALLOW_TRADING
Включает торговые операции, по умолчанию false.

Ограничения

Проект одного автора без известных релизов, ставится только из исходников через composer install. README не указывает автоматические тесты покрытия сверх phpunit из require-dev. Для боевой торговли обязательно нужно осознанно выставить TBANK_ALLOW_TRADING=true, по умолчанию она выключена намеренно.

Как отключить. Остановите PHP-процесс сервера и удалите его из конфигурации MCP клиента.

Частые вопросы

Можно ли сразу торговать боевым счетом?

Нет, по умолчанию TBANK_ALLOW_TRADING=false и торговые операции отключены, пока переменную не выставить явно.

Есть ли метод, которого нет отдельным эндпоинтом?

Да, универсальный вызов через /v1/tinvest/{service}/{method} или соответствующий MCP-инструмент покрывает весь каталог T-Invest, а в нем больше 90 методов.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

MCP-сервер для портфеля Т-Инвестиций без прав на сделки: позиции, операции, рыночные данные, техническая и фундаментальная аналитика

MCP-серверШирокий доступ3Звезды репозитория
Российский стек

MCP-сервер для Т-Инвестиций: портфель, операции и рыночные данные, с обязательной привязкой к одному счету и режимом песочницы

MCP-серверРасширенный доступ
Российский стек

Консольный MCP-сервер на C# для Т-Инвестиций: счета, портфель, дивиденды, операции и брокерские отчеты, только чтение

MCP-серверШирокий доступ
Российский стек

MCP-сервер для T-Invest API на Kotlin: рыночные данные, заявки и стоп-заявки, песочница с виртуальными деньгами

MCP-серверШирокий доступ13Звезды репозитория
Российский стек

Неофициальный локальный MCP-сервер Т-Инвестиций: анализ портфеля, подбор бумаг и план ребалансировки, заявки только после подтверждения

MCP-серверШирокий доступ1Звезды репозитория
Российский стек

MCP-сервер для Т-Инвестиций с анализом рынка, бэктестом пяти стратегий, риск-менеджментом и выставлением заявок, торговля выключена по умолчанию

MCP-серверШирокий доступ

Коротко о README

README на русском описывает PHP-обертку над официальным REST-прокси T-Invest API: каталог из более чем 90 методов, высокоуровневые REST-эндпоинты, MCP stdio и Streamable HTTP, песочницу и боевой контур с торговлей, выключенной по умолчанию. Дана таблица HTTP-маршрутов для здоровья процесса, каталога методов, счетов, инструментов, свечей, стакана и портфеля.

Бейдж для README

Сообщить о проблеме