JungHoonGhae/tossinvest-cli

공식 API에 없는 30+ 기능까지, 터미널과 AI에서 쓰세요. 토스증권 비공식 CLI·MCP.

What it solves

This project provides a command-line interface (CLI) and Model Context Protocol (MCP) server to access Toss Securities investment data. It bridges the gap between the official Open API and the full range of information available on the Toss Securities web platform (WTS), allowing users to access over 30 additional features—such as AI signals, dividend history, and tax data—that are not available via the official API.

How it works

tossctl acts as a wrapper that connects to both the official Open API and the unofficial web internal API (WTS). It allows users to authenticate via phone authentication and maintain a session. Once connected, it can be used as a standalone CLI tool for scripts and terminal queries, or as an MCP server that connects AI agents (like Claude Code, Cursor, or Codex) to the user's investment data, enabling natural language queries about assets, news, and performance.

Who it’s for

Investors using Toss Securities who want to automate their portfolio tracking, integrate their financial data into AI-driven workflows, or access advanced investment analysis tools directly from their terminal.

Highlights

  • Extended Feature Set: Accesses 30+ functions not in the official API, including AI signals, earning calls, and tax information.
  • AI Agent Integration: Built-in MCP server support for seamless connection to AI agents like Claude Code and Cursor.
  • Hybrid API Approach: Prioritizes official Open API keys when available, falling back to WTS internal APIs for extended features.
  • Safety First: Real trading is disabled by default; orders must be previewed and manually approved by the user.
  • Local History: Ability to sync and search investment history offline.

Related

  • Project
    zerodha/kite-mcp-server

    An MCP server that gives AI assistants secure access to the Kite Connect trading API for market data retrieval, portfolio management, and trade execution.

  • Project
    atilaahmettaner/tradingview-mcp

    A Python‑only server that exposes 39 market‑data, technical‑analysis, screener and back‑testing tools via the Model Context Protocol (MCP). AI assistants (Claude, ChatGPT, Cursor, Copilot, etc.) can call these tools with natural language prompts and receive live data, indicator tables, or interactive charts inside the chat. Self‑hosted for free (MIT license) or available as a hosted SaaS (TradingMCP) for $9 / mo.

  • Project
    ferdousbhai/investor-agent

    An MCP server that provides AI assistants with tools to fetch real-time financial data, stock fundamentals, and technical indicators for investment research.

  • Project
    6551Team/opennews-mcp

    An MCP server that gives AI assistants real-time access to 85+ financial and crypto data sources with AI-analyzed impact scores and trading signals.

  • Project
    okx/agent-trade-kit

    OKX Agent Trade Kit is an open‑source, AI‑enabled toolkit that lets LLM assistants (Claude, Cursor, etc.) control an OKX crypto account via the Model Context Protocol. It provides a local MCP server (`okx-trade-mcp`) exposing 170+ trading tools across market data, spot/swap/futures/options, bots, earn products, news, and smart‑money analytics, plus a matching CLI (`okx-trade-cli`). The system runs locally, keeping API keys private, and includes safety flags, ready‑made AI‑agent skill files, and MIT licensing.