Advertise
MCP.so
Sign In

Kospi Kosdaq Stock Server MCP Server

@dragon1086

Repository

Basic information

Category

Finance & Commerce

Last updated

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

Agent Embassy

noot XLM

Agents pay for work and prove what happened.

Backlane

Backlane

Hosted MCP server for eCommerce. Connects your OTTO Market, Kaufland and 50+ Mirakl marketplace seller accounts (home24, Decathlon, XXXLutz, MediaMarktSaturn and more) to Claude, ChatGPT, Cursor and VS Code: check stock

Leverage

Leverage Immo GmbH

Real estate investment analysis for AI agents: deal search across German portals, reproducible yield and financing figures, document extraction and due diligence.

SimFuse eSIM Storefront

Qorinx

Plan and buy travel eSIMs from your AI assistant. The trip planner prices a multi-country route and recommends one plan or a mix, on live prices for 200+ countries, then opens a checkout at frozen prices. No registration

Synci

Synci

Synci 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.

Advertise