t-invest-skill

A CLI and skill giving an agent access to a T-Investments account: portfolio, returns, bond screeners and confirmed orders

SkillHigh riskRussian stack

nyxandro/t-invest-skill

Install

curl -fsSL https://raw.githubusercontent.com/nyxandro/t-invest-skill/main/install.sh | bash

Linux, macOS, WSL. Installs into ~/.agents/skills and ~/.claude/skills and creates a ~/.config/tinvest/.env template.

This is third-party code. Review the repository files before installing.

What it does

The agent calls a bundled CLI over the T-Invest API and answers from real account data: positions and P/L, XIRR returns, portfolio structure, coupon and dividend calendar, quotes, order book and technical indicators. It has bond and stock screeners, YTM and duration calculations, news and an earnings calendar. Orders are free in the sandbox; on a live account they need the T_INVEST_ALLOW_TRADING flag and confirmation of each trade.

Who it is for. For T-Investments clients who want to ask an agent about their portfolio and the market in plain language.

Good fit when

  • You want real portfolio returns accounting for deposits
  • You want to screen bonds by yield, term and risk
  • You want a coupon and dividend calendar

Not a fit when

  • You want personal investment advice: the tool does not provide it
  • You are not ready to give an agent a token with trading rights

Example request

What is my portfolio's real return over the year and what share is in bonds?

Limitations

Requires Node.js 20+ and T-Invest API tokens for the chosen mode. Transfers and withdrawals are not supported. YTM is not computed for floaters, amortizing and perpetual bonds. Mode separation protects the standard paths, but the environment owner can enable trading without confirmations.

How to disable. Remove the t-invest folder from ~/.agents/skills or ~/.claude/skills. Tokens live in ~/.config/tinvest/.env and can be revoked in the T-Investments account.

Security check

  • Accesses a brokerage account and can place real orders
  • Installs via curl | bash
  • Stores T-Invest API tokens in a local file

README in short

The README describes a CLI and skill for the T-Invest API packaged as a single file with no npm dependencies. Install via install.sh or by unpacking the t-invest.skill archive. It details token modes, the trading gate ladder, a liquidity guard, idempotency keys and a trade audit log. At the start of each conversation the skill asks for the mode, defaulting to readonly. The project is not an investment adviser.

FAQ

Can the agent withdraw money?

No. A Trading-level token and no transfer methods in the code limit operations to trading securities within the account.

Which modes exist?

sandbox with a virtual account, readonly for reading only, and full for real trades, each with its own token.

Unofficial MCP server and skills for a personal T-Bank account: accounts, transfers, bill pay, tickets and groceries

MCP serverHigh riskRussian stack29

A Go library and zm CLI for the ZenMoney API, with a Claude Code skill that answers personal finance questions

CLIMedium riskRussian stack2