toss-invest-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DATA_DIR | No | Directory for token cache, ledger, logs, and kill switch. Default: ~/.local/state/toss-invest-mcp | ~/.local/state/toss-invest-mcp |
| NTFY_TOPIC | No | Phone confirmation code topic (make it long so it cannot be guessed) | |
| LISTEN_HOST | No | HTTP listen host. Default: 127.0.0.1 | 127.0.0.1 |
| LISTEN_PORT | No | HTTP listen port. Default: 8000 | 8000 |
| NTFY_SERVER | No | ntfy server URL. Default: https://ntfy.sh | https://ntfy.sh |
| PUBLIC_HOST | No | Public hostname behind the proxy (for Host header checking) | |
| TRADING_MODE | No | Trading mode: off / dry_run / live. Default: dry_run | dry_run |
| DAILY_MAX_KRW | No | Daily cumulative buy limit in KRW (KST). Default: unlimited | |
| DAILY_MAX_USD | No | Daily cumulative buy limit in USD (KST). Default: unlimited | |
| MAX_ORDER_KRW | No | Per-order buy limit in KRW (empty or 0/off means unlimited). Default: unlimited | |
| MAX_ORDER_USD | No | Per-order buy limit in USD (empty or 0/off means unlimited). Default: unlimited | |
| MCP_AUTH_TOKEN | No | HTTP Bearer token | |
| TOSS_CLIENT_ID | Yes | Toss Open API key (Client ID) (required) | |
| ALLOWED_ORIGINS | No | Allowed Origins. Default: claude.ai, localhost | claude.ai,localhost |
| ALLOWED_SYMBOLS | No | Comma-separated allowed symbols. Default: all | |
| MCP_PATH_SECRET | No | HTTP path secret (/<secret>/mcp) | |
| PREVIEW_TTL_SEC | No | Preview validity duration in seconds. Default: 300 | 300 |
| DAILY_MAX_ORDERS | No | Daily buy order count limit. Default: unlimited | |
| TOSS_ACCOUNT_SEQ | No | Account sequence to use when multiple accounts exist (default: first comprehensive trading account) | |
| TOSS_CLIENT_SECRET | Yes | Toss Open API key (Client Secret) (required) | |
| MARKET_ORDER_BUFFER | No | Market order amount estimation buffer. Default: 0.03 | 0.03 |
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| quoteA | 현재가 조회. symbols 는 콤마 구분 (예: 'AAPL,TSLA' 또는 '005930,000660'). 미국은 티커, 국내는 6자리 코드. |
| orderbookC | 호가(매수/매도 잔량) 조회. |
| candlesB | 캔들(OHLCV) 조회. interval 은 '1d'(일봉) 또는 '1m'(1분봉), count 최대 200. 최신 봉이 배열 첫 번째. |
| technicalsA | 기술 지표 요약: RSI(14, Wilder), 볼린저(20, 2σ), 이동평균 5/20/60, 1·5·20봉 등락률, 연속 상승/하락, 조회 구간 고점 대비 위치. 최근 120봉 기준. 마지막 봉이 진행 중이면 실시간 값이다. |
| stock_infoC | 종목 기본 정보: 이름, 시장, 통화, 상장 상태, 레버리지 배수(leverageFactor) 등. |
| market_hours_usA | 미국장 세션 시간(데이마켓/프리/정규/애프터, 전일·당일·익일). 모든 시간 KST. |
| kr_marketA | 국내 지수/국채 금리 현재가. 지원: KOSPI, KOSDAQ, KR_BOND_2Y/3Y/5Y/10Y/20Y/30Y. |
| fx_usdkrwA | 원/달러 환율 (토스 표시 환율, 1분 갱신. 실제 체결 환율과 다를 수 있음). |
| holdingsB | 보유 주식과 평가손익. symbol 을 주면 그 종목만. |
| buying_powerB | 현금 기준 매수 가능 금액 (미수 제외). |
| ordersA | 주문 목록. OPEN=미체결/진행 중 전체, CLOSED=종료된 주문 (limit 최대 100). |
| order_detailC | 주문 상세 (체결 수량, 평균 체결가, 수수료 등). |
| trading_statusA | 주문 안전장치 상태: 모드(off/dry_run/live), 킬스위치, 1회·일일 한도, 오늘 사용량, 허용 종목, 확인 방식. |
| preview_orderA | 주문 미리보기 (실제 주문 안 나감). 한도·잔고·매도가능수량을 검사하고 preview_id 를 돌려준다.
|
| order_logB | 이 서버가 남긴 최근 주문 관련 로그 (미리보기, 실행, 거절, 취소). |
| place_orderA | preview_order 로 만든 주문을 실행한다. 사용자가 미리보기를 보고 명시적으로 실행하라고 했을 때만 호출. 확인코드(폰 전송) 설정이면 사용자가 직접 입력한 6자리 코드를 confirm_code 로 넘긴다. 같은 preview_id 는 한 번만 실행된다. |
| cancel_orderA | 미체결 주문 취소. 위험을 줄이는 동작이라 킬스위치가 켜져 있어도 된다. dry_run 모드면 모의 취소. |
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 17 tools
Most tools have clearly distinct purposes (e.g., quote vs. orderbook vs. candles), but 'order_type' is highly ambiguous—it sounds like a parameter or enum rather than a tool, and its description mixes order types with quantity/price parameters. This could lead an agent to mistake it for a configuration tool or parameter documentation.
Names are predominantly snake_case and lowercase, but there is a mix of single nouns (quote, orderbook, candles) and verb_noun patterns (preview_order, place_order, cancel_order). The deviation is minor and still readable, with no camelCase or chaotic naming.
The server provides 17 tools (per list), which is slightly above the ideal 3–15 range but justified for a trading platform covering market data, account info, order lifecycle, and safety. Most tools earn their place, though 'order_type' may be unnecessary.
The surface covers core trading workflows: market data, holdings, buying power, order preview/place/cancel, and safety status. Minor gaps include a direct cash balance tool (buying_power approximates) and order modification, but these are workable and not critical for the stated purpose.