io.github.kcw2034/toss-invest-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TOSS_BASE_URL | No | Override the API base URL (default: https://openapi.tossinvest.com) | |
| TOSS_CLIENT_ID | Yes | OAuth2 client ID for Toss Securities Open API | |
| TOSS_CLIENT_SECRET | Yes | OAuth2 client secret for Toss Securities Open API | |
| TOSS_DEFAULT_ACCOUNT | No | Optional fallback account number | |
| TOSS_HIGH_VALUE_NOTIONAL | No | Notional treated as high-value (default: 100000000) | |
| TOSS_MAX_ORDER_NOTIONAL_KRW | No | Reject KRW orders above this notional (default: 1000000) | |
| TOSS_MAX_ORDER_NOTIONAL_USD | No | Reject USD orders above this notional (default: 1000) | |
| TOSS_MAX_PRICE_DEVIATION_PCT | No | Reject LIMIT orders this far from market (default: 5.0) | |
| TOSS_REQUIRE_CONFIRM_HIGH_RISK | No | Require confirm=true for full liquidation / high-value orders (default: true) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_orderbookB | Get the order book (호가) for a symbol. |
| get_pricesB | Get current prices (현재가) for one or more symbols. |
| get_tradesA | Get recent executed trades (최근 체결 내역) for a symbol. |
| get_price_limitsA | Get the upper/lower price limits (상/하한가) for a symbol. |
| get_candlesC | Get candlestick chart data (캔들 차트). |
| get_stocksC | Get company master data / basic stock info (종목 기본 정보). |
| get_stock_warningsB | Get buy-caution warnings (매수 유의사항) for a symbol. |
| get_exchange_rateC | Get the exchange rate (환율). |
| get_market_calendar_krB | Get KR market operating calendar (국내 장 운영 정보). |
| get_market_calendar_usA | Get US market operating calendar (해외 장 운영 정보). |
| get_accountsB | List the user's accounts (계좌 목록). |
| get_holdingsA | Get holdings / owned stocks (보유 주식) for an account. |
| get_buying_powerB | Get available buying power (매수 가능 금액). |
| get_sellable_quantityB | Get sellable quantity (판매 가능 수량) for a symbol. |
| get_commissionsC | Get trading commissions (매매 수수료). |
| list_ordersC | List orders / order history (주문 목록). |
| get_orderC | Get order detail (주문 상세). |
| create_orderA | PLACES A REAL ORDER with real money. Subject to backend guardrails: Tier-1 caps (notional, price deviation) reject unconditionally; Tier-2 (full liquidation, high-value) returns a preview unless confirm=true. |
| modify_orderA | Modify an existing order (주문 정정). PLACES A REAL change. |
| cancel_orderA | Cancel an open order (주문 취소). Executes immediately (reduces exposure). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 20 tools
Each tool targets a distinct resource: market data tools for orderbook, prices, trades, candles, etc., and account/order tools for holdings, buying power, and order lifecycle. There is no overlap between get_orderbook, get_trades, get_prices, or get_order, and list_orders vs get_order are clearly list/detail.
All tools follow a consistent verb_noun pattern with verbs get, list, create, modify, and cancel. While list_orders uses 'list' instead of 'get', the pattern is predictable and uniform across the set.
20 tools is slightly above the ideal range, but the server covers two clear domains: market data (10 tools) and account/order management (10 tools). Each tool serves a distinct purpose, so the count feels justified rather than bloated.
The tool set covers the full trading lifecycle: market data retrieval, account information, and order management with create, modify, cancel, and query. No critical gaps exist; even sellable quantity and buying power are provided to support order placement.