Read-only MCP server for the Kiwoom Securities REST API: market data, account inquiry, ISA tax tool
Connect Kiwoom Securities to Claude, Cursor or any other MCP client and it stops being a tab you switch to. Read-only MCP server for the Kiwoom Securities REST API: market data, account inquiry, ISA tax tool. The kiwoom securities mcp server is what makes that connection.
키움증권 REST API를 조회 전용(read-only) 으로 노출하는 MCP 서버입니다. Claude Desktop / Claude Code에서 자연어로 국내 주식 시세·차트·호가·지수·순위·수급과 내 계좌의 잔고·보유 종목·거래내역을 조회할 수 있고, ISA 계좌라면 비과세 한도 대비 손익통산 현황까지 계산해 줍니다.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
macOS — ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows — %APPDATA%\Claude\claude_desktop_config.jsonsearch_stock — 종목명→코드 검색 (코스피/코스닥, ETF/ETN 포함) + 투자유의 표시get_stock_price — 현재가/등락률/거래량/기본지표 + 업종·상장일·투자유의get_stock_quotes — 여러 종목(최대 30개) 일괄 시세 — 현재가·등락률·거래량·거래대금·시가총액get_stock_chart — 일/주/월/년/분/틱봉 캔들 차트 (수정주가 반영)get_daily_trading — 일별 거래·수급 — 종가·거래대금 + 개인/기관/외국인 순매수·프로그램·신용비율, 또는 장전/장중/장후 거래 분포get_orderbook — 10단계 매도/매수 호가·잔량get_orderbook_rank — 시장 전체 호가잔량 상위 / 잔량 급증 / 잔량비율 급증 (정규장 중)get_market_index — 코스피/코스닥 종합·업종 지수get_sector_price — 업종 지수 현재가 상세 (등락 구성·52주 고저·시간대별 추이)get_sector_stocks — 업종 구성 종목 시세 (현재가·등락률·거래량·고저가)Configuration is passed through the environment: KIWOOM_APP_KEY, KIWOOM_APP_SECRET, KIWOOM_MODE, MCP_AUTH_TOKEN, MCP_HTTP_HOST. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
Installation goes through your MCP client rather than a global install: point it at kiwoom-mcp-server on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.
This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Kiwoom Securities's toolset — macOS, Windows, search_stock and 11 more — is a fair guide to whether it matches your workflow. It is maintained by ChunSam; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Kiwoom Securities's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| search_stock | 종목명→코드 검색 (코스피/코스닥, ETF/ETN 포함) + 투자유의 표시 |
| get_stock_price | 현재가/등락률/거래량/기본지표 + 업종·상장일·투자유의 |
| get_stock_quotes | 여러 종목(최대 30개) 일괄 시세 — 현재가·등락률·거래량·거래대금·시가총액 |
| get_stock_chart | 일/주/월/년/분/틱봉 캔들 차트 (수정주가 반영) |
| get_daily_trading | 일별 거래·수급 — 종가·거래대금 + 개인/기관/외국인 순매수·프로그램·신용비율, 또는 장전/장중/장후 거래 분포 |
| get_orderbook | 10단계 매도/매수 호가·잔량 |
| get_orderbook_rank | 시장 전체 호가잔량 상위 / 잔량 급증 / 잔량비율 급증 (정규장 중) |
| get_market_index | 코스피/코스닥 종합·업종 지수 |
| get_sector_price | 업종 지수 현재가 상세 (등락 구성·52주 고저·시간대별 추이) |
| get_sector_stocks | 업종 구성 종목 시세 (현재가·등락률·거래량·고저가) |
| get_sector_chart | 업종 지수 일/주/월/년/분/틱봉 캔들 차트 |
| get_sector_flow | 업종별 투자자 순매수 — 시장 전체 업종의 개인/외국인/기관계 + 증권·투신·연기금·사모 |
{
"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.
| Variable | Description | Required |
|---|---|---|
| KIWOOM_APP_KEY | Credential the server authenticates with. | Yes |
| KIWOOM_APP_SECRET | Credential the server authenticates with. | Yes |
| KIWOOM_MODE | Configuration value read at startup. | Optional |
| MCP_AUTH_TOKEN | Credential the server authenticates with. | Yes |
| MCP_HTTP_HOST | Endpoint or connection string the server talks to. | Optional |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.