Toss Invest

io.github.wi9ine由 GitHub 帳號 wi9ine 發布v0.4.1更新於 Nov 6, 2026

Access Toss Securities market, account, and opt-in trading APIs through MCP.

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

針對 Toss Securities 開放 API 的唯讀 MCP 伺服器,讓助理查詢韓美股票行情、市場資料、類股以及帳戶持股。

可以做什麼
  • 查詢韓美股票的現價、成交、委買賣盤、K 線、價格限制和基本資料
  • 瀏覽市場資料:匯率、韓國與美國市場行事曆、排行榜、類股及成分股、相關 ETF 和市場指標
  • 檢視韓國市場資金資料:投資人、程式交易、放空、信用融資和證券借貸的每日序列
  • 檢視帳戶:帳戶清單與 accountSeq、持股、交易明細、委託單、條件委託單、可買金額、可賣數量和手續費
適用情境
適合希望助理在對話中直接取得 Toss Securities 行情與持股資料的情境,例如查看報價、篩選類股與排行榜,或回顧持股和委託歷史。
執行需求
以 npm 套件形式透過 stdio 在本機執行,需要 Node.js 22.18 或更新版本(工作區安裝另需 pnpm)。需要 Toss Securities 開放 API 的用戶端 ID 與密鑰,透過 TOSS_CLIENT_ID 和 TOSS_CLIENT_SECRET 提供,並需能連線至 Toss Securities API 的網路。
安裝前請注意
需要 Toss Securities API 憑證(TOSS_CLIENT_ID、TOSS_CLIENT_SECRET),可存取你的證券帳戶資料,請勿放入共用設定。帳戶類工具會揭露持股、交易明細和委託歷史,這些資料會傳送給助理及其模型供應商。伺服器預設為唯讀,但可明確開啟交易功能,使用前請確認該設定。本專案為非官方社群專案,與 Toss Securities 無隸屬或背書關係。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Toss Invest,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Toss Securities Open API

Unofficial community project. This project is not affiliated with or endorsed by Toss Securities.

pnpm workspace for a TypeScript SDK and a local MCP server for the Toss Securities Open API. The MCP server is read-only unless trading is explicitly enabled.

Packages

  • packages/sdk: TypeScript SDK with automatic access-token caching and refresh
  • apps/mcp: local MCP server built on the SDK, with opt-in trading permissions

Requirements

  • Node.js 22.18 or later
  • pnpm

Setup

sh
pnpm installcp .env.example .env

Set TOSS_CLIENT_ID and TOSS_CLIENT_SECRET in .env, then run:

sh
pnpm checkpnpm testpnpm test:live

The live test only performs read operations, and the MCP server defaults to read-only. See the SDK guide and MCP setup guide for usage details.

來源:README.md,提交 511154e

工具

36

toss_get_prices

종목 현재가 조회

국내 또는 미국 종목의 현재가를 최대 200개까지 조회합니다.

輸入參數symbols必填

toss_get_trades

최근 체결 조회

한 종목의 최근 체결 내역을 최대 50건까지 조회합니다.

輸入參數countsymbol必填

toss_get_price_limit

가격 제한 조회

한 종목의 당일 가격 제한 정보를 조회합니다.

輸入參數symbol必填

toss_get_orderbook

종목 호가 조회

한 종목의 매수·매도 호가와 잔량을 조회합니다.

輸入參數symbol必填

toss_get_candles

종목 캔들 조회

한 종목의 분봉 또는 일봉 OHLCV 데이터를 최대 200개까지 조회합니다. 캔들은 최신순(timestamp 내림차순)으로 정렬되며, 1분봉의 timestamp는 봉 종료 시각, 일봉은 해당 거래일 자정입니다.

輸入參數countbeforesymbol必填adjustedinterval必填

toss_get_stocks

종목 기본 정보 조회

국내 또는 미국 종목의 이름, 시장, 통화, 거래 상태 등 기본 정보를 조회합니다.

輸入參數symbols必填

toss_list_stocks

마켓 전체 종목 조회

마켓(거래소)별 전체 종목 목록을 조회합니다. 유니버스 구성 용도이며 마켓당 최대 수천 건을 한 번에 반환하므로, 개별 종목 정보는 toss_get_stocks를 사용하세요.

輸入參數market必填statuscommonSharesecurityType

toss_get_stock_warnings

종목 유의사항 조회

한 종목의 투자경고, 거래정지 등 투자 유의사항을 조회합니다.

輸入參數symbol必填

toss_get_stock_investor_trading

투자자별 매매동향 조회

국내 종목의 개인·외국인·기관·기타법인 투자자별 매매 거래량을 일별 시계열로 조회합니다.

輸入參數countuntilsymbol必填

toss_get_stock_program_trades

프로그램매매 동향 조회

국내 종목의 차익·비차익 프로그램매매 거래량을 일별 시계열로 조회합니다.

輸入參數countuntilsymbol必填

toss_get_stock_short_selling

공매도 동향 조회

국내 종목의 공매도 거래량·거래대금과 전체 거래 대비 비중을 일별 시계열로 조회합니다.

輸入參數countuntilsymbol必填

toss_get_stock_credit_trades

신용거래 동향 조회

국내 종목의 신용융자·신용대주 신규·상환·잔고 수량을 일별 시계열로 조회합니다.

輸入參數countuntilsymbol必填

toss_get_stock_securities_lending

대차거래 동향 조회

국내 종목의 대차거래 체결·상환·잔고 수량과 잔고 금액을 일별 시계열로 조회합니다.

輸入參數countuntilsymbol必填

toss_get_exchange_rate

환율 조회

원화와 달러 사이의 참고 환율을 조회합니다.

輸入參數dateTimebaseCurrency必填quoteCurrency必填

toss_get_kr_market_calendar

국내 장 운영 정보 조회

기준일의 국내 시장 운영 시간과 거래 가능 여부를 조회합니다.

輸入參數date

toss_get_us_market_calendar

미국 장 운영 정보 조회

기준일의 미국 시장 운영 시간과 거래 가능 여부를 조회합니다.

輸入參數date

toss_get_rankings

주식 랭킹 조회

시장 또는 토스증권 기준 거래대금, 거래량, 등락률 순위를 조회합니다.

輸入參數type必填countduration必填marketCountry必填excludeInvestmentCaution

toss_get_investor_trading_rankings

투자자별 매매 랭킹 조회

국내 종목의 투자자별 순매수·순매도 랭킹을 조회합니다.

輸入參數count

toss_list_sectors

섹터 목록 조회

섹터 목록과 계층을 조회합니다.

無需輸入參數。

toss_get_sector_rankings

섹터 랭킹 조회

시장과 기간별 섹터 랭킹을 조회합니다.

輸入參數type必填duration必填marketCountry必填

toss_get_sector

섹터 상세 조회

섹터 정보와 기간별 등락률을 조회합니다. 섹터 ID는 toss_list_sectors에서 확인하세요.

輸入參數sectorId必填marketCountry必填

toss_get_sector_stocks

섹터 구성 주식 조회

하위 섹터를 포함한 구성 주식을 조회합니다. 섹터 ID는 toss_list_sectors에서 확인하세요.

輸入參數sectorId必填marketCountry必填

toss_get_sector_etfs

섹터 관련 ETF 조회

해당 섹터의 관련 ETF을 조회합니다. 섹터 ID는 toss_list_sectors에서 확인하세요.

輸入參數sectorId必填marketCountry必填

toss_get_market_indicator_prices

시장 지표 현재가 조회

국내 지수와 국채 등 시장 지표의 현재가를 최대 200개까지 조회합니다.

輸入參數symbols必填

toss_get_market_indicator_candles

시장 지표 캔들 조회

한 시장 지표의 분봉 또는 일봉 데이터를 최대 200개까지 조회합니다. 캔들은 최신순(timestamp 내림차순)으로 정렬되며, 1분봉의 timestamp는 봉 종료 시각, 일봉은 해당 거래일 자정입니다.

輸入參數countbeforesymbol必填interval必填

toss_get_market_indicator_investor_trading

투자자별 매매대금 조회

코스피 또는 코스닥의 투자자별 매매대금을 조회합니다.

輸入參數countuntilsymbol必填interval必填

toss_list_accounts

계좌 목록 조회

사용 가능한 토스증권 종합매매 계좌와 accountSeq를 조회합니다.

無需輸入參數。

toss_get_holdings

보유 주식 조회

선택한 계좌의 국내·미국 보유 주식과 평가 정보를 조회합니다.

輸入參數symbolaccountSeq必填

toss_get_transactions

계좌 거래내역 조회

계좌의 매매·입출금·환전·배당 등 거래내역을 조회합니다. 다음 페이지는 hasNext와 nextCursor로 확인하세요.

輸入參數tofromlimitcursoraccountSeq必填transactionTypes

toss_list_orders

주문 내역 조회

선택한 계좌의 진행 중이거나 종료된 주문 내역을 조회합니다.

輸入參數tofromlimitcursorstatus必填symbolaccountSeq必填

toss_get_order

주문 상세 조회

선택한 계좌의 주문 한 건을 상세 조회합니다.

輸入參數orderId必填accountSeq必填

toss_list_conditional_orders

조건주문 목록 조회

선택한 계좌의 진행 중이거나 종료된 조건주문 목록을 조회합니다.

輸入參數limitcursorstatus必填symbolaccountSeq必填

toss_get_conditional_order

조건주문 상세 조회

선택한 계좌의 조건주문 한 건을 상세 조회합니다.

輸入參數accountSeq必填conditionalOrderId必填

toss_get_buying_power

매수 가능 금액 조회

선택한 계좌에서 원화 또는 달러로 주문 가능한 현금 기반 금액을 조회합니다.

輸入參數currency必填accountSeq必填

toss_get_sellable_quantity

매도 가능 수량 조회

선택한 계좌에서 특정 종목을 매도할 수 있는 수량을 조회합니다.

輸入參數symbol必填accountSeq必填

toss_get_commissions

매매 수수료 조회

선택한 계좌의 국내·미국 주식 매매 수수료를 조회합니다.

輸入參數accountSeq必填

版本歷史

4
  1. v0.4.1最新Nov 5, 2026
  2. v0.3.0Oct 30, 2026
  3. v0.2.1Sep 25, 2026
  4. v0.2.0Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分