Skip to main content
Glama
tossinvest-mcp

tossinvest-mcp

by scjang01

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
TOSSINVEST_ACCOUNTNo기본으로 사용할 토스증권 accountSeq. 미설정 시 11
TOSSINVEST_API_KEYYes토스증권 Open API 화면의 API Key
TOSSINVEST_BASE_URLNo기본값은 https://openapi.tossinvest.comhttps://openapi.tossinvest.com
TOSSINVEST_SECRET_KEYYes토스증권 Open API 화면의 Secret Key
TOSSINVEST_YOLO_TRADINGNotrue로 설정하면 주문 도구에서 confirmOrderAction 없이도 API를 호출합니다. 권장하지 않습니다
TOSSINVEST_ENABLE_TRADINGNotrue로 설정해야 주문 생성, 정정, 취소 도구가 등록됩니다

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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.3/5.0

Scored across 36 tools

Disambiguation4/5

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.

Naming Consistency5/5

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.

Tool Count2/5

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.

Completeness3/5

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.

Maintenance

ActivityNo data
ResponsivenessOutdated data