JungHoonGhae/tossinvest-cli

curl -fsSL https://raw.githubusercontent.com/JungHoonGhae/tossinvest-cli/main/install.sh | sh (macOS/Linux)
irm https://raw.githubusercontent.com/JungHoonGhae/tossinvest-cli/main/install.ps1 | iex (Windows PowerShell)
brew tap JungHoonGhae/tossinvest-cli && brew install tossctl (macOS)

Usage

• •tossctl auth login (QR/browser login; needs Google Chrome + Python) or tossctl openapi login for the official key
• •Register with an agent: claude mcp add tossctl tossctl mcp
• •Always run `tossctl order preview` before any trading mutation; live orders need --execute + --confirm <token>
• •tossctl doctor to verify setup; tossctl auth extend to renew the ~7-day session

Key features

• ✓Full account/portfolio/quote/order coverage for KR and US stocks via official Open API (auto-routed when connected) plus WTS fallback
• ✓39 features beyond the official API: quote flows, market indices, AI signals, condition-search screener, watchlist management, transaction ledger, real-time SSE push, KRW fractional orders, dry-run preview, tax/realized-P&L reports
• ✓MCP server exposes a fixed 3-tool catalog (list_operations / describe_operation / call_operation) so resident context cost stays constant regardless of operation count
• ✓Safety gates: trading disabled by default, config.json toggles + scopes (sell/fractional) + allow_live_order_actions master switch + per-order confirm token
• ✓MCP reads combine official API + WTS; writes (orders) always go through the official API path only

Best for

Korean retail investors using Toss Securities who want AI agents (Claude Code, Codex, Cursor, Copilot) to query accounts, screen markets, and run research in natural language.

Caveats

• ⚠NOT an official Toss product; non-Open-API features use Toss's internal web (WTS) APIs unofficially, which may violate Toss's terms of service — use at your own risk (account restriction possible)
• ⚠Trading features are ALL off after install; must be enabled per-feature in config.json
• ⚠WTS session needs phone-app approval to extend (~7-day active expiry); without 2nd confirmation the session expires after ~1h idle
• ⚠MCP exposes reads (official + WTS) but writes only via the official API path; real-time streaming and WTS writes are CLI-only
• ⚠Status: beta