T-Bank Invest (read-only)

T-Bank Invest MCP 服务（只读）

通过 AI 助手操作 T-Bank（Tinkoff）投资组合的 MCP 服务。仅提供读取功能——服务无法进行交易、提取资金或更改账户设置。

功能

• 投资组合和账户——查看账户、持仓、收益率和保证金指标
• 操作历史——交易、股息、票息、税费和佣金，支持筛选和分页
• 工具搜索——按代码、名称、ISIN、FIGI 搜索；查看股票、债券、ETF、货币和期货的详细信息
• 市场数据——K 线（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）令牌。服务只调用读取方法，不需要交易权限；使用此类令牌后，T-Bank 端也会禁止交易指令，这是除服务代码之外的第二道防线。还可以将令牌限制为只能访问一个账户。

MCP 客户端会以明文形式在配置中存储令牌——这也是不应授予令牌交易权限的另一个原因。

连接

服务已发布到 PyPI：无需克隆代码库，uvx 会自行下载并启动。令牌通过 MCP 客户端配置中的环境变量 TBANK_INVEST_TOKEN 传递。

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 筛选——该 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 MB
list_bonds	完整债券目录——约 2.4 MB
list_etfs	完整 ETF/基金目录——约 300 KB
list_currencies	所有货币工具——约 13 KB
list_futures	完整期货目录——约 700 KB

除货币目录外，这些目录都是供脚本使用的导出文件：无法放入模型上下文，客户端会将此类响应保存到文件或拒绝响应。要查找证券，请使用 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