kiwoom-mcp-server

by ChunSam

240 downloads

Not rated

GitHub Website

Finance

About

Details

Author: ChunSam
Downloads: 240
Categories: Finance

- 집계 시작일: .env의 ISA_OPENED_ON(계좌 개설일)이 기본값, 호출 시 from_date로 오버라이드 가능
- 배당·분배금이 거래내역에서 자동 감지되지 않으면 dividends_received 인자로 수동 입력
- 종목 과세유형(과세대상 vs 국내주식형)은 종목명 기반 자동 분류이며, 틀린 경우
- Node.js 20.12 이상 (process.loadEnvFile 사용)
- 키움증권 REST API 앱키 — 키움 Open API 포털에서

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name kiwoom-mcp-server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "kiwoom-mcp-server": {
            "kiwoom": {
                "command": "npx",
                "args": [
                    "-y",
                    "kiwoom-mcp-server"
                ],
                "env": {
                    "KIWOOM_APP_KEY": "your-app-key",
                    "KIWOOM_APP_SECRET": "your-app-secret",
                    "KIWOOM_MODE": "VIRTUAL"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "kiwoom-mcp-server": {
            "kiwoom": {
                "command": "npx",
                "args": [
                    "-y",
                    "kiwoom-mcp-server"
                ],
                "env": {
                    "KIWOOM_APP_KEY": "your-app-key",
                    "KIWOOM_APP_SECRET": "your-app-secret",
                    "KIWOOM_MODE": "VIRTUAL"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "kiwoom-mcp-server": {
            "kiwoom": {
                "command": "npx",
                "args": [
                    "-y",
                    "kiwoom-mcp-server"
                ],
                "env": {
                    "KIWOOM_APP_KEY": "your-app-key",
                    "KIWOOM_APP_SECRET": "your-app-secret",
                    "KIWOOM_MODE": "VIRTUAL"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "kiwoom-mcp-server": {
            "kiwoom": {
                "command": "npx",
                "args": [
                    "-y",
                    "kiwoom-mcp-server"
                ],
                "env": {
                    "KIWOOM_APP_KEY": "your-app-key",
                    "KIWOOM_APP_SECRET": "your-app-secret",
                    "KIWOOM_MODE": "VIRTUAL"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "kiwoom-mcp-server": {
            "kiwoom": {
                "command": "npx",
                "args": [
                    "-y",
                    "kiwoom-mcp-server"
                ],
                "env": {
                    "KIWOOM_APP_KEY": "your-app-key",
                    "KIWOOM_APP_SECRET": "your-app-secret",
                    "KIWOOM_MODE": "VIRTUAL"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "kiwoom-mcp-server": {
            "kiwoom": {
                "command": "npx",
                "args": [
                    "-y",
                    "kiwoom-mcp-server"
                ],
                "env": {
                    "KIWOOM_APP_KEY": "your-app-key",
                    "KIWOOM_APP_SECRET": "your-app-secret",
                    "KIWOOM_MODE": "VIRTUAL"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "kiwoom-mcp-server": {
            "kiwoom": {
                "command": "npx",
                "args": [
                    "-y",
                    "kiwoom-mcp-server"
                ],
                "env": {
                    "KIWOOM_APP_KEY": "your-app-key",
                    "KIWOOM_APP_SECRET": "your-app-secret",
                    "KIWOOM_MODE": "VIRTUAL"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "kiwoom-mcp-server": {
            "kiwoom": {
                "command": "npx",
                "args": [
                    "-y",
                    "kiwoom-mcp-server"
                ],
                "env": {
                    "KIWOOM_APP_KEY": "your-app-key",
                    "KIWOOM_APP_SECRET": "your-app-secret",
                    "KIWOOM_MODE": "VIRTUAL"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "kiwoom-mcp-server": {
            "kiwoom": {
                "command": "npx",
                "args": [
                    "-y",
                    "kiwoom-mcp-server"
                ],
                "env": {
                    "KIWOOM_APP_KEY": "your-app-key",
                    "KIWOOM_APP_SECRET": "your-app-secret",
                    "KIWOOM_MODE": "VIRTUAL"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "kiwoom-mcp-server": {
            "kiwoom": {
                "command": "npx",
                "args": [
                    "-y",
                    "kiwoom-mcp-server"
                ],
                "env": {
                    "KIWOOM_APP_KEY": "your-app-key",
                    "KIWOOM_APP_SECRET": "your-app-secret",
                    "KIWOOM_MODE": "VIRTUAL"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "kiwoom-mcp-server": {
            "kiwoom": {
                "command": "npx",
                "args": [
                    "-y",
                    "kiwoom-mcp-server"
                ],
                "env": {
                    "KIWOOM_APP_KEY": "your-app-key",
                    "KIWOOM_APP_SECRET": "your-app-secret",
                    "KIWOOM_MODE": "VIRTUAL"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "kiwoom-mcp-server": {
            "kiwoom": {
                "command": "npx",
                "args": [
                    "-y",
                    "kiwoom-mcp-server"
                ],
                "env": {
                    "KIWOOM_APP_KEY": "your-app-key",
                    "KIWOOM_APP_SECRET": "your-app-secret",
                    "KIWOOM_MODE": "VIRTUAL"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "kiwoom-mcp-server": {
            "kiwoom": {
                "command": "npx",
                "args": [
                    "-y",
                    "kiwoom-mcp-server"
                ],
                "env": {
                    "KIWOOM_APP_KEY": "your-app-key",
                    "KIWOOM_APP_SECRET": "your-app-secret",
                    "KIWOOM_MODE": "VIRTUAL"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "kiwoom-mcp-server": {
            "kiwoom": {
                "command": "npx",
                "args": [
                    "-y",
                    "kiwoom-mcp-server"
                ],
                "env": {
                    "KIWOOM_APP_KEY": "your-app-key",
                    "KIWOOM_APP_SECRET": "your-app-secret",
                    "KIWOOM_MODE": "VIRTUAL"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "kiwoom-mcp-server": {
            "kiwoom": {
                "command": "npx",
                "args": [
                    "-y",
                    "kiwoom-mcp-server"
                ],
                "env": {
                    "KIWOOM_APP_KEY": "your-app-key",
                    "KIWOOM_APP_SECRET": "your-app-secret",
                    "KIWOOM_MODE": "VIRTUAL"
                }
            }
        }
    }
}

From the repository

The README includes setup instructions such as "command": "npx",.

`ping`

Health check for the Kiwoom MCP server. Takes no arguments and returns a fixed message. Use this to verify the server is connected.

`search_stock`

종목명(부분 일치)이나 6자리 코드로 코스피/코스닥 상장 종목(ETF/ETN 포함)을 검색해 종목코드를 찾습니다 (키움 ka10099). 다른 tool에 넘길 종목코드를 모를 때 먼저 사용하세요. 거래정지·관리종목·투자경고 같은 투자유의 상태는 비고 컬럼에 표시됩니다. 첫 호출은 종목 마스터를 내려받아 몇 초 걸리고, 이후 12시간 동안 캐시됩니다.

`get_stock_price`

6자리 종목코드로 국내 주식/ETF의 현재가, 등락률, 거래량과 기본 지표(PER·EPS·PBR·시가총액)를 조회합니다 (키움 ka10001). 배당수익률·배당금은 키움 REST API에 조회 TR이 없어 제공하지 않습니다. 업종·상장일과 거래정지/관리종목/투자경고 같은 투자유의 상태도 함께 표시됩니다. 종목명만 알고 있다면 search_stock으로 먼저 코드를 찾으세요.

`get_stock_quotes`

여러 종목의 현재가·등락률·거래량·거래대금·시가총액을 한 번의 호출로 조회합니다 (키움 ka10095). 보유 종목이나 관심 종목처럼 2개 이상 종목의 시세가 필요할 때 get_stock_price를 반복 호출하는 대신 사용하세요 (최대 30종목). 거래정지/관리종목/투자경고 같은 투자유의 상태도 비고에 표시됩니다.

`get_stock_chart`

종목의 캔들 차트 데이터를 조회합니다 (키움 ka10079~ka10083/ka10094, 수정주가 반영). period: day(일봉, 기본)/week(주봉)/month(월봉)/year(년봉)/minute(분봉)/tick(틱봉). 분봉은 minute_scope로 분 단위를, 틱봉은 tick_scope로 캔들당 틱 수를 지정합니다. 종목코드를 모르면 search_stock으로 먼저 찾으세요.

`get_daily_trading`

종목의 일자별 거래를 한 번의 호출로 조회합니다 (키움 ka10086/ka10015). view=flow(기본)는 종가·등락률·거래량·거래대금과 함께 개인/기관/외국인 순매수, 프로그램, 신용비율을 한 행에 묶어 줍니다 — '이 종목을 최근 누가 사고팔았나'를 볼 때 첫 번째로 쓰는 tool입니다. view=session은 같은 일자별로 장전/장중/장후 거래 분포를 보여줍니다. 가격 캔들만 필요하면 get_stock_chart, 투자자 주체를 증권·투신·연기금까지 세분해 보려면 get_investor_trend, 외국인 보유비중 추이는 get_foreign_holding을 쓰세요.

`get_orderbook`

종목의 10단계 매도/매수 호가와 잔량을 KRX+넥스트레이드(NXT) 통합 기준으로 조회합니다 (키움 ka10007). 지금 어느 가격에 대기 물량이 얼마나 쌓였는지, 매수·매도 어느 쪽이 두꺼운지 볼 때 씁니다. 호가는 체결이 아니라 대기 주문이므로, 실제 체결 쪽 힘은 get_execution_strength(체결강도)를 보세요 — 계좌의 체결 내역은 get_order_executions이고, 여러 종목의 현재가를 한 번에 볼 때가 get_stock_quotes입니다. 종목코드를 모르면 search_stock으로 먼저 찾으세요.

`get_orderbook_rank`

시장 전체에서 호가 잔량이 두껍거나 급증한 종목을 조회합니다 (키움 ka10020/ka10021/ka10022). view=balance(기본)는 총매수/매도 잔량과 순매수 잔량 상위, view=surge는 최근 N분간 잔량 수량이 급증한 종목, view=ratio_surge는 매수/매도 잔량 비율이 급격히 기운 종목입니다. 정규장(09:00~15:30) 중에만 산출되며 그 밖의 시간에는 비어 있거나 잔량이 0으로 옵니다. 특정 종목 하나의 10단 호가는 get_orderbook, 체결 쪽 힘은 get_execution_strength를 쓰세요.

`get_market_index`

코스피/코스닥 종합지수와 업종별 지수를 조회합니다 (키움 ka20003). 첫 행이 시장 종합지수, 이후는 업종 지수입니다. 각 행의 '코드'는 get_sector_price / get_sector_stocks의 sector_code로 사용할 수 있습니다.

`get_sector_price`

업종(섹터) 지수의 현재가 상세를 조회합니다 (키움 ka20001) — 지수·시/고/저가·거래량·상승/하락 종목수·52주 고저·시간대별 추이. sector_code는 get_market_index가 보여주는 업종 코드이며(001 코스피 종합, 002 코스피 대형주, 101 코스닥 종합, 201 KOSPI200 등) '증권'처럼 업종명을 그대로 넣어도 됩니다.

`get_sector_stocks`

특정 업종에 속한 종목들의 시세를 조회합니다 (키움 ka20002). 종목코드순 정렬이며 첫 페이지(최대 100종목)만 가져옵니다. sector_code는 get_market_index의 업종 코드이거나 업종명입니다.

`get_sector_chart`

업종(섹터) 지수의 캔들 차트를 조회합니다 (키움 ka20004~ka20008/ka20019). period: day(일봉, 기본)/week(주봉)/month(월봉)/year(년봉)/minute(분봉)/tick(틱봉). sector_code는 get_market_index의 업종 코드이거나 업종명입니다 (001 코스피 종합, 002 코스피 대형주, 101 코스닥 종합, 201 KOSPI200 등).

`get_sector_flow`

시장 전체 업종의 투자자 주체별 순매수를 한 번에 조회합니다 (키움 ka10051). '오늘 돈이 어느 섹터로 갔나'를 볼 때 쓰는 tool로, 업종마다 개인/외국인/기관계와 증권·투신·연기금·사모 순매수를 지수 등락률과 함께 보여줍니다. 종목 단위 수급은 get_investor_trend, 종목별 순매수 상위는 get_investor_rank, 특정 업종의 지수 상세와 구성 종목은 get_sector_price / get_sector_stocks를 쓰세요.

`get_ranking`

당일 시장 순위를 조회합니다 (키움 ka10027/ka10030/ka10032/ka10028/ka10033). type: rise(상승률)/fall(하락률)/volume(거래량)/value(거래대금)/open_rise(시가대비 상승률)/open_fall(시가대비 하락률)/credit_ratio(신용비율). market: all(전체, 기본)/kospi/kosdaq. rise·fall은 전일 종가 기준이고 open_rise·open_fall은 **오늘 시가 기준**이라, 갭으로 뜬 뒤 밀렸는지 장중에 밀어올렸는지를 가릅니다(체결강도 컬럼 포함). 시가대비 두 종류는 시장 전 종목을 훑어야 해서 market이 kospi 또는 kosdaq여야 하고, min_volume(거래량 하한, 기본 1만주)으로 모수를 좁힙니다. credit_ratio는 신용융자 잔고비율이 높은 종목으로, 반대매매 압력이 쌓인 곳을 찾을 때 씁니다 — 특정 종목의 신용잔고 시계열은 get_credit_trend를 쓰세요.

`get_valuation_rank`

시장 전체를 PER·PBR·ROE 중 **한 가지 기준**으로 줄 세운 상위 100종목을 조회합니다 (키움 ka10026). 지표를 조합해 거르지는 못하므로 '저PER 저PBR'은 metric을 바꿔 두 번 부릅니다. 저PER·저PBR은 가치주 스크리닝, 고ROE는 자본효율이 높은 기업 찾기, 고PBR·저ROE는 과열·부실 점검에 씁니다. 거래량·등락률 기준 순위는 get_ranking, 특정 종목 하나의 PER·PBR은 get_stock_price를 쓰세요 — 밸류에이션으로 시장을 훑는 것은 이 tool뿐입니다.

`get_supply_concentration`

최근 N일 거래가 특정 가격대(매물대)에 몰린 종목을 조회합니다 (키움 ka10025). 매물대는 반등 시 저항·하락 시 지지로 읽히므로, 현재가 위아래 어디에 물량이 뭉쳐 있는지 확인할 때 씁니다. 특정 종목 하나의 호가 잔량은 get_orderbook, 거래량 급증 종목은 get_market_movers를 쓰세요 — 가격대별 거래 분포를 보는 것은 이 tool뿐입니다.

`get_market_movers`

시장 특이 종목을 조회합니다 (키움 ka10016/ka10017/ka10019/ka10023/ka10024). signal: new_high(신고가)/new_low(신저가)/upper_limit(상한가)/lower_limit(하한가)/surge(급등)/plunge(급락)/volume_surge(거래량급증)/volume_renew(거래량갱신). market: all(전체, 기본)/kospi/kosdaq. 신고/신저는 days(5/10/20/60/250일, 기본 5일) 기준, 급등/급락과 거래량급증은 전일 대비입니다 (거래량급증은 급증량 순, 5천주 이상). volume_renew는 **직전 cycle거래일(5/10/20/60/120, 기본 20) 중 최대 거래량을 오늘 갱신한** 종목으로, 전일 하루만 보는 volume_surge보다 긴 호흡의 거래량 돌파를 찾을 때 씁니다.

`get_vi_stocks`

당일 변동성완화장치(VI)가 발동된 종목을 조회합니다 — 발동가격·괴리율·시가대비등락률·발동/해제 시각·발동횟수 (키움 ka10054). market: all(기본)/kospi/kosdaq, direction: all(기본)/up(상승)/down(하락), vi_type: all(기본)/static(정적)/dynamic(동적). stock_code를 지정하면 해당 종목의 당일 발동 내역만 조회하며, 이때 market은 무시됩니다(종목의 시장과 어긋나면 결과가 비므로 전체 기준으로 봅니다).

`get_expected_execution`

예상체결가 기준 순위를 조회합니다 (키움 ka10029). 예상체결가는 '지금 체결된다면 이 값'이라 동시호가(개장 전 08:30~09:00, 마감 전 15:20~15:30)에 오늘의 시초가·종가 방향을 미리 볼 때 특히 유용합니다. 키움이 예상체결을 산출하지 않는 시간대에는 빈 결과가 돌아옵니다(오류가 아닙니다). 실제로 체결된 결과의 등락률·거래량 순위는 get_ranking, 신고가·상한가·급등 같은 특이 종목은 get_market_movers, 시간외 단일가는 get_after_hours를 쓰세요.

`get_investor_trend`

종목의 개인/외국인/기관 순매수 동향을 조회합니다 (키움 ka10059+ka10061). 기간 합계와 최근 거래일별 내역을 함께 보여줍니다. unit: amount(금액, 백만원, 기본)/quantity(수량, 주). 같은 일자에 종가·거래량·프로그램·신용비율까지 한 행으로 묶어 보려면 get_daily_trading(view=flow), 기관·외국인이 담은 추정평균단가는 get_institution_trend, 주체를 정해 종목을 찾을 때는 get_net_buy_rank를 쓰세요. 종목코드를 모르면 search_stock으로 먼저 찾으세요.

`get_institution_trend`

특정 종목을 기관·외국인이 **대략 얼마에 담았는지**(추정평균단가)와 일별·기간누적 순매수를 조회합니다 (키움 ka10045). 현재가와 추정단가를 비교하면 두 주체의 평가손익 구간을 가늠할 수 있습니다. 투자자 주체를 더 잘게(개인·금융투자·보험·투신·연기금 등) 보려면 get_investor_trend를, 외국인 보유주식수·한도소진률 추이는 get_foreign_holding을 쓰세요 — 단가를 주는 것은 이 tool뿐입니다.

`get_investor_rank`

외국인과 기관이 많이 사고판 종목을 조회합니다 (키움 ka90009/ka10131). view: daily(일자별 순매수·순매도 상위, 기본) / streak(N일 연속 순매수 상위). "오늘 외국인이 뭘 샀나", "외국인이 며칠째 사는 종목" 질문에 사용하세요. daily는 market all/kospi/kosdaq, streak는 kospi/kosdaq만 지원합니다. 여기서 말하는 순매수·연속은 **매매 기준**입니다 — 외국인 보유주식수·한도소진률 기준의 연속 순매매는 get_foreign_holding(rank=streak)이고 데이터 소스가 달라 같은 종목에서 부호가 반대일 수 있습니다. 연기금·투신처럼 12주체를 고르려면 get_net_buy_rank를 쓰세요.

`get_net_buy_rank`

시장 전 종목을 훑어 **투자자 주체별 순매수 상위**를 뽑습니다 (키움 ka10066). '연기금이 어제 뭘 담았나', '투신 순매도 상위', '사모펀드가 산 코스닥 종목'처럼 **주체를 정하고 종목을 찾을 때** 쓰세요. 개인·외국인·기관계 외에 금융투자·보험·투신·은행· 연기금등·사모펀드·기타금융·국가·기타법인까지 12주체를 고를 수 있습니다. 종목을 이미 정했다면 get_investor_trend(종목 1개의 주체별 시계열)가 낫고, 외국인·기관만 빠르게 보려면 get_investor_rank(상위 25종목)가 가볍습니다. market(kospi 또는 kosdaq)은 필수이고 전체 시장을 한 번에 보는 옵션은 없습니다. 수치는 직전 완료 거래일 기준이며, 장중 실시간은 get_foreign_intraday(외국인 한정)를 쓰세요.

`get_equal_net_trade`

기관과 외국인이 **같은 방향으로 동시에** 순매매한 종목 순위를 조회합니다 (키움 ka10062). 두 주체의 방향이 겹치는 종목과 **각각의 추정 평균단가**를 함께 주는 건 이 tool뿐입니다 — 현재가와 평단을 비교하면 누가 물려 있고 누가 이익 구간인지 볼 수 있습니다. direction: net_buy(동시 순매수, 기본)/net_sell(동시 순매도). 주체별로 따로 보려면 get_net_buy_rank(마감 후 12주체)나 get_investor_trend(종목별)를 쓰세요.

`get_foreign_intraday`

정규장 중 **어떤 주체가 지금 사고 있는 종목**을 전 종목에서 뽑습니다 (키움 ka10063/ka10065). '오늘 외국인이 뭘 담고 있나', '장중 연기금 순매수 상위'처럼 **실시간 수급**을 볼 때 쓰세요. investor로 외국인(기본)·기관계·보험·투신·연기금등·기타법인을 고릅니다 — 개인·금융투자는 거래소가 장중에 공개하지 않아 조회할 수 없습니다. 값은 1,000주 단위 잠정치라 **마감 후 확정치와 다릅니다**(부호가 반대일 수도 있음) — 마감된 거래일 기준은 get_net_buy_rank, 종목을 이미 정했다면 get_investor_trend를 쓰세요.

`get_broker_activity`

증권사 창구별 매매 동향을 조회합니다 (키움 ka10002/ka10102/ka10037/ka10038/ka10053). stock_code를 주면 **그 종목의 당일 거래원 상위 5개사**(매수/매도)이고, 외국계 창구에는 🌐를 붙입니다. 같은 종목을 `view=broker_rank`로 부르면 **전 거래원 50개사의 누적 순위**를 순매수/순매도로 갈라 보고, `view=dropout`이면 **당일 상위에서 빠진 창구와 그 시각**을 봅니다(누가 언제 발을 뺐는지). stock_code를 생략하면 **시장 전체에서 외국계 창구 순매매가 큰 종목 순위**입니다 (direction: net_buy 기본/net_sell/all, days: 1·5·10일 누적). 둘 다 **창구 기준**이라 투자자 주체별 순매수와는 다릅니다 — 외국인 순매수 자체는 get_investor_trend나 get_foreign_intraday를 쓰세요.

`get_etf_info`

ETF의 추적지수, 과세유형, 현재 시세, NAV·괴리율을 조회합니다 (키움 ka40002+ka10001+ka40009). 종목코드를 모르면 search_stock으로 먼저 찾으세요.

`get_etf_returns`

ETF의 성과를 세 각도로 조회합니다 (키움 ka40001/ka40003/ka40008). view=period(기본)는 기간별(1주/1개월/6개월/1년) 수익률을 대상지수 수익률과 나란히 보여줍니다 — 대상지수는 benchmark_index_code로 지정하며 기본값은 201(KOSPI200)입니다 (코드는 get_market_index의 '코드' 값: 001 코스피 종합, 101 코스닥 종합 등). view=daily는 일별 NAV와 괴리율·추적오차 추이입니다 — 'ETF가 제값에 거래되고 있나', '지수를 잘 따라가고 있나'를 물을 때 씁니다(get_etf_info는 최신 1점만 보여줍니다). view=investor는 일자별 외국인·기관 순매수량입니다(period는 기간 합계라 해상도가 다릅니다). 종목코드를 모르면 search_stock으로 먼저 찾으세요.

`get_etf_rank`

상장 ETF 전 종목(약 1,150개)을 한 번에 훑어 괴리율·등락률·거래량·추적오차로 정렬합니다 (키움 ka40004). 'NAV보다 비싸게 거래되는 ETF', '거래량 많은 ETF', '추적오차가 큰 ETF'처럼 **종목을 아직 고르지 않은 상태에서 찾을 때** 쓰세요. 종목을 이미 정했다면 get_etf_info(추적지수·과세유형·NAV)나 get_etf_returns(기간 수익률)가 낫고, ETF가 아닌 일반 주식 스크리닝은 get_valuation_rank·get_ranking을 쓰세요.

`get_gold_price`

KRX 금시장(금현물) 시세를 조회합니다 (키움 ka50010/ka50012). instrument: 1kg(금 99.99_1Kg, 기본)/100g(미니금 99.99_100g) — 상장 종목은 이 둘뿐입니다. mode: daily(일별추이 + 기관·개인 순매수, 기본)/ticks(당일 틱 체결 + 체결강도·최우선호가). 금 실물 가격(g당 원)을 볼 때 쓰며, 금 ETF·ETN은 종목이므로 get_stock_price를 쓰세요. 종목코드는 입력하지 않습니다 — 금현물에는 종목 마스터가 없어 search_stock으로 찾을 수 없습니다.

`get_execution_strength`

종목의 체결강도(매수 체결량 ÷ 매도 체결량 × 100) 추이를 조회합니다 (키움 ka10046/ka10047). 100이 균형이며, 그보다 높으면 매수세가 우세합니다. view=daily(기본)는 최근 60거래일, view=intraday는 최근 60분(1분 간격) 흐름을 보여주고 5/20/60 이동평균이 함께 옵니다. '이 종목에 매수세가 붙고 있나'를 볼 때 씁니다. 정규장 호가는 get_orderbook, 투자자 주체별 수급은 get_investor_trend를 쓰세요.

`get_short_selling`

특정 종목의 일자별 공매도 추이를 조회합니다 — 종가, 등락률, 거래량, 공매도량, 공매도비중, 공매도평균가 (키움 ka10014). 기본 조회 기간은 최근 30일이며 from_date/to_date로 변경할 수 있습니다.

`get_stock_lending`

대차거래(주식 대여) 정보를 조회합니다 (키움 ka10068/ka20068/ka90012). view=trend(기본)은 일자별 추이 — 체결·상환·증감 주수와 대차잔고, 잔고금액을 시계열로 보여줍니다. stock_code를 지정하면 해당 종목, 생략하면 시장 전체 집계이고 기본 기간은 최근 30일입니다. view=balance_rank는 특정 하루의 **대차잔고가 가장 많은 종목 순위**입니다 — '어느 종목에 대차 물량이 쌓여 있나'를 물을 때 쓰고, 한 종목의 시간 흐름은 trend를 쓰세요. balance_rank는 시장 전체 횡단면이라 stock_code·from_date를 받지 않으며(주면 무시하고 각주로 알립니다), 기준일은 to_date로 지정하되 **생략하는 쪽이 안전합니다** — 당일 집계는 장 마감 후 저녁 늦게(20시 무렵) 열려서, 오늘을 직접 지정하면 그전까지 빈 결과이고 생략하면 최신 집계일로 자동으로 물러섭니다. 공매도 흐름과 함께 보려면 get_short_selling을 참고하세요.

`get_credit_trend`

특정 종목의 신용융자(빚내서 산 물량) 또는 대주(빌려서 판 물량) 신규·상환·잔고 추이를 조회합니다 (키움 ka10013). 신용잔고가 쌓이면 하락 시 반대매매 압력이, 대주 잔고가 쌓이면 하락 베팅이 늘었다는 신호입니다. 기관·외국인의 대차거래 잔고는 get_stock_lending, 공매도 체결량 추이는 get_short_selling을 쓰세요 — 개인 신용거래를 보는 것은 이 tool뿐입니다.

`get_foreign_holding`

외국인 보유(한도) 동향을 조회합니다 (키움 ka10008/ka10036/ka10034/ka10035). stock_code를 주면 **그 종목의 일자별 추이** — 종가·거래량·외국인 순변동수량·보유주식수·보유비중·한도소진률. stock_code 없이 rank를 주면 **시장 전체 순위**입니다: limit_surge(한도소진율이 가장 많이 오른 종목)/period_net(기간 누적 순매매 상위)/streak(3일 **연속** 같은 방향으로 순매매한 종목 — 누적 크기가 아니라 방향의 지속성을 볼 때). 이 tool은 전부 외국인 **보유·한도** 계열이라, 투자자 매매 기준인 get_net_buy_rank·get_investor_trend·get_foreign_intraday와는 데이터 소스가 다릅니다(같은 종목에서 부호가 반대일 수 있음).

`get_program_trading`

프로그램 매매 상위 종목과 추이를 조회합니다 (키움 ka90003/ka90004/ka90010/ka90005/ka90013/ka90008/ka90006). view: top(당일 순매수/순매도 상위 종목, 기본) / date_rank(지정한 날짜의 순매수/순매도 상위 종목 — top과 달리 과거 날짜를 볼 수 있고 매수·매도 금액과 '거래비중'(그 종목 거래에서 프로그램이 차지한 비율)까지 나옵니다. 당일 순위는 top이 서버 집계라 더 정확합니다) / market_daily(시장 전체 일자별 추이) / market_intraday(당일 시간대별 누적 추이) / stock_daily(특정 종목의 일자별 추이 — stock_code 필수) / stock_intraday(특정 종목의 시간대별 누적 추이 — stock_code 필수, 초 단위이며 순매수 '수량'까지 나옵니다. 최근 거래일만 제공되어 base_date가 적용되지 않습니다) / arbitrage_balance(차익거래 잔고 추이 — 매매가 아니라 미청산 보유 물량이라 다른 view로는 알 수 없습니다). 한 종목의 프로그램 수급이 장중 언제 뒤집혔는지를 보려면 stock_intraday, 날짜별 흐름은 stock_daily입니다. direction은 top·date_rank에, unit은 view=top에만, market은 top·date_rank·market_daily·market_intraday에만 적용됩니다 (종목 단위 view와 arbitrage_balance에는 적용되지 않습니다). market: kospi(기본)/kosdaq — 전체(all) 옵션이 없습니다. 추이 금액 단위는 백만원입니다.

`get_after_hours`

장 종료 후 시간외 단일가 매매(16:00~18:00 KST) 정보를 조회합니다 (키움 ka10087/ka10098). stock_code를 지정하면 해당 종목의 시간외 단일가 시세와 5단 호가를, 생략하면 시장 전체 등락률 순위를 보여줍니다. 대비·등락률은 전일이 아니라 당일 종가 기준입니다. 순위는 sort(up_rate 상승률 기본/up_amount 상승폭/down_rate 하락률/down_amount 하락폭/unchanged 보합), market(all 기본/kospi/kosdaq), min_volume(거래량 하한)으로 조절합니다. 정규장 호가는 get_orderbook을 쓰세요.

`get_watchlist_groups`

영웅문(HTS)에 저장한 관심종목 그룹 목록(그룹코드+그룹명)을 조회합니다 (키움 ka01300, 읽기 전용). 특정 그룹의 종목은 get_watchlist로 조회하세요. 그룹 편집(추가/삭제)은 키움 REST API가 지원하지 않아 조회만 가능합니다.

`get_watchlist`

관심종목 그룹에 담긴 종목 목록을 조회합니다 (키움 ka01301, 읽기 전용). 그룹코드(예: '000') 또는 그룹명(예: 'etf')을 넘기세요. 그룹을 모르면 get_watchlist_groups로 먼저 확인하세요. 종목명·전일종가·시장과 거래정지/관리종목 같은 투자유의 상태를 종목 마스터에서 보강해 함께 표시합니다.

`get_theme_groups`

키움 테마 그룹 목록을 조회합니다 — 테마명, 종목수, 등락률, 상승/하락 종목수, 기간수익률(10일), 주요종목 (키움 ka90001). 기본은 등락률 상위 테마를 보여주며, stock_code를 주면 해당 종목이 편입된 테마를 검색합니다. **테마명으로 찾는 파라미터는 없어** 이름을 알고 있어도 목록에서 골라야 하고, '반도체'처럼 업종을 뜻한 것이라면 get_sector_stocks가 맞습니다. 특정 테마의 구성종목은 get_theme_stocks로 조회하세요.

`get_theme_stocks`

특정 테마 그룹의 구성종목과 시세를 조회합니다 — 종목별 현재가, 전일대비, 등락률, 거래량, 기간수익률 (키움 ka90002). theme_code는 get_theme_groups가 돌려주는 '코드' 값입니다.

`get_account_balance`

view=summary(기본)는 계좌의 예수금(주문가능/출금가능 포함)과 총매입금액, 총평가금액, 총평가손익, 추정예탁자산, 당일/당월/누적 투자손익입니다 (키움 kt00001 + kt00018 + kt00004). view=settlement은 **다음 결제일에 결제될 체결의 건별 명세**입니다 (kt00008) — summary의 D+1/D+2 추정예수금이 왜 그 값인지를 종목·수량·수수료·제세금으로 쪼개 보여줍니다. 지난 결제 내역 전체는 get_transactions(kt00015), 보유 종목별 잔고는 get_account_holdings를 쓰세요.

`get_account_holdings`

계좌의 보유 종목 목록을 조회합니다 — 종목별 수량, 평균단가, 현재가, 평가금액, 평가손익, 수익률, 보유비중 (키움 kt00018). 인자가 필요 없습니다.

`get_account_trend`

일별 추정예탁자산(예수금·대용금 포함) 추이와 기간 수익률·평가손익·입출금 요약을 조회합니다 (키움 kt00002 + kt00016). "내 계좌가 지난 한 달간 어떻게 변했나" 같은 질문에 사용하세요 (기본 30일, 최대 90일). 모의투자에서는 지원되지 않는 조회입니다.

`get_account_today`

오늘 하루 계좌에 무슨 일이 있었는지를 한 장으로 조회합니다 (키움 kt00017) — 매도·매수 금액, 수수료·세금, 입출금·입출고, D+2 추정예수금·평가금액, 신용/대출 잔액. 종목별 실현손익은 get_trading_journal, 현재 보유 종목은 get_account_holdings, 예수금·총평가 요약은 get_account_balance를 쓰세요 — 당일 현금 흐름을 보는 것은 이 tool뿐입니다. 모의투자에서는 제공되지 않습니다(RC9000).

`get_transactions`

계좌의 거래내역(매수/매도 등)을 기간별로 조회합니다 (키움 kt00015). 기본 조회 기간은 최근 30일이며 from_date/to_date로 변경, stock_code로 특정 종목만 필터링할 수 있습니다. 일자는 결제일(D+2) 기준이라 방금 체결된 건은 아직 잡히지 않습니다 — 체결가·체결시각은 get_order_executions(과거 일자는 조회되지 않습니다), 당일 종목별 손익은 get_trading_journal을 쓰세요.

`get_pending_orders`

계좌의 미체결(아직 체결되지 않은) 주문 목록을 조회합니다 — 주문번호, 종목, 매수/매도 구분, 주문상태, 주문수량, 미체결수량, 주문가격, 현재가 (키움 ka10075). stock_code로 특정 종목만 필터링할 수 있습니다. 조회 전용이며 주문 실행 기능은 제공하지 않습니다.

`get_order_executions`

계좌의 체결(실제로 체결된 주문) 내역을 조회합니다 — 주문번호, 종목, 매수/매도 구분, 주문상태, 주문/체결 수량, 주문/체결 가격, 당일 수수료·세금, 주문시각 (키움 ka10076). stock_code·side·order_no로 좁힐 수 있습니다. **기간 파라미터가 없어 조회 범위는 키움이 정하며 지난 날짜의 체결은 나오지 않습니다** (모의 실측 2026-08-19: 6일 전 체결이 0행). '어제 체결가'처럼 과거 일자를 물으면 get_transactions(결제일 D+2 기준)를 쓰세요. 아직 체결되지 않은 주문은 get_pending_orders, 당일 종목별 집계는 get_trading_journal입니다. 조회 전용이며 주문 실행 기능은 제공하지 않습니다.

`get_trading_journal`

특정일의 당일매매일지를 조회합니다 — 종목별 매수/매도 평균가·수량, 손익금액, 수익률과 총손익·총수익률 (키움 ka10170). base_date를 생략하면 오늘 기준이며, 최근 2개월 이내 날짜만 조회할 수 있습니다.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "kiwoom-mcp-server": {
            "kiwoom": {
                "command": "npx",
                "args": [
                    "-y",
                    "kiwoom-mcp-server"
                ],
                "env": {
                    "KIWOOM_APP_KEY": "your-app-key",
                    "KIWOOM_APP_SECRET": "your-app-secret",
                    "KIWOOM_MODE": "VIRTUAL"
                }
            }
        }
    }
}

McpServers

{
    "kiwoom": {
        "command": "npx",
        "args": [
            "-y",
            "kiwoom-mcp-server"
        ],
        "env": {
            "KIWOOM_APP_KEY": "your-app-key",
            "KIWOOM_APP_SECRET": "your-app-secret",
            "KIWOOM_MODE": "VIRTUAL"
        }
    }
}

Read-only MCP server for Kiwoom Securities (Korean brokerage): 28 tools for market data (quotes, charts, rankings, themes, short selling, investor flows) and account inquiry (balance, holdings, transactions), plus an optional ISA tax-allowance calculator. No order execution by design. Runs over stdio with your own API keys; optional HTTP mode with built-in OAuth for claude.ai connectors.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

ping

search_stock

get_stock_price

get_stock_quotes

get_stock_chart

get_daily_trading

get_orderbook

get_orderbook_rank

get_market_index

get_sector_price

get_sector_stocks

get_sector_chart

get_sector_flow

get_ranking

get_valuation_rank

get_supply_concentration

get_market_movers

get_vi_stocks

get_expected_execution

get_investor_trend

get_institution_trend

get_investor_rank

get_net_buy_rank

get_equal_net_trade

get_foreign_intraday

get_broker_activity

get_etf_info

get_etf_returns

get_etf_rank

get_gold_price

get_execution_strength

get_short_selling

get_stock_lending

get_credit_trend

get_foreign_holding

get_program_trading

get_after_hours

get_watchlist_groups

get_watchlist

get_theme_groups

get_theme_stocks

get_account_balance

get_account_holdings

get_account_trend

get_account_today

get_transactions

get_pending_orders

get_order_executions

get_trading_journal

Claude Desktop / Cursor

McpServers

Install

More like this

Stripe

Defeatbeta Api

MetaTrader MCP Server

EVM MCP Server

Polygon.io MCP Server

AI看线 - A股技术分析与AI预测工具

`ping`

`search_stock`

`get_stock_price`

`get_stock_quotes`

`get_stock_chart`

`get_daily_trading`

`get_orderbook`

`get_orderbook_rank`

`get_market_index`

`get_sector_price`

`get_sector_stocks`

`get_sector_chart`

`get_sector_flow`

`get_ranking`

`get_valuation_rank`

`get_supply_concentration`

`get_market_movers`

`get_vi_stocks`

`get_expected_execution`

`get_investor_trend`

`get_institution_trend`

`get_investor_rank`

`get_net_buy_rank`

`get_equal_net_trade`

`get_foreign_intraday`

`get_broker_activity`

`get_etf_info`

`get_etf_returns`

`get_etf_rank`

`get_gold_price`

`get_execution_strength`

`get_short_selling`

`get_stock_lending`

`get_credit_trend`

`get_foreign_holding`

`get_program_trading`

`get_after_hours`

`get_watchlist_groups`

`get_watchlist`

`get_theme_groups`

`get_theme_stocks`

`get_account_balance`

`get_account_holdings`

`get_account_trend`

`get_account_today`

`get_transactions`

`get_pending_orders`

`get_order_executions`

`get_trading_journal`