Kiwoom Securities MCP Server
io.github.ChunSam/kiwoom-mcp-server·v0.52.6·1 starsRead-only MCP server for the Kiwoom Securities REST API: market data, account inquiry, ISA tax tool
1 stars109 downloads/wk
Reviews
Write oneNobody has reviewed Kiwoom Securities MCP Server yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Kiwoom Securities MCP Server tools (50, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
calc_isa_tax_statusISA 계좌의 손익통산 순이익을 계산해 비과세 한도(일반형 200만원/서민형 400만원) 대비
get_account_balanceview=summary(기본)는 계좌의 예수금(주문가능/출금가능 포함)과 총매입금액, 총평가금액,
get_account_holdings계좌의 보유 종목 목록을 조회합니다 — 종목별 수량, 평균단가, 현재가, 평가금액,
get_account_today오늘 하루 계좌에 무슨 일이 있었는지를 한 장으로 조회합니다 (키움 kt00017) — 매도·매수 금액,
get_account_trend일별 추정예탁자산(예수금·대용금 포함) 추이와 기간 수익률·평가손익·입출금 요약을 조회합니다
get_after_hours장 종료 후 시간외 단일가 매매(16:00~18:00 KST) 정보를 조회합니다 (키움 ka10087/ka10098).
get_broker_activity증권사 창구별 매매 동향을 조회합니다 (키움 ka10002/ka10102/ka10037/ka10038/ka10053).
get_credit_trend특정 종목의 신용융자(빚내서 산 물량) 또는 대주(빌려서 판 물량) 신규·상환·잔고 추이를
get_daily_trading종목의 일자별 거래를 한 번의 호출로 조회합니다 (키움 ka10086/ka10015).
get_equal_net_trade기관과 외국인이 **같은 방향으로 동시에** 순매매한 종목 순위를 조회합니다 (키움 ka10062).
get_etf_infoETF의 추적지수, 과세유형, 현재 시세, NAV·괴리율을 조회합니다 (키움 ka40002+ka10001+ka40009).
get_etf_rank상장 ETF 전 종목(약 1,150개)을 한 번에 훑어 괴리율·등락률·거래량·추적오차로 정렬합니다 (키움 ka40004).
get_etf_returnsETF의 성과를 세 각도로 조회합니다 (키움 ka40001/ka40003/ka40008).
get_execution_strength종목의 체결강도(매수 체결량 ÷ 매도 체결량 × 100) 추이를 조회합니다 (키움 ka10046/ka10047).
get_expected_execution예상체결가 기준 순위를 조회합니다 (키움 ka10029). 예상체결가는 '지금 체결된다면 이 값'이라
get_foreign_holding외국인 보유(한도) 동향을 조회합니다 (키움 ka10008/ka10036/ka10034/ka10035).
get_foreign_intraday정규장 중 **어떤 주체가 지금 사고 있는 종목**을 전 종목에서 뽑습니다 (키움 ka10063/ka10065).
get_gold_priceKRX 금시장(금현물) 시세를 조회합니다 (키움 ka50010/ka50012).
get_institution_trend특정 종목을 기관·외국인이 **대략 얼마에 담았는지**(추정평균단가)와 일별·기간누적 순매수를
get_investor_rank외국인과 기관이 많이 사고판 종목을 조회합니다 (키움 ka90009/ka10131).
get_investor_trend종목의 개인/외국인/기관 순매수 동향을 조회합니다 (키움 ka10059+ka10061). 기간 합계와
get_market_index코스피/코스닥 종합지수와 업종별 지수를 조회합니다 (키움 ka20003).
get_market_movers시장 특이 종목을 조회합니다 (키움 ka10016/ka10017/ka10019/ka10023/ka10024). signal:
get_net_buy_rankwrite action시장 전 종목을 훑어 **투자자 주체별 순매수 상위**를 뽑습니다 (키움 ka10066).
get_order_executionswrite action계좌의 **최근** 체결(실제로 체결된 주문) 내역을 조회합니다 — **지난 일자의 체결은 나오지 않습니다**.
get_orderbook종목의 10단계 매도/매수 호가와 잔량을 KRX+넥스트레이드(NXT) 통합 기준으로 조회합니다 (키움 ka10007).
get_orderbook_rank시장 전체에서 호가 잔량이 두껍거나 급증한 종목을 조회합니다 (키움 ka10020/ka10021/ka10022).
get_pending_orders계좌의 미체결(아직 체결되지 않은) 주문 목록을 조회합니다 — 주문번호, 종목, 매수/매도 구분,
get_program_trading프로그램 매매 상위 종목과 추이를 조회합니다 (키움 ka90003/ka90004/ka90010/ka90005/ka90013/ka90008/ka90006).
get_ranking당일 시장 순위를 조회합니다 (키움 ka10027/ka10030/ka10032/ka10028/ka10033). type: rise(상승률)/
get_sector_chart업종(섹터) 지수의 캔들 차트를 조회합니다 (키움 ka20004~ka20008/ka20019).
get_sector_flow시장 전체 업종의 투자자 주체별 순매수를 한 번에 조회합니다 (키움 ka10051).
get_sector_price업종(섹터) 지수의 현재가 상세를 조회합니다 (키움 ka20001) — 지수·시/고/저가·거래량·
get_sector_stocks특정 **업종**(KRX 표준 분류)에 속한 종목들의 시세를 조회합니다 (키움 ka20002). 종목코드순 정렬이며
get_short_selling특정 종목의 일자별 공매도 추이를 조회합니다 — 종가, 등락률, 거래량, 공매도량, 공매도비중,
get_stock_chart종목의 캔들 차트 데이터를 조회합니다 (키움 ka10079~ka10083/ka10094, 수정주가 반영).
get_stock_lending대차거래(주식 대여) 정보를 조회합니다 (키움 ka10068/ka20068/ka90012).
get_stock_price6자리 종목코드로 국내 주식/ETF의 현재가, 등락률, 거래량과 기본 지표(PER·EPS·PBR·시가총액)를
get_stock_quotes여러 종목의 현재가·등락률·거래량·거래대금·시가총액을 한 번의 호출로 조회합니다 (키움 ka10095).
get_supply_concentration최근 N일 거래가 특정 가격대(매물대)에 몰린 종목을 조회합니다 (키움 ka10025).
get_theme_groups키움 테마 그룹 목록을 조회합니다 — 테마명, 종목수, 등락률, 상승/하락 종목수, 기간수익률(10일),
get_theme_stocks특정 테마 그룹의 구성종목과 시세를 조회합니다 — 종목별 현재가, 전일대비, 등락률, 거래량,
get_trading_journal특정일의 당일매매일지를 조회합니다 — 종목별 매수/매도 평균가·수량, 손익금액, 수익률과 총손익·총수익률
get_transactions계좌의 거래내역(매수/매도 등)을 기간별로 조회합니다 (키움 kt00015). 기본 조회 기간은
get_valuation_rank시장 전체를 PER·PBR·ROE 중 **한 가지 기준**으로 줄 세운 상위 100종목을 조회합니다 (키움 ka10026).
get_vi_stocks당일 변동성완화장치(VI)가 발동된 종목을 조회합니다 — 발동가격·괴리율·시가대비등락률·발동/해제
get_watchlist관심종목 그룹에 담긴 종목 목록을 조회합니다 (키움 ka01301, 읽기 전용).
get_watchlist_groups영웅문(HTS)에 저장한 관심종목 그룹 목록(그룹코드+그룹명)을 조회합니다 (키움 ka01300, 읽기 전용).
pingHealth check for the Kiwoom MCP server. Takes no arguments and returns a fixed message.
search_stock종목명(부분 일치)이나 6자리 코드로 코스피/코스닥 상장 종목(ETF/ETN 포함)을 검색해
Public scan report
scanner v0.1.10 · 2026-11-01 · same rubric, same numbers if you re-run it
- Code scan72 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 2 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Kiwoom Securities MCP Server compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 65% of 48,255 servers
- Tools
- 50
- the typical server has 7
- Tools that change things
- 4%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 28,688 servers
- Downloads a week
- 109
- more than 65% of 12,191 servers with a package
What its tools let an agent do: 48 read · 2 change
Install Kiwoom Securities MCP Server in Claude Code, Cursor or VS Code
Runs npx -y kiwoom-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add kiwoom-mcp-server -- npx -y kiwoom-mcp-server
What the publisher says
From the Kiwoom Securities MCP Server repository's README, as published. We do not edit it. Read it on GitHub
kiwoom-mcp-server
한국어 · English
키움증권 REST API를 조회 전용(read-only) 으로 노출하는 MCP 서버입니다. Claude Desktop / Claude Code에서 자연어로 국내 주식 시세·차트·호가·지수·순위·수급과 내 계좌의 잔고·보유 종목·거래내역을 조회할 수 있고, ISA 계좌라면 비과세 한도 대비 손익통산 현황까지 계산해 줍니다.
⚠️ 보안 경고
- 기본 실행은 로컬 stdio입니다. 원격에서 써야 한다면 반드시 인증이 내장된
HTTP 모드(원격 연결 참조)로만 노출하고,
인증 없는 상태(--no-auth)로는 절대 외부 네트워크에 열지 마세요.
- .env의 AppKey/AppSecret은 실계좌 조회 권한입니다. 절대 커밋하지 마세요
(.gitignore에 이미 등록되어 있습니다).
- 주문(매수/매도/정정/취소) 기능은 설계상 제외되어 있습니다. 이 서버가 계좌를
변경하는 일은 없습니다.
제공 Tool
시장 데이터 (계좌와 무관, 앱키만 있으면 사용 가능):
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Kiwoom Securities MCP Server: common questions
- Is Kiwoom Securities MCP Server safe?
- Mostly: it is graded B (83/100). Read the Kiwoom Securities MCP Server safety report
- How do I install Kiwoom Securities MCP Server?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Kiwoom Securities MCP Server need an API key?
- Yes. The registry entry asks for
KIWOOM_APP_KEY,KIWOOM_APP_SECRET. - Is Kiwoom Securities MCP Server maintained?
- The last commit was 4 days ago (2026-10-31). The latest release is v0.52.6.
- How does Kiwoom Securities MCP Server compare with other MCP servers?
- safety score 83/100 (higher than 65% of 48,255 servers); tools 50 (the typical server has 7); tools that change things 4% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.