kospi-kosdaq-stock-server

What is kospi-kosdaq-stock-server?

An MCP server that provides KOSPI/KOSDAQ stock data from the KRX Data Marketplace. It retrieves OHLCV, market capitalization, fundamental data (PER/PBR/Dividend Yield), trading volume by investor type, and index data. Designed for users who need Korean stock market data via AI assistants like Claude Desktop.

How to use kospi-kosdaq-stock-server?

Install via Smithery (npx -y @smithery/cli install @dragon1086/kospi-kosdaq-stock-server --client claude) or manually (uv pip install kospi-kosdaq-stock-server and playwright install chromium). Set environment variables KAKAO_ID and KAKAO_PW (Kakao account with 2FA disabled). Add a server configuration to Claude Desktop’s claude_desktop_config.json. Tools include load_all_tickers, get_stock_ohlcv, get_stock_market_cap, get_stock_fundamental, get_stock_trading_volume, and get_index_ohlcv.

Key features of kospi-kosdaq-stock-server

• Lookup KOSPI/KOSDAQ ticker symbols and names
• Retrieve OHLCV data for individual stocks
• Market capitalization and fundamental data (PER/PBR/Dividend Yield)
• Trading volume breakdown by investor type
• Index OHLCV for KOSPI, KOSDAQ, and sub-indices
• Kakao OAuth authentication via headless browser (Playwright)
• Automatic session management with 4-hour timeout and auto re-login

Use cases of kospi-kosdaq-stock-server

• Load all Korean stock tickers for reference
• Get historical price and volume data for a specific stock (e.g., Samsung Electronics)
• Fetch market cap and fundamental metrics for investment analysis
• Retrieve index trends for KOSPI or KOSDAQ

FAQ from kospi-kosdaq-stock-server

What are the runtime requirements?

Python 3.10+, a Kakao account with 2FA disabled, and the Playwright Chromium browser installed.

How do I handle the “KakaoTalk login notification” on first run?

Run the server with headless=False to see the browser, approve the login request in KakaoTalk, and the session cookies will be saved for future use.

What if the session expires or I get a 401 error?

The server automatically renews the session (~4‑hour expiry). If auto‑renewal fails, delete ~/.krx_session.json and restart the server.

Does the server support Naver login?

Naver login is not yet implemented; only Kakao OAuth is supported.

Where does the stock data come from?

All data is fetched directly from the KRX Data Marketplace (data.krx.co.kr). No local storage of stock data is used.