{"name":"io.github.ChunSam/kiwoom-mcp-server","slug":"chunsam-kiwoom-mcp-server","title":"Kiwoom Securities MCP Server","description":"Read-only MCP server for the Kiwoom Securities REST API: market data, account inquiry, ISA tax tool","url":"https://mcp.market/server/chunsam-kiwoom-mcp-server","rating":null,"grade":"B","score":83,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":31,"stars":1,"forks":0,"downloads_week":109,"last_push_at":"2026-10-31T07:15:32.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/ChunSam/kiwoom-mcp-server","website":"https://github.com/ChunSam/kiwoom-mcp-server#readme","version":"0.52.6","remotes":[],"packages":[{"registryType":"npm","identifier":"kiwoom-mcp-server","version":"0.52.6","transport":{"type":"stdio"},"environmentVariables":[{"description":"Kiwoom REST API app key (issued at openapi.kiwoom.com; VIRTUAL and REAL need separate keys)","isRequired":true,"isSecret":true,"name":"KIWOOM_APP_KEY"},{"description":"Kiwoom REST API app secret","isRequired":true,"isSecret":true,"name":"KIWOOM_APP_SECRET"},{"description":"VIRTUAL (모의투자, mock trading) or REAL (실전투자, live account)","default":"VIRTUAL","choices":["VIRTUAL","REAL"],"name":"KIWOOM_MODE"},{"description":"Opt-in switch for the ISA tax-allowance tool (set true together with ISA_TYPE / ISA_OPENED_ON)","format":"boolean","default":"false","name":"ISA_ENABLED"}]}],"tools":[{"name":"calc_isa_tax_status","description":"ISA 계좌의 손익통산 순이익을 계산해 비과세 한도(일반형 200만원/서민형 400만원) 대비","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_account_balance","description":"view=summary(기본)는 계좌의 예수금(주문가능/출금가능 포함)과 총매입금액, 총평가금액,","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_account_holdings","description":"계좌의 보유 종목 목록을 조회합니다 — 종목별 수량, 평균단가, 현재가, 평가금액,","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_account_today","description":"오늘 하루 계좌에 무슨 일이 있었는지를 한 장으로 조회합니다 (키움 kt00017) — 매도·매수 금액,","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_account_trend","description":"일별 추정예탁자산(예수금·대용금 포함) 추이와 기간 수익률·평가손익·입출금 요약을 조회합니다","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_after_hours","description":"장 종료 후 시간외 단일가 매매(16:00~18:00 KST) 정보를 조회합니다 (키움 ka10087/ka10098).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_broker_activity","description":"증권사 창구별 매매 동향을 조회합니다 (키움 ka10002/ka10102/ka10037/ka10038/ka10053).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_credit_trend","description":"특정 종목의 신용융자(빚내서 산 물량) 또는 대주(빌려서 판 물량) 신규·상환·잔고 추이를","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_daily_trading","description":"종목의 일자별 거래를 한 번의 호출로 조회합니다 (키움 ka10086/ka10015).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_equal_net_trade","description":"기관과 외국인이 **같은 방향으로 동시에** 순매매한 종목 순위를 조회합니다 (키움 ka10062).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_etf_info","description":"ETF의 추적지수, 과세유형, 현재 시세, NAV·괴리율을 조회합니다 (키움 ka40002+ka10001+ka40009).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_etf_rank","description":"상장 ETF 전 종목(약 1,150개)을 한 번에 훑어 괴리율·등락률·거래량·추적오차로 정렬합니다 (키움 ka40004).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_etf_returns","description":"ETF의 성과를 세 각도로 조회합니다 (키움 ka40001/ka40003/ka40008).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_execution_strength","description":"종목의 체결강도(매수 체결량 ÷ 매도 체결량 × 100) 추이를 조회합니다 (키움 ka10046/ka10047).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_expected_execution","description":"예상체결가 기준 순위를 조회합니다 (키움 ka10029). 예상체결가는 '지금 체결된다면 이 값'이라","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_foreign_holding","description":"외국인 보유(한도) 동향을 조회합니다 (키움 ka10008/ka10036/ka10034/ka10035).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_foreign_intraday","description":"정규장 중 **어떤 주체가 지금 사고 있는 종목**을 전 종목에서 뽑습니다 (키움 ka10063/ka10065).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_gold_price","description":"KRX 금시장(금현물) 시세를 조회합니다 (키움 ka50010/ka50012).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_institution_trend","description":"특정 종목을 기관·외국인이 **대략 얼마에 담았는지**(추정평균단가)와 일별·기간누적 순매수를","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_investor_rank","description":"외국인과 기관이 많이 사고판 종목을 조회합니다 (키움 ka90009/ka10131).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_investor_trend","description":"종목의 개인/외국인/기관 순매수 동향을 조회합니다 (키움 ka10059+ka10061). 기간 합계와","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_market_index","description":"코스피/코스닥 종합지수와 업종별 지수를 조회합니다 (키움 ka20003).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_market_movers","description":"시장 특이 종목을 조회합니다 (키움 ka10016/ka10017/ka10019/ka10023/ka10024). signal:","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_net_buy_rank","description":"시장 전 종목을 훑어 **투자자 주체별 순매수 상위**를 뽑습니다 (키움 ka10066).","write_action":true,"price_micros":0,"input_schema":null},{"name":"get_order_executions","description":"계좌의 **최근** 체결(실제로 체결된 주문) 내역을 조회합니다 — **지난 일자의 체결은 나오지 않습니다**.","write_action":true,"price_micros":0,"input_schema":null},{"name":"get_orderbook","description":"종목의 10단계 매도/매수 호가와 잔량을 KRX+넥스트레이드(NXT) 통합 기준으로 조회합니다 (키움 ka10007).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_orderbook_rank","description":"시장 전체에서 호가 잔량이 두껍거나 급증한 종목을 조회합니다 (키움 ka10020/ka10021/ka10022).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_pending_orders","description":"계좌의 미체결(아직 체결되지 않은) 주문 목록을 조회합니다 — 주문번호, 종목, 매수/매도 구분,","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_program_trading","description":"프로그램 매매 상위 종목과 추이를 조회합니다 (키움 ka90003/ka90004/ka90010/ka90005/ka90013/ka90008/ka90006).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_ranking","description":"당일 시장 순위를 조회합니다 (키움 ka10027/ka10030/ka10032/ka10028/ka10033). type: rise(상승률)/","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_sector_chart","description":"업종(섹터) 지수의 캔들 차트를 조회합니다 (키움 ka20004~ka20008/ka20019).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_sector_flow","description":"시장 전체 업종의 투자자 주체별 순매수를 한 번에 조회합니다 (키움 ka10051).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_sector_price","description":"업종(섹터) 지수의 현재가 상세를 조회합니다 (키움 ka20001) — 지수·시/고/저가·거래량·","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_sector_stocks","description":"특정 **업종**(KRX 표준 분류)에 속한 종목들의 시세를 조회합니다 (키움 ka20002). 종목코드순 정렬이며","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_short_selling","description":"특정 종목의 일자별 공매도 추이를 조회합니다 — 종가, 등락률, 거래량, 공매도량, 공매도비중,","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_stock_chart","description":"종목의 캔들 차트 데이터를 조회합니다 (키움 ka10079~ka10083/ka10094, 수정주가 반영).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_stock_lending","description":"대차거래(주식 대여) 정보를 조회합니다 (키움 ka10068/ka20068/ka90012).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_stock_price","description":"6자리 종목코드로 국내 주식/ETF의 현재가, 등락률, 거래량과 기본 지표(PER·EPS·PBR·시가총액)를","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_stock_quotes","description":"여러 종목의 현재가·등락률·거래량·거래대금·시가총액을 한 번의 호출로 조회합니다 (키움 ka10095).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_supply_concentration","description":"최근 N일 거래가 특정 가격대(매물대)에 몰린 종목을 조회합니다 (키움 ka10025).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_theme_groups","description":"키움 테마 그룹 목록을 조회합니다 — 테마명, 종목수, 등락률, 상승/하락 종목수, 기간수익률(10일),","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_theme_stocks","description":"특정 테마 그룹의 구성종목과 시세를 조회합니다 — 종목별 현재가, 전일대비, 등락률, 거래량,","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_trading_journal","description":"특정일의 당일매매일지를 조회합니다 — 종목별 매수/매도 평균가·수량, 손익금액, 수익률과 총손익·총수익률","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_transactions","description":"계좌의 거래내역(매수/매도 등)을 기간별로 조회합니다 (키움 kt00015). 기본 조회 기간은","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_valuation_rank","description":"시장 전체를 PER·PBR·ROE 중 **한 가지 기준**으로 줄 세운 상위 100종목을 조회합니다 (키움 ka10026).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_vi_stocks","description":"당일 변동성완화장치(VI)가 발동된 종목을 조회합니다 — 발동가격·괴리율·시가대비등락률·발동/해제","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_watchlist","description":"관심종목 그룹에 담긴 종목 목록을 조회합니다 (키움 ka01301, 읽기 전용).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_watchlist_groups","description":"영웅문(HTS)에 저장한 관심종목 그룹 목록(그룹코드+그룹명)을 조회합니다 (키움 ka01300, 읽기 전용).","write_action":false,"price_micros":0,"input_schema":null},{"name":"ping","description":"Health check for the Kiwoom MCP server. Takes no arguments and returns a fixed message.","write_action":false,"price_micros":0,"input_schema":null},{"name":"search_stock","description":"종목명(부분 일치)이나 6자리 코드로 코스피/코스닥 상장 종목(ETF/ETN 포함)을 검색해","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":83,"grade":"B","scanned_at":"2026-11-01T22:09:53.512Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-11-01T22:09:53.515Z","components":{"code":{"score":25,"max":25,"notes":["72 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":6,"max":15,"notes":["static API keys via environment variables"]},"maintenance":{"score":15,"max":15,"notes":["last push 2 days ago"]},"identity":{"score":8,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[],"inputs":{"packages":[{"registryType":"npm","identifier":"kiwoom-mcp-server","version":"0.52.6","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":2,"publishedAt":"2026-08-21T13:36:07.874Z","repositoryUrl":"git+https://github.com/ChunSam/kiwoom-mcp-server.git"}],"repo":{"found":true,"owner":"ChunSam","repo":"kiwoom-mcp-server","archived":false,"pushedAt":"2026-10-31T07:15:32Z","stars":1,"forks":0,"openIssues":12,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/54945494?v=4","ownerCreatedAt":"2019-09-05T13:37:06Z","license":"MIT"},"icon":{"url":null,"source":"none"},"presence":{"stars":1,"forks":0,"downloadsWeek":109,"license":"MIT","lastPushAt":"2026-10-31T07:15:32.000Z","score":31}}}},"grade_history":[],"reviews":[]}