kospi-kosdaq-stock-server

Name: kospi-kosdaq-stock-server
Author: dragon1086

@dragon1086

Repository

About kospi-kosdaq-stock-server

An MCP server that provides KOSPI/KOSDAQ stock data using FastMCP

#finance

Basic information

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

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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.

Comments

More Finance & Commerce MCP servers

₿itcoin & Lightning Network MCP Server

AbdelStark

Bitcoin & Lightning Network MCP Server.

Financial Modeling Prep MCP (Model Context Protocol)

imbenrabi

A Model Context Protocol (MCP) implementation for Financial Modeling Prep, enabling AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights.

139