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 分