Advertise
MCP.so
Sign In

Kospi Kosdaq Stock Server MCP Server

@dragon1086

Repository

Basic information

Category

Finance & Commerce

License

MIT

Transports

stdio

Author

dragon1086

About Kospi Kosdaq Stock Server MCP Server

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

#finance

Kospi Kosdaq Stock Server MCP Server 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"
      ]
    }
  }
}

Kospi Kosdaq Stock Server MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

What are the runtime requirements?

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

2

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.

3

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.

4

Does the server support Naver login?

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

5

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

P

Pitch Protocol

Pitch Protocol

Founder-side MCP server for Pitch Protocol, agent-native venture capital. A founder's agent submits one application (about ten minutes, no web form, deck optional) and it is reviewed and matched against the theses of 15+

Exact Online

iWebDevelopment

Exact AI Connect is a remote MCP server that connects AI assistants like Claude, ChatGPT, Copilot, Gemini and Perplexity directly to your Exact Online administration. Ask questions about your finances in plain language a

NexusTrade Financial MCP

Austin Starks

Connect AI assistants and agents to NexusTrade for quantitative research, backtesting, managed compute, creator discovery, strategy subscriptions, editable portfolio forks, continuous paper or live copy trading, and cont

SkyAccess

SkyAccess Inc.

Search live private jet empty legs, get charter estimates and booking links. Free, no API key.

x402-list-mcp

mcccsm

MCP server for x402-list.com: discover x402 payment services and on-chain-verified facilitator settlement volumes. Published on npm as x402-list-mcp.

26
Advertise