kospi-kosdaq-stock-server
@dragon1086
About kospi-kosdaq-stock-server
An MCP server that provides KOSPI/KOSDAQ stock data using FastMCP
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"kospi-kosdaq-stock-server": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@dragon1086/kospi-kosdaq-stock-server",
"--client",
"claude"
]
}
}
}Tools
No tools detected
Fetch the live tool list by running this server in a temporary sandbox using the button above.
Overview
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.
Frequently asked questions
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.
Basic information
More Finance & Commerce MCP servers
ApexVol Options Analytics
ryansilkMCP server for ApexVol options analytics — options chains, IV rank, VRP, Greeks, GEX, expected moves, and screeners for Claude and any MCP client. Remote connector or pipx install; works with any paid ApexVol plan.
SavePropTax
atifnayeem-ossCheck whether a California home qualifies for a Proposition 8 property tax reduction from recent comparable sales, then start a filing the owner completes themselves. Hosted remote server, no API key. Flat $29, paid by t
Synci
SynciSynci connects your real bank, brokerage, and crypto-exchange accounts to AI assistants, read-only. Ask about balances, transactions, holdings, and spending across all your accounts in one place.
Cello MCP
CelloConnect Cello MCP to build and scale your referral, partner, or affiliate programs without leaving the conversation. For growth and marketing teams: Ask which referrers drive the most revenue, identify who to re-engage
Andrii Co. - Washington State Notary & Apostille Assistant
Andrii TereshchenkoAndrii Co. - Washington State Notary & Apostille Assistant is a remote MCP server available at https://andrii.net.
Comments