SSyncDev

Kiwoom Securities MCP Server

Read-only MCP server for the Kiwoom Securities REST API: market data, account inquiry, ISA tax tool

Local serverstdio

What is the Kiwoom Securities MCP Server?

Read-only MCP server for the Kiwoom Securities REST API: market data, account inquiry, ISA tax tool

What the server does

키움증권 REST API를 조회 전용(read-only) 으로 노출하는 MCP 서버입니다. Claude Desktop / Claude Code에서 자연어로 국내 주식 시세·차트·호가·지수·순위·수급과 내 계좌의 잔고·보유 종목·거래내역을 조회할 수 있고, ISA 계좌라면 비과세 한도 대비 손익통산 현황까지 계산해 줍니다.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
search_stock종목명→코드 검색 (코스피/코스닥, ETF/ETN 포함) + 투자유의 표시
get_stock_price현재가/등락률/거래량/기본지표 + 업종·상장일·투자유의
get_stock_quotes여러 종목(최대 30개) 일괄 시세 — 현재가·등락률·거래량·거래대금·시가총액
get_stock_chart일/주/월/년/분/틱봉 캔들 차트 (수정주가 반영)
get_daily_trading일별 거래·수급 — 종가·거래대금 + 개인/기관/외국인 순매수·프로그램·신용비율, 또는 장전/장중/장후 거래 분포
get_orderbook10단계 매도/매수 호가·잔량
get_orderbook_rank시장 전체 호가잔량 상위 / 잔량 급증 / 잔량비율 급증 (정규장 중)
get_market_index코스피/코스닥 종합·업종 지수
get_sector_price업종 지수 현재가 상세 (등락 구성·52주 고저·시간대별 추이)
get_sector_stocks업종 구성 종목 시세 (현재가·등락률·거래량·고저가)
get_sector_chart업종 지수 일/주/월/년/분/틱봉 캔들 차트
get_sector_flow업종별 투자자 순매수 — 시장 전체 업종의 개인/외국인/기관계 + 증권·투신·연기금·사모

How to install the Kiwoom Securities MCP Server

{
  "mcpServers": {
    "kiwoom": {
      "command": "npx",
      "args": ["-y", "kiwoom-mcp-server"],
      "env": {
        "KIWOOM_APP_KEY": "…",
        "KIWOOM_APP_SECRET": "…",
        "KIWOOM_MODE": "REAL"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
KIWOOM_APP_KEYCredential the server authenticates with.Yes
KIWOOM_APP_SECRETCredential the server authenticates with.Yes
KIWOOM_MODEConfiguration value read at startup.Optional
MCP_AUTH_TOKENCredential the server authenticates with.Yes
MCP_HTTP_HOSTEndpoint or connection string the server talks to.Optional

Example prompts to try

  • “Use Kiwoom Securities to macOS.”
  • “Use Kiwoom Securities to Windows.”
  • “Use Kiwoom Securities to search stock.”

Frequently asked questions

Read-only MCP server for the Kiwoom Securities REST API: market data, account inquiry, ISA tax tool Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.