home / mcp / kospi kosdaq mcp server

Kospi Kosdaq MCP Server

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

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "dragon1086-kospi-kosdaq-stock-server": {
      "command": "uvx",
      "args": [
        "kospi_kosdaq_stock_server"
      ],
      "env": {
        "KAKAO_ID": "your_kakao_id",
        "KAKAO_PW": "your_kakao_password"
      }
    }
  }
}

This MCP server delivers KOSPI and KOSDAQ stock data through FastMCP, enabling you to load ticker information and fetch OHLCV, market cap, fundamentals, and investor-volume data for specific stocks. It’s designed to help you build data-driven analyses or integrate stock data into your applications with an MCP client.

How to use

You interact with this server using an MCP client. First you load all available tickers, then you request data for the ticker you care about. The server exposes endpoints to fetch OHLCV data, market capitalization, fundamentals (PER/PBR/Dividend Yield), and trading volume by investor type for any given stock.

Typical usage patterns include: loading the full ticker list, requesting a date range for OHLCV data, and requesting fundamental indicators for a specific stock. Use the ticker symbol you already know (for example, a KOSPI/KOSDAQ ticker) and specify the date range in the format YYYYMMDD for precise data retrieval.

How to install

Prerequisites: you need uv to run the server and Python packaging tooling for installation.

Install via the package manager that your environment supports, then prepare to run the MCP server.

# Create and activate a virtual environment
uv venv .venv
source .venv/bin/activate  # On Unix/macOS
# .venv\Scripts\activate   # On Windows

# Install the package
uv pip install kospi-kosdaq-stock-server

Additional notes

Configuration for Claude.app is required to connect this MCP server. The standard approach is to configure Claude’s MCP client to start the server as a local process using uvx, with the server entry point defined by the package.

Available tools

load_all_tickers

Loads all ticker symbols and names for KOSPI and KOSDAQ.

get_stock_ohlcv

Retrieves OHLCV (Open/High/Low/Close/Volume) data for a specific stock within a date range.

get_stock_market_cap

Retrieves market capitalization data for a specific stock within a date range.

get_stock_fundamental

Retrieves fundamental data (PER/PBR/Dividend Yield) for a specific stock within a date range.

get_stock_trading_volume

Retrieves trading volume by investor type for a specific stock within a date range.

get_index_ohlcv

Retrieves OHLCV data for market indices within a date range.