JungHoonGhae/tossinvest-cli

What it solves

tossinvest-cli provides a flexible way to connect to Toss Securities, enabling users to manage accounts, check market quotes, and execute trades via a command-line interface (CLI) or as a Model Context Protocol (MCP) server for AI agents. It bridges the gap between the limited official Open API and the full feature set available in the Toss web trading system (WTS), offering significantly more capabilities than the official API alone.

How it works

The tool is built with Go and operates as a hybrid routing system. It can use the official Open API for supported functions or route requests through the Toss web application's internal APIs (WTS). Users authenticate via a browser-based QR login or link login. To ensure security, trading functions are disabled by default and must be explicitly enabled in a config.json file. It also includes a session extension mechanism (tossctl auth extend) to maintain connectivity without frequent re-logins.

Who it’s for

• AI Agent Users: Those using Claude Code, Cursor, Gemini, or GitHub Copilot who want their agents to handle securities trading and market analysis using the MCP server.
• Developers and Automators: Users who need a CLI for scripting, automation, or accessing advanced data like real-time pushes and detailed portfolio performance that isn't in the official API.
• Retail Investors: Users of Toss Securities who want a programmatic way to manage their investments.

Highlights

• Expanded Capability: Covers 100% of the official Open API plus 58 additional unique capabilities (e.g., AI signals, condition searches, and detailed ledger history).
• AI Agent Integration: Native support for MCP, allowing AI agents to interact with Toss Securities using natural language.
• Hybrid Routing: Seamlessly switches between official API and WTS internal APIs.
• Safety First: Trading mutations require explicit configuration and a dry-run preview before execution.
• Comprehensive Data: Access to real-time pushes (SSE), crypto prices with "Kimchi premium," and detailed tax reports for overseas stocks.