pykrx-mcp

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/sharebook-kr-pykrx-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

23 read · 0 write · 0 deleteRead-only

Secrets

None asked for

Install scripts

Not scanned yet

Runs as

Python package

Tools (23)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• get_etf_ohlcv_by_date

  Retrieve ETF OHLCV (Open, High, Low, Close, Volume) data. This tool fetches historical ETF price data from the Korean market. Args: ticker: ETF ticker symbol (e.g., "069500" for KODEX 200) start_date: Start date in YYYYMMDD format (e.g., "20240101") end_date: End date in YYYYMMDD format (e.g., "20240131") Returns: Dictionary containing ETF OHLCV data with NAV information Example: get_etf_ohlcv_by_date("069500", "20240101", "20240131") Returns KODEX 200 ETF price data for January 2024

• get_etf_ticker_list

  Retrieve list of all ETF tickers traded on a specific date. Args: date: Date in YYYYMMDD format (e.g., "20240101") Returns: Dictionary with ETF ticker list and count Example: get_etf_ticker_list("20240101") Returns list of all ETFs traded on 2024-01-01

• get_exhaustion_rates_of_foreign_investment

  Get foreign ownership and investment limit exhaustion rates. Args: start_date: Start date in YYYYMMDD format end_date: End date (optional, for specific stock over time) ticker: Stock ticker (optional, for specific stock) market: Market type - KOSPI/KOSDAQ/KONEX balance_limit: Only show stocks with foreign ownership limits Returns: Dictionary with foreign ownership data Example: get_exhaustion_rates_of_foreign_investment("20240101", market="KOSPI")

• get_index_fundamental

  Get index fundamental data (PER/PBR/dividend yield). Args: start_date: Start date in YYYYMMDD format end_date: End date (optional, for specific index over time) ticker: Index ticker (optional, for specific index) Returns: Dictionary with fundamental indicators Example: get_index_fundamental("20240101", "20240131", "1001")

• get_index_ohlcv

  Get index OHLCV data. Args: ticker: Index ticker (e.g., "1001" for KOSPI) start_date: Start date in YYYYMMDD format end_date: End date in YYYYMMDD format freq: Frequency - d (daily), m (monthly), y (yearly) Returns: Dictionary with index OHLCV data Example: get_index_ohlcv("1001", "20240101", "20240131", "d")

• get_index_portfolio_deposit_file

  Get constituent stocks of an index. Args: ticker: Index ticker (e.g., "1005" for textile/clothing) date: Date in YYYYMMDD format (optional, defaults to latest) Returns: Dictionary with constituent ticker list Example: get_index_portfolio_deposit_file("1005")

• get_index_ticker_list

  Get list of index tickers (KOSPI/KOSDAQ indices). Args: date: Date in YYYYMMDD format, omit for latest (e.g., "20240101") market: Market type - KOSPI or KOSDAQ (default: KOSPI) Returns: Dictionary with index ticker list Example: get_index_ticker_list("20240101", "KOSPI")

• get_index_ticker_name

  Get the name of an index from its ticker. Args: ticker: Index ticker (e.g., "1001" for KOSPI) Returns: Dictionary with ticker and index name Example: get_index_ticker_name("1001")

• get_market_cap_by_date

  Retrieve market capitalization data for a stock. Use this tool to get market cap, trading volume, trading value, and outstanding shares. Args: ticker: 6-digit stock ticker code (e.g., "005930" for Samsung Electronics) start_date: Start date in YYYYMMDD format (e.g., "20240101") end_date: End date in YYYYMMDD format (e.g., "20240131") Returns: Dictionary with market cap data including 시가총액, 거래량, 거래대금, 상장주식수

• get_market_fundamental_by_date

  Retrieve fundamental data (PER, PBR, dividend yield, etc.) for a stock. This tool fetches fundamental indicators that help evaluate stock valuation. Args: ticker: Stock ticker symbol (e.g., "005930" for Samsung Electronics) start_date: Start date in YYYYMMDD format (e.g., "20240101") end_date: End date in YYYYMMDD format (e.g., "20240131") Returns: Dictionary containing fundamental data (BPS, PER, PBR, EPS, DIV, DPS) Example: get_market_fundamental_by_date("005930", "20240101", "20240131") Returns Samsung fundamental data for January 2024

• get_market_net_purchases_of_equities

  Get top stocks by net purchases for specific investor type. Args: start_date: Start date in YYYYMMDD format end_date: End date in YYYYMMDD format market: Market type (KOSPI/KOSDAQ/KONEX/ALL) investor: Investor type (금융투자/보험/투신/사모/은행/기관합계/개인/외국인 etc.) Returns: Dictionary with top stocks ranked by net purchases Example: get_market_net_purchases_of_equities("20240101", "20240131", "KOSPI", "외국인")

• get_market_ohlcv_by_date

  Get OHLCV for all stocks on a specific date. Args: date: Date in YYYYMMDD format market: Market type - KOSPI/KOSDAQ/KONEX/ALL Returns: Dictionary with OHLCV data for all stocks Example: get_market_ohlcv_by_date("20240101", "KOSPI")

• get_market_price_change

  Get price change for all stocks over a period. Args: start_date: Start date in YYYYMMDD format end_date: End date in YYYYMMDD format market: Market type - KOSPI/KOSDAQ/KONEX/ALL Returns: Dictionary with price changes for all stocks Example: get_market_price_change("20240101", "20240131", "KOSPI")

• get_market_ticker_list

  Retrieve list of stock tickers for a specific market. Args: date: Date in YYYYMMDD format (e.g., "20240101") market: Market name - "KOSPI", "KOSDAQ", or "KONEX" (default: "KOSPI") Returns: Dictionary with ticker list and count Example: get_market_ticker_list("20240101", "KOSPI") Returns list of all KOSPI stocks on 2024-01-01

• get_market_ticker_name

  Get the name of a stock from its ticker code. Args: ticker: 6-digit stock ticker code (e.g., "005930") Returns: Dictionary with ticker and company name Example: get_market_ticker_name("005930") Returns {"ticker": "005930", "name": "삼성전자"}

Signals

Stars

3

Forks

5

Open issues

0

Weekly downloads

76

Last commit

Feb 1, 2026 (9 months ago)

Last release

Jan 31, 2026 (9 months ago)

Last package publish

Jan 31, 2026 (9 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.sharebook-kr/pykrx-mcp

Version

0.1.3

Auth

No auth

Packages

pypi pykrx-mcp

License

MIT

Repository

github.com/sharebook-kr/pykrx-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql