# scjang01/tossinvest-mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/scjang01/tossinvest-mcp  
**GitHub Stars:** 4  
**npm Downloads (last month):** 589  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/scjang01-tossinvest-mcp

## Description
Toss Securities (토스증권) Open API MCP server. Real-time quotes, orderbook, candles, holdings, buying power, and order management (create/modify/cancel).

## Tools
Capabilities this server exposes over MCP:

- **toss_get_orderbook** — Get orderbook data for one KRX or US stock symbol.
- **toss_get_prices** — Get current prices for up to 200 comma-separated KRX or US stock symbols.
- **toss_get_trades** — 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_limits** — Get upper and lower price limits for one KRX or US stock symbol.
- **toss_get_candles** — 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_stocks** — Get stock master data for up to 200 comma-separated KRX or US stock symbols.
- **toss_get_stock_warnings** — Get buy warning flags for one KRX or US stock symbol.
- **toss_get_exchange_rate** — Get KRW/USD or USD/KRW exchange rate. Optional dateTime is ISO 8601 with timezone.
- **toss_get_kr_market_calendar** — Get Korean market calendar and session hours. date is optional YYYY-MM-DD.
- **toss_get_us_market_calendar** — Get US market calendar and session hours. date is optional YYYY-MM-DD in US local date.
- **toss_list_stocks** — 거래소별 토스 거래 가능 종목 전체를 심볼순으로 반환합니다. 페이지 없음; status·securityType·commonShare로 좁히세요. 개별 종목 상세는 toss_get_stocks.
- **toss_get_stock_investor_trading** — 국내 종목의 투자자별 일별 매수·매도·순매수 거래량(주). KRX·NXT 합산, 외국인은 등록 기준. 기관 세부·외국인 보유·CFD 포함. 장중 잠정치에서 미제공 항목은 null; updatedAt 확인. 다음 페이지: nextUntil → until.
- **toss_get_stock_program_trades** — 국내 종목의 차익·비차익 프로그램 일별 매수·매도·순매수 거래량(주). KRX만 집계하며 당일은 변동 가능. 다음 페이지: nextUntil → until.
- **toss_get_stock_short_selling** — 국내 종목의 일별 공매도 거래량·거래대금(KRW)·비중. 비중의 분모는 시간외 포함 당일 거래량·거래대금이며 미제공은 null. 다음 페이지: nextUntil → until.
- **toss_get_stock_credit_trades** — 국내 종목의 신용융자·신용대주 일별 수량(주)과 비율. 기관 간 대차와 별개. 미제공 항목은 null, 최신 기록은 전 영업일. 다음 페이지: nextUntil → until.
- **toss_get_stock_securities_lending** — 국내 종목의 기관 간 일별 대차 체결·상환·잔고(수량·KRW). 신용대주와 별개. 다음 페이지: nextUntil → until.
- **toss_get_rankings** — 국내·미국 주식의 시장·기간별 랭킹. count 기본 20, 최대 100; 첫 호출에 필요한 건수 지정. TOP_GAINERS/TOP_LOSERS는 realtime 불가. TOSS_SECURITIES_*는 토스 체결 기준. 급등락 기준가는 기간 시작가, 그 외는 전일 기준가. 데이터가 없으면 빈 목록.
- **toss_get_investor_trading_rankings** — 국내 주식·ETF의 외국인·기관·개인 순매수/순매도 랭킹(KRW). 최근 영업일만. count는 투자자·방향별 적용(기본 10, 최대 100); 첫 호출에 필요한 건수 지정. 투자자별 rankedAt 확인; 장중 개인은 전 영업일일 수 있습니다. 시세 미포함.
- **toss_get_market_indicator_prices** — 국내 지수(KOSPI·KOSDAQ)와 한국 국채(KR_BOND_*) 현재가. 지수는 포인트, 국채는 수익률(%). symbols는 쉼표 구분, 최대 200개.
- **toss_get_market_indicator_candles** — 국내 지수·국채 OHLCV, 최신순. 지수만 분봉 지원; 국채는 일봉만. count 기본 20, 최대 200; 첫 호출에 필요한 봉 수 지정. nextBefore를 시간대 포함 ISO 8601 값 그대로 before에 전달.
- **toss_get_market_indicator_investor_trading** — 코스피·코스닥 투자자별 매수·매도 거래대금(KRW). 등록·미등록 외국인 합산, 기관 세부 분류 포함. 당일 잠정치; updatedAt 확인. 다음 페이지: nextUntil → until.
- **toss_list_sectors** — 토스 섹터 분류 전체와 계층 정보(depth·parentSectorId)를 조회합니다. 다른 섹터 도구에서 반환된 sectorId를 사용하세요.
- **toss_get_sector_rankings** — 시장·기간별 섹터 등락률 또는 거래대금 랭킹. 대·중분류만, 최대 100위. 미국 금액도 KRW 환산; 데이터가 없으면 빈 목록.
- **toss_get_sector** — 섹터 상세·계층 및 선택한 시장의 기간별 등락률(소수비율). 미제공 기간은 null. sectorId는 toss_list_sectors에서 확인하세요.
- **toss_get_sector_stocks** — 섹터와 하위 섹터의 보통주 전체를 선택한 시장 기준 시가총액순으로 조회합니다. 거래량·거래대금은 당일 누적, 미국 금액도 KRW 환산.
- **toss_get_sector_etfs** — 해당 섹터의 ETF 심볼과 이름. 하위 섹터는 제외합니다. 시세는 toss_get_prices를 사용하세요.
- **toss_get_accounts** — List Toss Securities accounts available to the configured Open API credentials.
- **toss_get_holdings** — Get account holdings and valuation; optionally filter by symbol.
- **toss_get_transactions** — 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_power** — Get available buying power for an account. currency is required: KRW for Korean stocks, USD for US stocks.
- **toss_get_sellable_quantity** — Get sellable quantity for one symbol in an account.
- **toss_get_commissions** — Get trading commission information for an account.
- **toss_get_orders** — List regular orders. If hasNext, pass nextCursor as cursor. OPEN ignores limit and cursor.
- **toss_get_order** — Get one regular order by orderId.
- **toss_get_conditional_orders** — List conditional orders. If hasNext, pass nextCursor as cursor.
- **toss_get_conditional_order** — Get one conditional order by conditionalOrderId.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "tossinvest-mcp": {
    "command": "npx",
    "args": ["-y","tossinvest-mcp"],
    "env": {
      "TOSSINVEST_API_KEY": "",
      "TOSSINVEST_SECRET_KEY": ""
    }
  }
}
```

**Requires environment variables:** `TOSSINVEST_API_KEY`, `TOSSINVEST_SECRET_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What scjang01/tossinvest-mcp MCP server does

The scjang01/tossinvest-mcp MCP server connects MCP clients running on a user’s computer to the Toss Securities Open API. Its read-only capabilities cover domestic and U.S. stock information, including current prices, order books, recent trades, candles, upper and lower price limits, basic instrument details, purchase warnings, exchange rates, and market hours.

Account-oriented queries include available accounts, holdings, buying power, sellable quantities, trading fees, order lists, and order details. These functions are available without enabling trading. The default account is account sequence 1, and another account can be selected through configuration.

Trading is optional. When enabled, the server registers tools for creating, modifying, and cancelling orders. A modification replaces the original order rather than patching it in place, so Toss returns a new order ID that must be used for later lookups, modifications, or cancellation.

## How it works

The scjang01/tossinvest-mcp MCP server runs locally through Node.js and communicates with the MCP client over its local process connection. The npm package can be launched with `npx`, allowing the client to fetch it when first started. Toss Securities API credentials are passed as environment variables rather than written into tool requests.

OAuth token handling is internal: the server obtains tokens and refreshes them automatically before expiry. Toss Securities only accepts requests from registered IP addresses, so the machine’s public IP must be added to the allowed IP list in the Toss Securities WTS Open API settings.

Trading tools are not registered by default. If trading is enabled, each create, modify, or cancel request normally also needs the input field `confirmOrderAction: true`. This confirmation requirement can be disabled for automation, but other configured restrictions continue to apply.

## Setup and configuration

Install Node.js 20 or newer, obtain a Toss Securities API Key and Secret Key, and register the machine’s public IP with Toss Securities. Add the server to the MCP client configuration with `npx tossinvest-mcp`, setting `TOSSINVEST_API_KEY` and `TOSSINVEST_SECRET_KEY` in the environment.

`TOSSINVEST_ACCOUNT` selects the default account sequence and otherwise defaults to `1`. Set `TOSSINVEST_ENABLE_TRADING` to `true` only when real-account order operations are intended. The scjang01/tossinvest-mcp MCP server does not provide a sandbox, so initial testing should use market-data and account-query functions before enabling trading.

## Tools and capabilities

The scjang01/tossinvest-mcp MCP server supports:

- Domestic and U.S. stock quotes, order books, trades, candles, and instrument information
- Exchange rates and domestic/U.S. market schedules
- Account lists, holdings, buying power, sellable quantities, fees, and order details
- Optional order creation, modification, and cancellation
- Local pre-trade restrictions for order amount, daily amount, daily count, symbols, selling, market orders, and account selection

## Limitations and notes

All order operations can affect a real Toss Securities account. There is no documented mock-trading or sandbox environment. By default, selling and market orders are blocked, and order confirmation is required. Additional limits can restrict one-order amounts, daily totals, daily order counts, permitted symbols, and the account used for orders.

The server requires valid Toss Securities credentials and an allowed source IP. Protect the API Key and Secret Key. Account-dependent requests use the configured default account unless a supported request specifies otherwise, and account locking can prevent orders from targeting a different account.

_Full upstream README: https://allmcps.com/mcp/scjang01-tossinvest-mcp/readme_

