PHP REST API и MCP для Т-Инвестиций
tbank_mcp_and_api
PHP-обертка над T-Invest API: REST-эндпоинты и MCP-сервер с общим каталогом на 90+ методов, торговля выключена по умолчанию
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- При включении TBANK_ALLOW_TRADING сервер может выставлять и отменять заявки на реальном счете
- Универсальный вызов дает доступ к любому методу T-Invest API, а не только к безопасному поднабору
Установка
Ручная установка
composer install && cp .env.example .envУстановка из исходников и настройка окружения перед запуском.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект дает и обычный 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 в Т-Инвестициях и последние свечи за часОграничения
Проект одного автора без известных релизов, ставится только из исходников через composer install. README не указывает автоматические тесты покрытия сверх phpunit из require-dev. Для боевой торговли обязательно нужно осознанно выставить TBANK_ALLOW_TRADING=true, по умолчанию она выключена намеренно.
Как отключить. Остановите PHP-процесс сервера и удалите его из конфигурации MCP клиента.
MCP
- Транспорт
- stdio, http, sse
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| TBANK_INVEST_TOKEN обязательная, секрет | Токен T-Invest API. |
| TBANK_INVEST_ENV обязательная | Режим: sandbox или production. |
| TBANK_ALLOW_TRADING | Включает торговые операции, по умолчанию false. |
Проверка безопасности
- При включении TBANK_ALLOW_TRADING сервер может выставлять и отменять заявки на реальном счете
- Универсальный вызов дает доступ к любому методу T-Invest API, а не только к безопасному поднабору
Коротко о README
README на русском описывает PHP-обертку над официальным REST-прокси T-Invest API: каталог из 90+ методов, высокоуровневые REST-эндпоинты, MCP stdio и Streamable HTTP, песочницу и боевой контур с торговлей, выключенной по умолчанию. Дана таблица HTTP-маршрутов для здоровья процесса, каталога методов, счетов, инструментов, свечей, стакана и портфеля.
Частые вопросы
Можно ли сразу торговать боевым счетом?
Нет, по умолчанию TBANK_ALLOW_TRADING=false и торговые операции отключены, пока переменную не выставить явно.
Есть ли метод, которого нет отдельным эндпоинтом?
Да, универсальный вызов через /v1/tinvest/{service}/{method} или соответствующий MCP-инструмент покрывает весь каталог из 90+ методов T-Invest.
Похожие
Набор скиллов для инвестиционного исследования компаний в Claude Code и Codex по методологиям четырех инвесторов. Это исследовательский инструмент, не инвестици
Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта
Официальный MCP-сервер брокера Alpaca: заявки по акциям, ETF, крипте и опционам, управление позициями и рыночные данные на естественном языке
inn-check-ru: светофор риска по ИНН
inn-check-ru
Открытый скилл, который по ИНН сверяет ЕГРЮЛ, ФССП, суды, банкротства и санкции сразу по нескольким источникам и выдает светофор риска с датой и причиной