How do I install T Bank Invest (read Only)?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does T Bank Invest (read Only) need an API key?

The publisher lists these environment variables: TBANK_INVEST_TOKEN.

What transport does T Bank Invest (read Only) use?

T Bank Invest (read Only) runs locally over stdio.

When was T Bank Invest (read Only) last checked?

Last checked 2026-11-09. Read-only T-Bank (Tinkoff) Invest API: portfolio, operations, instruments, market data.

T Bank Invest (read Only) MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx t-bank-invest-mcp-read-only==1.0.0

Credentials from the publisher

TBANK_INVEST_TOKEN — T-Invest API token; a read-only one is enough (tbank.ru/invest/settings/api)

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1TBANK_INVEST_TOKEN=<secret> claude mcp add io.github.sicness-t-bank-invest-mcp-read-only -- uvx t-bank-invest-mcp-read-only==1.0.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.sicness-t-bank-invest-mcp-read-only": {4      "command": "uvx",5      "args": [6        "t-bank-invest-mcp-read-only==1.0.0"7      ],8      "env": {9        "TBANK_INVEST_TOKEN": "<secret>"10      }11    }12  }13}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.0.0
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

T-Bank Invest MCP Server (read-only)

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

Возможности

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

Требования

uv — запускает сервер одной командой: сам подбирает Python 3.11+ и ставит зависимости в изолированное окружение
Токен T-Invest API — выпустить на tbank.ru/invest/settings/api

Какой токен выпускать

Выпускайте токен только для чтения (readonly). Сервер вызывает только методы чтения, права на сделки ему не нужны, а с таким токеном торговые поручения невозможны уже на стороне Т-Банка — это вторая линия защиты помимо кода сервера. Токен можно дополнительно ограничить одним счётом.

MCP-клиенты хранят токен в своей конфигурации открытым текстом — ещё одна причина не давать ему прав на сделки.

Подключение

Сервер опубликован на PyPI: клонировать репозиторий не нужно, uvx скачает и запустит его сам. Токен передаётся через переменную окружения TBANK_INVEST_TOKEN в конфигурации MCP-клиента.

Claude Code

claude mcp add t-bank-invest -e TBANK_INVEST_TOKEN=your_token_here -- uvx t-bank-invest-mcp-read-only

По умолчанию сервер подключается только к текущему проекту; чтобы он был доступен во всех проектах, добавьте --scope user. С --scope project конфигурация вместе с токеном записывается в .mcp.json в корне проекта — не коммитьте этот файл.

Claude Desktop

Добавьте сервер в claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) и перезапустите приложение:

{
  "mcpServers": {
    "t-bank-invest": {
      "command": "uvx",
      "args": ["t-bank-invest-mcp-read-only"],
      "env": {
        "TBANK_INVEST_TOKEN": "your_token_here"
      }
    }
  }
}

Если Claude Desktop не находит uvx, укажите в command полный путь к нему (его покажет which uvx).

Другие MCP-клиенты

Сервер работает по stdio. В любом клиенте укажите ту же команду, те же аргументы и переменную окружения, что в примере для Claude Desktop.

Сервер также есть в реестре MCP-серверов под именем io.github.Sicness/t-bank-invest-mcp-read-only.

Конкретная версия

uvx берёт последнюю версию с PyPI и обновляется сам. Чтобы закрепить версию, укажите её после имени — [email protected]; что менялось от версии к версии — в истории изменений.

Ещё не выпущенное состояние ветки main: uvx --from git+https://github.com/Sicness/t-bank-invest-mcp-read-only t-bank-invest-mcp-read-only.

Установка из исходников

Для разработки или если uv не подходит:

git clone https://github.com/Sicness/t-bank-invest-mcp-read-only.git
cd t-bank-invest-mcp-read-only
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[test]"

В конфигурации MCP-клиента тогда указывается полный путь к команде: /path/to/t-bank-invest-mcp-read-only/.venv/bin/t-bank-invest-mcp-read-only, без args.

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

Сервер не загружает .env файл — переменную нужно экспортировать в shell:

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

Из установленного окружения то же самое делает команда t-bank-invest-mcp-read-only или python -m tbank_invest_mcp.

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

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

Инструмент	Описание
`get_accounts`	Список инвестиционных счетов
`get_user_info`	Тариф, статус квал. инвестора, уровень риска
`get_margin_attributes`	Маржинальные показатели счёта

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

Инструмент	Описание
`get_portfolio`	Полный портфель с ценами и доходностью; у позиций опущены нулевые поля
`get_positions`	Балансы позиций без расчёта цен
`get_withdraw_limits`	Доступные средства для вывода

Операции

Инструмент	Описание
`get_operations`	История операций за период
`get_operations_by_cursor`	История операций с пагинацией и расширенными фильтрами

Инструменты

Инструмент	Описание
`find_instrument`	Поиск по тикеру, названию, ISIN, FIGI. По умолчанию — только торгуемые через API бумаги, не больше 20; есть фильтр по типу инструмента
`get_instrument_by`	Детальная информация по идентификатору
`get_bond_by`	Информация об облигации
`get_share_by`	Информация об акции
`get_etf_by`	Информация об ETF/фонде
`get_currency_by`	Информация о валютном инструменте
`get_future_by`	Информация о фьючерсном контракте
`get_bond_coupons`	Купонный календарь облигации
`get_bond_events`	События облигации: купоны, оферты, погашение, конвертации; фильтр по типу и периоду
`get_dividends`	История и будущие дивиденды
`get_accrued_interests`	НКД (накопленный купонный доход)
`get_asset_fundamentals`	P/E, EPS, ROE, капитализация
`get_consensus_forecasts`	Консенсус-прогноз аналитиков по одному инструменту (сканирует страницы и фильтрует по `instrument_id` — UID инструмента или актива, т.к. сам API не умеет фильтровать на своей стороне)
`get_forecast_by`	Прогнозы инвестдомов по инструменту
`get_asset_reports`	Даты отчётностей эмитента
`get_stock_snapshot`	Сводка по акции одним вызовом: резолвит тикер → UID → UID актива и объединяет фундаментал, изменение цены за N торговых сессий и консенсус-прогноз
`get_favorites`	Избранные инструменты пользователя
`get_trading_schedules`	Расписание торгов бирж

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

Инструмент	Описание
`get_candles`	Исторические свечи (OHLCV) строками `[время, open, high, low, close, объём, покупки, продажи]`
`get_last_prices`	Последние цены сделок
`get_close_prices`	Цены закрытия предыдущей сессии
`get_order_book`	Стакан заявок (bids/asks)
`get_trading_status`	Текущий статус торгов
`get_tech_analysis`	Технические индикаторы (SMA, EMA, RSI, MACD, BB)

Заявки

Инструмент	Описание
`get_orders`	Активные заявки на счёте
`get_order_state`	Статус конкретной заявки

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

Инструмент	Описание
`list_shares`	Полный справочник акций — около 2 МБ
`list_bonds`	Полный справочник облигаций — около 2,4 МБ
`list_etfs`	Полный справочник ETF/фондов — около 300 КБ
`list_currencies`	Все валютные инструменты — около 13 КБ
`list_futures`	Полный справочник фьючерсов — около 700 КБ

Справочники, кроме валютного, — выгрузки для скриптов: в контекст модели они не помещаются, клиент сохранит такой ответ в файл или отклонит его. Чтобы найти бумагу, используйте find_instrument.

Формат данных

Ответы рассчитаны на то, что их читает модель, поэтому сервер не пересылает ответ API как есть:

Цены и суммы — обычные числа, а не пары units/nano. Валюта указана один раз, в поле currency того же объекта; сумма в другой валюте записана как {"value": ..., "currency": ...}.
В списках позиций, операций и событий облигаций опущены нулевые и пустые поля. Отсутствие поля означает ноль, «нет» или пусто.
Инструмент можно назвать как угодно: тикером, FIGI, ISIN или UID — в любом параметре, который принимает инструмент. Если под одним тикером торгуются разные бумаги (T — это и Т-Технологии, и AT&T), сервер попросит уточнить в виде ТИКЕР_КЛАСС, например T_TQBR. По названию ищет find_instrument.
Даты — в UTC. Дата без времени в to_date включает весь этот день.

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

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

Лицензия

MIT

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install T Bank Invest (read Only)?

Does T Bank Invest (read Only) need an API key?

What transport does T Bank Invest (read Only) use?

When was T Bank Invest (read Only) last checked?

Documentation

T-Bank Invest MCP Server (read-only)

Возможности

Требования

Какой токен выпускать

Подключение

Claude Code

Claude Desktop

Другие MCP-клиенты

Конкретная версия

Установка из исходников

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

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

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

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

Операции

Инструменты

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

Заявки

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

Формат данных

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

Лицензия