Toss Invest

io.github.wi9inePublished by GitHub account wi9inev0.4.1Updated Nov 6, 2026

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

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Read-only MCP server for Toss Securities Open API, letting an assistant query Korean and US stock quotes, market data, sectors, and account holdings.

What you can do
  • Look up prices, trades, order books, candles, price limits and stock basics for Korean and US symbols
  • Browse market data: exchange rates, KR/US market calendars, rankings, sectors and sector constituents, ETFs and market indicators
  • Review Korean flow data: investor, program, short-selling, credit and securities-lending series
  • Inspect accounts: list accounts and accountSeq, holdings, transactions, orders, conditional orders, buying power, sellable quantity and commissions
When to use it
Useful when you want an assistant to pull Toss Securities market and portfolio data into a conversation — checking quotes, screening sectors and rankings, or reviewing holdings and order history — without leaving the chat.
Requirements
Runs locally as an npm package over stdio; needs Node.js 22.18 or later (pnpm for the workspace setup). Requires a Toss Securities Open API client ID and secret, supplied as TOSS_CLIENT_ID and TOSS_CLIENT_SECRET, plus network access to the Toss Securities API.
Before you install
Requires Toss Securities API credentials (TOSS_CLIENT_ID, TOSS_CLIENT_SECRET) that grant access to your brokerage account data; keep them out of shared configs. Account tools expose holdings, transactions and order history, which are sent to the assistant and its model provider. The server is read-only by default, but trading can be explicitly enabled, so verify that setting before use. It is an unofficial community project, not affiliated with or endorsed by Toss Securities.

Installation

In SourceWeft

  1. Open Toss Invest in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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.

Source: README.md at commit 511154e

Tools

36

toss_get_prices

종목 현재가 조회

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

Parameterssymbolsrequired

toss_get_trades

최근 체결 조회

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

Parameterscountsymbolrequired

toss_get_price_limit

가격 제한 조회

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

Parameterssymbolrequired

toss_get_orderbook

종목 호가 조회

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

Parameterssymbolrequired

toss_get_candles

종목 캔들 조회

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

Parameterscountbeforesymbolrequiredadjustedintervalrequired

toss_get_stocks

종목 기본 정보 조회

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

Parameterssymbolsrequired

toss_list_stocks

마켓 전체 종목 조회

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

ParametersmarketrequiredstatuscommonSharesecurityType

toss_get_stock_warnings

종목 유의사항 조회

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

Parameterssymbolrequired

toss_get_stock_investor_trading

투자자별 매매동향 조회

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

Parameterscountuntilsymbolrequired

toss_get_stock_program_trades

프로그램매매 동향 조회

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

Parameterscountuntilsymbolrequired

toss_get_stock_short_selling

공매도 동향 조회

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

Parameterscountuntilsymbolrequired

toss_get_stock_credit_trades

신용거래 동향 조회

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

Parameterscountuntilsymbolrequired

toss_get_stock_securities_lending

대차거래 동향 조회

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

Parameterscountuntilsymbolrequired

toss_get_exchange_rate

환율 조회

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

ParametersdateTimebaseCurrencyrequiredquoteCurrencyrequired

toss_get_kr_market_calendar

국내 장 운영 정보 조회

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

Parametersdate

toss_get_us_market_calendar

미국 장 운영 정보 조회

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

Parametersdate

toss_get_rankings

주식 랭킹 조회

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

ParameterstyperequiredcountdurationrequiredmarketCountryrequiredexcludeInvestmentCaution

toss_get_investor_trading_rankings

투자자별 매매 랭킹 조회

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

Parameterscount

toss_list_sectors

섹터 목록 조회

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

Takes no parameters.

toss_get_sector_rankings

섹터 랭킹 조회

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

ParameterstyperequireddurationrequiredmarketCountryrequired

toss_get_sector

섹터 상세 조회

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

ParameterssectorIdrequiredmarketCountryrequired

toss_get_sector_stocks

섹터 구성 주식 조회

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

ParameterssectorIdrequiredmarketCountryrequired

toss_get_sector_etfs

섹터 관련 ETF 조회

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

ParameterssectorIdrequiredmarketCountryrequired

toss_get_market_indicator_prices

시장 지표 현재가 조회

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

Parameterssymbolsrequired

toss_get_market_indicator_candles

시장 지표 캔들 조회

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

Parameterscountbeforesymbolrequiredintervalrequired

toss_get_market_indicator_investor_trading

투자자별 매매대금 조회

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

Parameterscountuntilsymbolrequiredintervalrequired

toss_list_accounts

계좌 목록 조회

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

Takes no parameters.

toss_get_holdings

보유 주식 조회

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

ParameterssymbolaccountSeqrequired

toss_get_transactions

계좌 거래내역 조회

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

ParameterstofromlimitcursoraccountSeqrequiredtransactionTypes

toss_list_orders

주문 내역 조회

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

ParameterstofromlimitcursorstatusrequiredsymbolaccountSeqrequired

toss_get_order

주문 상세 조회

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

ParametersorderIdrequiredaccountSeqrequired

toss_list_conditional_orders

조건주문 목록 조회

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

ParameterslimitcursorstatusrequiredsymbolaccountSeqrequired

toss_get_conditional_order

조건주문 상세 조회

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

ParametersaccountSeqrequiredconditionalOrderIdrequired

toss_get_buying_power

매수 가능 금액 조회

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

ParameterscurrencyrequiredaccountSeqrequired

toss_get_sellable_quantity

매도 가능 수량 조회

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

ParameterssymbolrequiredaccountSeqrequired

toss_get_commissions

매매 수수료 조회

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

ParametersaccountSeqrequired

Version history

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

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts