toss-invest-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TOSS_BASE_URL | No | API 베이스 URL (기본: https://openapi.tossinvest.com) | |
| TOSS_CLIENT_ID | Yes | OAuth2 클라이언트 ID (필수) | |
| TOSS_ACCOUNT_SEQ | No | 계좌 툴에서 accountSeq 생략 시 사용할 기본 계좌 (선택) | |
| TOSS_CLIENT_SECRET | Yes | OAuth2 클라이언트 시크릿 (필수) |
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
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_pricesC | 종목 현재가 조회. 여러 종목을 한 번에 조회할 수 있습니다. |
| get_orderbookC | 종목 호가(orderbook) 조회. |
| get_tradesC | 종목 최근 체결 내역 조회. |
| get_price_limitsC | 종목 상한가/하한가 조회. |
| get_candlesC | 종목 캔들 차트 조회. before로 페이지네이션 (응답의 nextBefore 사용). |
| get_rankingsC | 주식 랭킹 조회 (거래대금/거래량/상승률/하락률 등). |
| get_stocksB | 종목 기본 정보 조회 (이름, 시장, 통화 등). 여러 종목 동시 조회 가능. |
| get_stock_warningsC | 종목 매수 유의사항 조회 (투자유의/거래정지 등). |
| get_exchange_rateD | 환율 조회. |
| get_market_calendarC | 장 운영 정보 조회 (개장 여부, 운영 시간). |
| get_market_indicator_pricesC | 시장 지표 현재가 조회 (KOSPI, KOSDAQ 등 지수). |
| get_market_indicator_candlesC | 시장 지표 캔들 차트 조회. |
| get_investor_tradingC | 투자자별 매매대금 조회 (개인/외국인/기관, KOSPI·KOSDAQ만 지원). |
| get_accountsA | 계좌 목록 조회. 다른 계좌 관련 툴에 필요한 accountSeq를 얻습니다. |
| get_holdingsC | 보유 주식 조회. |
| get_buying_powerC | 매수 가능 금액 조회. |
| get_sellable_quantityC | 판매 가능 수량 조회. |
| get_commissionsC | 매매 수수료 조회. |
| list_ordersC | 주문 목록 조회. status=OPEN(진행 중) 또는 CLOSED(완료/취소). |
| get_orderB | 주문 상세 조회 (체결 내역 포함). |
| create_orderA | 주문 생성 (매수/매도). ⚠️ 실제 주문이 접수됩니다. 수량 기반(quantity) 또는 금액 기반(orderAmount, US 시장가 전용) 중 하나를 사용하세요. 1억원 이상 주문은 confirmHighValueOrder=true 필요. |
| modify_orderB | 주문 정정 (가격/수량 변경). ⚠️ 실제 주문이 변경됩니다. |
| cancel_orderA | 주문 취소. ⚠️ 실제 주문이 취소됩니다. |
| create_conditional_orderA | 조건주문 생성 (스탑로스/익절 등). ⚠️ 조건 충족 시 실제 주문이 실행됩니다. SINGLE: first만, OCO/OTO: first+second 필요. |
| list_conditional_ordersC | 조건주문 목록 조회. |
| get_conditional_orderC | 조건주문 상세 조회. |
| modify_conditional_orderB | 조건주문 수정. ⚠️ 실제 조건주문이 변경됩니다. 타입 전환(SINGLE→OCO 등) 가능. |
| cancel_conditional_orderA | 조건주문 취소. ⚠️ 실제 조건주문이 취소됩니다. |
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 28 tools
Each tool has a clearly distinct purpose targeting specific resource-action pairs. There is no ambiguity between tools like cancel_order and cancel_conditional_order, or create_order and create_conditional_order, as they handle different order types.
All tools follow a consistent verb_noun pattern in snake_case (e.g., cancel_order, get_accounts, list_conditional_orders). The naming is predictable and reflects the action and resource clearly.
With 28 tools, the count is slightly above the typical well-scoped range, but given the comprehensive nature of a trading platform covering orders, conditional orders, market data, and account management, each tool serves a necessary function. It is not excessive for the domain.
The tool set covers the full lifecycle of trading operations: account information, order placement and modification, conditional orders, market data (candles, orderbook, prices, rankings), and ancillary data (calendar, exchange rate, commissions). No obvious gaps exist for standard trading workflows.