T Bank Invest MCP Read Only

T-Bank Invest MCP Server (read-only)


MCP-сервер для работы с инвестиционным портфелем Т-Банка (Тинькофф) через AI-ассистентов. Предоставляет только чтение — сервер не может совершать сделки, выводить средства или изменять настройки счёта.

Возможности

• Портфель и счета — просмотр счетов, позиций, доходности, маржинальных показателей
• История операций — сделки, дивиденды, купоны, налоги, комиссии с фильтрацией и пагинацией
• Поиск инструментов — по тикеру, названию, ISIN, FIGI; детальная информация по акциям, облигациям, ETF, валютам, фьючерсам
• Рыночные данные — свечи (OHLCV), стакан заявок, статус торгов, цены закрытия
• Аналитика — технический анализ (SMA, EMA, RSI, MACD, Bollinger Bands), фундаментальные показатели (P/E, EPS, ROE), консенсус-прогнозы аналитиков
• Облигации — купонный календарь, НКД, события (амортизации, оферты)
• Дивиденды — история и предстоящие выплаты

Требования

• Python 3.11+
• Токен T-Bank Invest API — получить на tbank.ru/invest/settings/api

Установка

git clone 
cd t-bank-invest-mcp-read-only
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Использование

Токен передаётся через переменную окружения TBANK_INVEST_TOKEN. Сервер не загружает .env файл автоматически — переменную нужно экспортировать в shell или передать через конфигурацию MCP-клиента.

Claude Desktop / Claude Code

Добавьте в конфигурацию MCP-клиента:

• Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude Code: .claude/settings.json проекта или глобальные настройки

{
  "mcpServers": {
    "t-bank-invest": {
      "command": "/path/to/t-bank-invest-mcp-read-only/.venv/bin/t-bank-invest-mcp-read-only",
      "env": {
        "TBANK_INVEST_TOKEN": "your_token_here"
      }
    }
  }
}

Запуск напрямую

export TBANK_INVEST_TOKEN=your_token_here
t-bank-invest-mcp-read-only

Доступные инструменты

Счета и пользователь

Портфель и позиции

Операции

Инструменты

Рыночные данные

Заявки

Списки инструментов

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

• «Покажи мой портфель и общую доходность»
• «Какие дивиденды я получил за последний год?»
• «Найди облигации Газпрома и покажи купонный календарь»
• «Сравни P/E Сбера и ВТБ»
• «Построй RSI для AAPL за последние 3 месяца»
• «Какие у меня активные заявки?»

Лицензия

MIT