Skip to main content
Glama
Toss Invest MCP

Toss Invest MCP

by takeachangs

Toss Invest MCP

A personal MCP server for the Toss Securities Open API. It lets any MCP client read market data and your account, and (optionally) place real-money orders.

Built with FastMCP; runs locally over stdio.

Setup

  1. Add credentials — create .env in the project root with keys from Toss Securities WTS (Settings → Open API):

    API_KEY="tsck_live_..."      # client_id
    SECRET_KEY="tssk_live_..."   # client_secret
    # TOSS_ACCOUNT_SEQ=          # optional: default account
    # TOSS_ENABLE_TRADING=true   # optional: allow placing orders
  2. Install — uv sync

  3. Connect your MCP client — point any MCP client at the server using this command:

    uv run --directory /path/to/toss-invest-mcp toss-invest-mcp

    Or in your client's JSON config:

    {
      "mcpServers": {
        "toss-invest": {
          "command": "uv",
          "args": ["run", "--directory", "/path/to/toss-invest-mcp", "toss-invest-mcp"]
        }
      }
    }

Related MCP server: tossinvest-mcp

Tools

Market data: get_prices, get_orderbook, get_trades, get_candles, get_price_limits, get_stocks, get_stock_warnings, get_exchange_rate, get_kr_market_calendar, get_us_market_calendar

Account: get_accounts, get_holdings, get_buying_power, get_sellable_quantity, get_commissions, get_orders, get_order

Trading (only when TOSS_ENABLE_TRADING=true): create_order, modify_order, cancel_order

Account tools take an account_seq — call get_accounts to find yours, or set TOSS_ACCOUNT_SEQ in .env.

Safety

  • Trading tools place real-money orders and are off by default — they only work with TOSS_ENABLE_TRADING=true.

  • Orders ≥ 100M KRW require confirm_high_value_order=true.

  • Credentials stay in your local .env (git-ignored); nothing is hosted.

Available Tools

20 tools
cancel_orderB
Destructive

Cancel an open order. Requires TOSS_ENABLE_TRADING=true.

Inputs: order_id (required), account_seq. Returns: object

create_orderA
Destructive

Place a REAL-MONEY order. Requires TOSS_ENABLE_TRADING=true.

Provide exactly one of:

  • quantity: shares as an integer string (e.g. "10").

  • order_amount: dollar amount string — US MARKET orders only, regular hours only. LIMIT requires price; MARKET must omit price. price — KR: integer won matching the tick size; US: up to 4 dp (<$1) or 2 dp (>=$1). time_in_force: DAY (default) or CLS (US LIMIT only). client_order_id: idempotency key (<=36 chars, [A-Za-z0-9_-], valid 10 min). Orders >= 100M KRW require confirm_high_value_order=true.

Inputs: side (required), symbol (required), order_type (required), price, +6 more. Returns: object

get_accountsA
Read-only

List your active accounts. The returned accountSeq is the value used as account_seq (the X-Tossinvest-Account header) by every account-scoped tool. Call this first to discover your account(s).

Inputs: no named parameters. Returns: object

get_buying_powerA
Read-only

Get cash buying power (매수 가능 금액, excludes margin) for a currency (KRW or USD).

Inputs: currency (required), account_seq. Returns: object

get_candlesA
Read-only

Get candlestick chart data (캔들).

interval: "1m" (minute) or "1d" (daily). count: max 200. before: ISO 8601 cursor (exclusive) — pass the previous response's nextBefore to paginate. adjusted: apply adjusted prices (수정주가).

Inputs: symbol (required), interval (required), count, before, +1 more. Returns: object

get_commissionsA
Read-only

Get trading commission/fee rates (매매 수수료) by market for your account.

Inputs: account_seq. Returns: object

get_exchange_rateB
Read-only

Get the reference exchange rate between two currencies (e.g. base USD / quote KRW).

date_time: optional ISO 8601 timestamp to query a historical rate.

Inputs: base_currency (required), quote_currency (required), date_time. Returns: object

get_holdingsA
Read-only

Get holdings/positions (보유 주식) with per-symbol P&L and an account summary.

account_seq: defaults to TOSS_ACCOUNT_SEQ if unset. symbol: optional single-holding filter.

Inputs: symbol, account_seq. Returns: object

get_kr_market_calendarA
Read-only

Get KRX/NXT market operating calendar. date: YYYY-MM-DD (default today).

Inputs: date. Returns: object

get_orderA
Read-only

Get full detail for one order (any status), including partial-execution history.

Inputs: order_id (required), account_seq. Returns: object

get_orderbookA
Read-only

Get the bid/ask orderbook (호가) for a symbol.

symbol: KRX 6-digit code (e.g. 005930) or US ticker (e.g. AAPL).

Inputs: symbol (required). Returns: object

get_ordersA
Read-only

List orders by lifecycle group. status: OPEN (in-progress) or CLOSED (finished).

from_date/to_date: YYYY-MM-DD (KST, by order time). cursor/limit apply to CLOSED only (limit default 20, max 100; ignored for OPEN, which returns all).

Inputs: status (required), limit, cursor, symbol, +3 more. Returns: object

get_price_limitsA
Read-only

Get the upper/lower price limits (상/하한가) for a symbol.

Inputs: symbol (required). Returns: object

get_pricesA
Read-only

Get current prices (현재가) for up to 200 symbols.

symbols: comma-separated, e.g. "005930,000660" or "AAPL,MSFT".

Inputs: symbols (required). Returns: object

get_sellable_quantityB
Read-only

Get the sellable quantity (매도 가능 수량) for a symbol in your account.

Inputs: symbol (required), account_seq. Returns: object

get_stocksA
Read-only

Get reference info (name, market, currency, listing status, shares outstanding) for up to 200 symbols. symbols: comma-separated, e.g. "005930,AAPL".

Inputs: symbols (required). Returns: object

get_stock_warningsA
Read-only

Get purchase warnings/cautions (매수 유의사항) for a symbol — 정리매매, 단기과열, 투자경고/위험, VI, 신주인수권 등.

Inputs: symbol (required). Returns: object

get_tradesA
Read-only

Get recent executed trades (체결 내역) for a symbol. count: max 50.

Inputs: symbol (required), count. Returns: object

get_us_market_calendarA
Read-only

Get US market operating calendar. date: YYYY-MM-DD (US local date, default today).

Inputs: date. Returns: object

modify_orderA
Destructive

Modify an open order's price/quantity. Requires TOSS_ENABLE_TRADING=true.

KR stocks: quantity required (positive integer string). US stocks: quantity not supported (omit it). LIMIT requires price; MARKET must omit price.

Inputs: order_id (required), order_type (required), price, quantity, +2 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 20 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose: market data (orderbook, prices, trades, limits, candles), reference info (stocks, warnings, exchange rate, calendars), account info (accounts, holdings, orders, buying power, sellable quantity, commissions), and order actions (create/modify/cancel). There is no overlap or ambiguity between tools.

    Naming Consistency5/5

    All tools follow a consistent snake_case verb_noun pattern: get_* for queries, and create_order/modify_order/cancel_order for order actions. This makes the API predictable and easy to navigate.

    Tool Count3/5

    20 tools falls in the 16-25 range, which is considered heavy. While each tool earns its place and serves a distinct function, the overall count is on the high side and might feel overwhelming for a single server.

    Completeness5/5

    The tool surface covers the full lifecycle for trading: market data, reference info, account discovery, holdings, order management, buying power, sellable quantity, and commissions. There are no obvious gaps or dead ends for the core investing workflow.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      C
      maintenance
      Safe-by-default MCP server for the official Toss Securities Open API, providing read-only market and account data with optional order operations protected by multiple safety gates.
      27
      2
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Toss Securities (토스증권) Open API MCP server for the Korean stock market. Supports real-time quotes, orderbook, candles, account holdings, buying power, and order management (create/modify/cancel) with a built-in safety gate requiring explicit confirmation before any real order is placed.
      36
      281 npm
      4
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Enables interaction with Toss Securities API for market data, stock information, account details, and order management.
      20
      -
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for Toss Securities Open API that exposes Korean (KRX) and US market data, portfolio holdings, order management, and conditional orders through 28 tools, with read-only and authenticated remote modes.
      28
      MIT