tossinvest-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TOSSINVEST_ACCOUNT | No | 기본으로 사용할 토스증권 accountSeq. 미설정 시 1 | 1 |
| TOSSINVEST_API_KEY | Yes | 토스증권 Open API 화면의 API Key | |
| TOSSINVEST_BASE_URL | No | 기본값은 https://openapi.tossinvest.com | https://openapi.tossinvest.com |
| TOSSINVEST_SECRET_KEY | Yes | 토스증권 Open API 화면의 Secret Key | |
| TOSSINVEST_YOLO_TRADING | No | true로 설정하면 주문 도구에서 confirmOrderAction 없이도 API를 호출합니다. 권장하지 않습니다 | |
| TOSSINVEST_ENABLE_TRADING | No | 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
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| toss_get_orderbookB | Get orderbook data for one KRX or US stock symbol. |
| toss_get_pricesA | Get current prices for up to 200 comma-separated KRX or US stock symbols. |
| toss_get_tradesB | Get recent trades for one KRX or US stock symbol. Optional count defaults to 20 (max 50); set the needed count on the first call. |
| toss_get_price_limitsB | Get upper and lower price limits for one KRX or US stock symbol. |
| toss_get_candlesB | KR/US stock 1-minute or daily OHLCV. count defaults to 20 (max 200); set it on the first call. Pass nextBefore as before (ISO 8601 with timezone). |
| toss_get_stocksA | Get stock master data for up to 200 comma-separated KRX or US stock symbols. |
| toss_get_stock_warningsA | Get buy warning flags for one KRX or US stock symbol. |
| toss_get_exchange_rateB | Get KRW/USD or USD/KRW exchange rate. Optional dateTime is ISO 8601 with timezone. |
| toss_get_kr_market_calendarB | Get Korean market calendar and session hours. date is optional YYYY-MM-DD. |
| toss_get_us_market_calendarB | Get US market calendar and session hours. date is optional YYYY-MM-DD in US local date. |
| toss_list_stocksA | 거래소별 토스 거래 가능 종목 전체를 심볼순으로 반환합니다. 페이지 없음; status·securityType·commonShare로 좁히세요. 개별 종목 상세는 toss_get_stocks. |
| toss_get_stock_investor_tradingA | 국내 종목의 투자자별 일별 매수·매도·순매수 거래량(주). KRX·NXT 합산, 외국인은 등록 기준. 기관 세부·외국인 보유·CFD 포함. 장중 잠정치에서 미제공 항목은 null; updatedAt 확인. 다음 페이지: nextUntil → until. |
| toss_get_stock_program_tradesA | 국내 종목의 차익·비차익 프로그램 일별 매수·매도·순매수 거래량(주). KRX만 집계하며 당일은 변동 가능. 다음 페이지: nextUntil → until. |
| toss_get_stock_short_sellingB | 국내 종목의 일별 공매도 거래량·거래대금(KRW)·비중. 비중의 분모는 시간외 포함 당일 거래량·거래대금이며 미제공은 null. 다음 페이지: nextUntil → until. |
| toss_get_stock_credit_tradesA | 국내 종목의 신용융자·신용대주 일별 수량(주)과 비율. 기관 간 대차와 별개. 미제공 항목은 null, 최신 기록은 전 영업일. 다음 페이지: nextUntil → until. |
| toss_get_stock_securities_lendingB | 국내 종목의 기관 간 일별 대차 체결·상환·잔고(수량·KRW). 신용대주와 별개. 다음 페이지: nextUntil → until. |
| toss_get_rankingsA | 국내·미국 주식의 시장·기간별 랭킹. count 기본 20, 최대 100; 첫 호출에 필요한 건수 지정. TOP_GAINERS/TOP_LOSERS는 realtime 불가. TOSS_SECURITIES_*는 토스 체결 기준. 급등락 기준가는 기간 시작가, 그 외는 전일 기준가. 데이터가 없으면 빈 목록. |
| toss_get_investor_trading_rankingsA | 국내 주식·ETF의 외국인·기관·개인 순매수/순매도 랭킹(KRW). 최근 영업일만. count는 투자자·방향별 적용(기본 10, 최대 100); 첫 호출에 필요한 건수 지정. 투자자별 rankedAt 확인; 장중 개인은 전 영업일일 수 있습니다. 시세 미포함. |
| toss_get_market_indicator_pricesA | 국내 지수(KOSPI·KOSDAQ)와 한국 국채(KR_BOND_*) 현재가. 지수는 포인트, 국채는 수익률(%). symbols는 쉼표 구분, 최대 200개. |
| toss_get_market_indicator_candlesA | 국내 지수·국채 OHLCV, 최신순. 지수만 분봉 지원; 국채는 일봉만. count 기본 20, 최대 200; 첫 호출에 필요한 봉 수 지정. nextBefore를 시간대 포함 ISO 8601 값 그대로 before에 전달. |
| toss_get_market_indicator_investor_tradingA | 코스피·코스닥 투자자별 매수·매도 거래대금(KRW). 등록·미등록 외국인 합산, 기관 세부 분류 포함. 당일 잠정치; updatedAt 확인. 다음 페이지: nextUntil → until. |
| toss_list_sectorsA | 토스 섹터 분류 전체와 계층 정보(depth·parentSectorId)를 조회합니다. 다른 섹터 도구에서 반환된 sectorId를 사용하세요. |
| toss_get_sector_rankingsA | 시장·기간별 섹터 등락률 또는 거래대금 랭킹. 대·중분류만, 최대 100위. 미국 금액도 KRW 환산; 데이터가 없으면 빈 목록. |
| toss_get_sectorA | 섹터 상세·계층 및 선택한 시장의 기간별 등락률(소수비율). 미제공 기간은 null. sectorId는 toss_list_sectors에서 확인하세요. |
| toss_get_sector_stocksA | 섹터와 하위 섹터의 보통주 전체를 선택한 시장 기준 시가총액순으로 조회합니다. 거래량·거래대금은 당일 누적, 미국 금액도 KRW 환산. |
| toss_get_sector_etfsB | 해당 섹터의 ETF 심볼과 이름. 하위 섹터는 제외합니다. 시세는 toss_get_prices를 사용하세요. |
| toss_get_accountsA | List Toss Securities accounts available to the configured Open API credentials. |
| toss_get_holdingsA | Get account holdings and valuation; optionally filter by symbol. |
| toss_get_transactionsA | Account trades, transfers, FX, dividends, interest and fees (KR/US stocks, options and bonds; see assetClass). Dates use KST settlement day (expected for unsettled); omit the to filter to include future settlements. Unsettled first, newest first within each group. Follow hasNext even on empty pages; pass nextCursor unchanged and clear it if account or filters change. No order IDs. |
| toss_get_buying_powerB | Get available buying power for an account. currency is required: KRW for Korean stocks, USD for US stocks. |
| toss_get_sellable_quantityC | Get sellable quantity for one symbol in an account. |
| toss_get_commissionsB | Get trading commission information for an account. |
| toss_get_ordersB | List regular orders. If hasNext, pass nextCursor as cursor. OPEN ignores limit and cursor. |
| toss_get_orderB | Get one regular order by orderId. |
| toss_get_conditional_ordersB | List conditional orders. If hasNext, pass nextCursor as cursor. |
| toss_get_conditional_orderC | Get one conditional order by conditionalOrderId. |
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 36 tools
Most tools are clearly separated by resource and action, with descriptions clarifying scopes such as stock vs. market-indicator data and the three ranking variants. Minor overlap exists between toss_list_stocks and toss_get_stocks, and among ranking tools, but these are unlikely to cause frequent misselection.
Every tool uses the toss_ prefix followed by snake_case verb_noun naming (e.g. toss_get_prices, toss_list_sectors, toss_get_conditional_order). The only variation is get vs. list, which is predictable and semantically appropriate.
At 36 tools, the surface is heavy for an investment API and includes many granular endpoints that could be consolidated, such as five separate stock trading-data tools and four order-lookup tools. This exceeds the typical 25+ threshold where count starts to feel excessive.
The server broadly covers market data, indicators, sectors, rankings, account holdings, transactions, buying power, sellable quantity, commissions, and order retrieval. However, core trading lifecycle operations like creating, amending, or canceling orders are missing, leaving a notable dead end for a trading-oriented domain.