sharebook-kr avatar

pykrx-mcp

sharebook-kr/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 tools

Public 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

PyPI version Python 3.10+ Open in Dev Containers

한국 주식 시장 데이터를 AI 에이전트에게 제공하는 MCP (Model Context Protocol) 서버입니다.

pykrx 라이브러리를 기반으로 KOSPI, KOSDAQ, KONEX 시장의 주가, 재무제표, 투자자별 수급, 공매도 등 다양한 데이터를 ChatGPT와 Claude에서 자연어로 조회할 수 있습니다.


☕ 후원하기

프로젝트가 도움이 되었다면 개발자를 응원해주세요!

Sponsor


1. 시작하기

1.1 Claude Desktop에서 사용하기

자동 설치 (권장)

MCP Registry를 통한 원클릭 설치:

npx @modelcontextprotocol/inspector install pykrx-mcp
수동 설치

Claude Desktop 설정 파일을 직접 수정:


View the full README on GitHub

Details

Repository
github.com/sharebook-kr/pykrx-mcp
Category
Data & Analytics
Package
pykrx-mcp
Transport
STDIO
Registry
MCP registry, active

Related Data & Analytics MCP servers

View all
1shigechika avatarJ-Quants MCPshigechika/jquants-mcpMCP server for retrieving Japanese stock market data via J-Quants API v23stars
2txn2 avatarMcp Datahubtxn2/mcp-datahubMCP server for DataHub data catalogs. Discover datasets, explore lineage, and access metadata.3stars
3windsor-ai avatarWindsor.ai MCPwindsor-ai/windsor_mcpQuery and analyze marketing, sales, and business data from 325+ platforms via Windsor.ai.3stars
4alphago2580 avatarAlphago2580 Naramarketmcpalphago2580/naramarketmcpAccess Korea’s G2B procurement and Nara Market data for bid notices, awards, contracts, statistics…2stars
5akshaysharma1088 avatarpipeverifyakshaysharma1088/pipeverifyRead-only check that a pipeline change left the data right: pass, review or block.2stars
6alexzavialov avatartravel.artalexzavialov/travel-art-mcpArt-tourism data for AI agents: biennales, art fairs, museums, layover itineraries with 2026 facts.2stars