Toss Invest MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Toss Invest MCP check my account balance"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Add credentials — create
.envin 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 ordersInstall —
uv syncConnect your MCP client — point any MCP client at the server using this command:
uv run --directory /path/to/toss-invest-mcp toss-invest-mcpOr 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 toolscancel_orderBDestructive
Cancel an open order. Requires TOSS_ENABLE_TRADING=true.
Inputs: order_id (required), account_seq. Returns: object
create_orderADestructive
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_accountsARead-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_powerARead-only
Get cash buying power (매수 가능 금액, excludes margin) for a currency (KRW or USD).
Inputs: currency (required), account_seq. Returns: object
get_candlesARead-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_commissionsARead-only
Get trading commission/fee rates (매매 수수료) by market for your account.
Inputs: account_seq. Returns: object
get_exchange_rateBRead-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_holdingsARead-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_calendarARead-only
Get KRX/NXT market operating calendar. date: YYYY-MM-DD (default today).
Inputs: date. Returns: object
get_orderARead-only
Get full detail for one order (any status), including partial-execution history.
Inputs: order_id (required), account_seq. Returns: object
get_orderbookARead-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_ordersARead-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_limitsARead-only
Get the upper/lower price limits (상/하한가) for a symbol.
Inputs: symbol (required). Returns: object
get_pricesARead-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_quantityBRead-only
Get the sellable quantity (매도 가능 수량) for a symbol in your account.
Inputs: symbol (required), account_seq. Returns: object
get_stocksARead-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_warningsARead-only
Get purchase warnings/cautions (매수 유의사항) for a symbol — 정리매매, 단기과열, 투자경고/위험, VI, 신주인수권 등.
Inputs: symbol (required). Returns: object
get_tradesARead-only
Get recent executed trades (체결 내역) for a symbol. count: max 50.
Inputs: symbol (required), count. Returns: object
get_us_market_calendarARead-only
Get US market operating calendar. date: YYYY-MM-DD (US local date, default today).
Inputs: date. Returns: object
modify_orderADestructive
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
Scored across 20 tools
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.
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.
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.
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
Related MCP Connectors
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
Unofficial Market Data App MCP — wraps the Market Data App API (marketdata.app)
Connect any MCP client to MetaTrader 4/5 to read prices, manage positions, and place trades.
JW3.ai remote MCP server for market reads and confirm-gated trading execution.
Related MCP Servers
- AlicenseCqualityCmaintenanceSafe-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.272MIT
- AlicenseBqualityBmaintenanceToss 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.36281 npm4MIT
- FlicenseAqualityDmaintenanceEnables interaction with Toss Securities API for market data, stock information, account details, and order management.20-
- AlicenseAqualityDmaintenanceMCP 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.28MIT