
pykrx-mcp
Pulls real Korean stock market data from KRX through the pykrx library into Claude or ChatGPT. You get 23 tools covering OHLCV data, market cap, PER/PBR/EPS fundamentals, investor trading breakdowns by institution type, short selling status, index composition, and ETF tracking across KOSPI, KOSDAQ, and KONEX markets. Ask in natural language for things like Samsung Electronics foreign ownership ratios, top shorted stocks, or sector index constituents and it routes to the right API. Useful if you're analyzing Korean equities and want historical prices, fundamental ratios, or institutional flow data without manually hitting exchange endpoints. Installs via uvx and connects over stdio.
- GitHub stars
- 3
- tools
- 23
- transport
- STDIO
- last updated
- Jan 31, 2026
Tools
23 toolsPublic tool metadata for what this MCP can expose to an agent.
get_market_ticker_list시장별 종목 코드 조회
시장별 종목 코드 조회
No parameter schema in public metadata yet.
get_market_ticker_name종목 코드로 종목명 조회
종목 코드로 종목명 조회
No parameter schema in public metadata yet.
get_stock_ohlcv개별 종목 OHLCV (시가/고가/저가/종가/거래량)
개별 종목 OHLCV (시가/고가/저가/종가/거래량)
No parameter schema in public metadata yet.
get_market_ohlcv_by_date특정 일자 전종목 시세
특정 일자 전종목 시세
No parameter schema in public metadata yet.
get_market_price_change기간별 전종목 가격 변동
기간별 전종목 가격 변동
No parameter schema in public metadata yet.
get_market_cap_by_date개별 종목 시가총액 조회
개별 종목 시가총액 조회
No parameter schema in public metadata yet.
get_market_fundamental_by_datePER, PBR, EPS, DIV, BPS, DPS
PER, PBR, EPS, DIV, BPS, DPS
No parameter schema in public metadata yet.
get_market_trading_value_by_date종목별 투자자 수급 (거래대금)
종목별 투자자 수급 (거래대금)
No parameter schema in public metadata yet.
get_market_trading_volume_by_investor투자자별 거래량
투자자별 거래량
No parameter schema in public metadata yet.
get_market_trading_value_by_investor투자자별 거래대금
투자자별 거래대금
No parameter schema in public metadata yet.
get_market_net_purchases_of_equities투자자별 순매수 상위 종목
투자자별 순매수 상위 종목
No parameter schema in public metadata yet.
get_index_ticker_list지수 티커 목록
지수 티커 목록
No parameter schema in public metadata yet.
get_index_ticker_name지수 이름 조회
지수 이름 조회
No parameter schema in public metadata yet.
get_index_portfolio_deposit_file지수 구성 종목
지수 구성 종목
No parameter schema in public metadata yet.
get_index_ohlcv지수 OHLCV 데이터
지수 OHLCV 데이터
No parameter schema in public metadata yet.
get_index_fundamental지수 PER/PBR/배당수익률
지수 PER/PBR/배당수익률
No parameter schema in public metadata yet.
get_shorting_status_by_date종목별 공매도 현황
종목별 공매도 현황
No parameter schema in public metadata yet.
get_shorting_volume_by_ticker전종목 공매도 거래량
전종목 공매도 거래량
No parameter schema in public metadata yet.
get_shorting_balance_top50공매도 잔고 상위 50
공매도 잔고 상위 50
No parameter schema in public metadata yet.
get_shorting_volume_top50공매도 거래 비중 상위 50
공매도 거래 비중 상위 50
No parameter schema in public metadata yet.
get_exhaustion_rates_of_foreign_investment외국인 보유량 및 한도소진률
외국인 보유량 및 한도소진률
No parameter schema in public metadata yet.
get_etf_ticker_listETF 종목 리스트
ETF 종목 리스트
No parameter schema in public metadata yet.
get_etf_ohlcv_by_dateETF OHLCV 데이터
ETF OHLCV 데이터
No parameter schema in public metadata yet.
Sponsors
Readme
pykrx-mcp
한국 주식 시장 데이터를 AI 에이전트에게 제공하는 MCP (Model Context Protocol) 서버입니다.
pykrx 라이브러리를 기반으로 KOSPI, KOSDAQ, KONEX 시장의 주가, 재무제표, 투자자별 수급, 공매도 등 다양한 데이터를 ChatGPT와 Claude에서 자연어로 조회할 수 있습니다.
☕ 후원하기
프로젝트가 도움이 되었다면 개발자를 응원해주세요!
1. 시작하기
1.1 Claude Desktop에서 사용하기
자동 설치 (권장)
MCP Registry를 통한 원클릭 설치:
npx @modelcontextprotocol/inspector install pykrx-mcp
수동 설치
Claude Desktop 설정 파일을 직접 수정:
Details
- Repository
- github.com/sharebook-kr/pykrx-mcp
- Category
- Data & Analytics
- Package
pykrx-mcp- Transport
- STDIO
- Registry
- MCP registry, active