Kospi Kosdaq Stock Server MCP Server

An MCP server that provides KOSPI/KOSDAQ stock data from KRX Data Marketplace.

Local serverstdioPython

What is the Kospi Kosdaq Stock Server MCP server?

An MCP server that provides KOSPI/KOSDAQ stock data from KRX Data Marketplace. The kospi kosdaq stock server mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 9 defined tools rather than through you.

What it actually does

  • Lookup KOSPI/KOSDAQ ticker symbols and names
  • Retrieve OHLCV (Open/High/Low/Close/Volume) data for stocks
  • Retrieve market capitalization data
  • Retrieve fundamental data (PER/PBR/Dividend Yield)
  • Retrieve trading volume by investor type (institutional, foreign, individual)
  • Retrieve index OHLCV data (KOSPI, KOSDAQ indices)

Its toolset

Everything the assistant can do here goes through one of these:

  • Prerequisites — The Prerequisites tool exposed by this server
  • macOS — 1. Open the config file: bash code ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • Windows — 1. Open the config file at %APPDATA%/Claude/claude_desktop_config.json 2. Add the same configuration as above
  • load_all_tickers — Loads all ticker symbols and names for KOSPI and KOSDAQ. - No arguments required - Returns: Dictionary mapping ticker codes to stock names
  • get_stock_ohlcv — Retrieves OHLCV (Open/High/Low/Close/Volume) data for a specific stock. - fromdate (string, required): Start date (YYYYMMDD) - todate (string
  • get_stock_market_cap — Retrieves market capitalization data for a specific stock. - fromdate (string, required): Start date (YYYYMMDD) - todate (string, required): End date
  • get_stock_fundamental — Retrieves fundamental data (PER/PBR/Dividend Yield) for a specific stock. - fromdate (string, required): Start date (YYYYMMDD) - todate (string
  • get_stock_trading_volume — Retrieves trading volume by investor type for a specific stock. - fromdate (string, required): Start date (YYYYMMDD) - todate (string, required): End
  • get_index_ohlcv — Retrieves OHLCV data for market indices. - fromdate (string, required): Start date (YYYYMMDD) - todate (string, required): End date (YYYYMMDD) -

Adding it to your client

Installation goes through your MCP client rather than a global install: point it at @smithery/cli on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

Configuration

You will need 2 environment variables: KAKAO_ID, KAKAO_PW. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • Python 3.10+ - Kakao account (2FA must be disabled) - Playwright Chromium browser

When to reach for it

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Kospi Kosdaq Stock Server's toolset — Prerequisites, macOS, Windows and 6 more — is a fair guide to whether it matches your workflow. It is maintained by dragon1086; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 9 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Kospi Kosdaq Stock Server.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the kospi kosdaq stock server mcp server does with a few real requests.

Available tools

ToolWhat it does
PrerequisitesThe Prerequisites tool exposed by this server.
macOS1. Open the config file: bash code ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows1. Open the config file at %APPDATA%/Claude/claude_desktop_config.json 2. Add the same configuration as above
load_all_tickersLoads all ticker symbols and names for KOSPI and KOSDAQ. - No arguments required - Returns: Dictionary mapping ticker codes to stock names
get_stock_ohlcvRetrieves OHLCV (Open/High/Low/Close/Volume) data for a specific stock. - fromdate (string, required): Start date (YYYYMMDD) - todate (string, required): End date (YYYYMMDD) - ticker (string, required): Stock ticker symb
get_stock_market_capRetrieves market capitalization data for a specific stock. - fromdate (string, required): Start date (YYYYMMDD) - todate (string, required): End date (YYYYMMDD) - ticker (string, required): Stock ticker symbol
get_stock_fundamentalRetrieves fundamental data (PER/PBR/Dividend Yield) for a specific stock. - fromdate (string, required): Start date (YYYYMMDD) - todate (string, required): End date (YYYYMMDD) - ticker (string, required): Stock ticker sy
get_stock_trading_volumeRetrieves trading volume by investor type for a specific stock. - fromdate (string, required): Start date (YYYYMMDD) - todate (string, required): End date (YYYYMMDD) - ticker (string, required): Stock ticker symbol - det
get_index_ohlcvRetrieves OHLCV data for market indices. - fromdate (string, required): Start date (YYYYMMDD) - todate (string, required): End date (YYYYMMDD) - ticker (string, required): Index ticker (e.g., "1001" for KOSPI, "2001" for

How to install the Kospi Kosdaq Stock Server MCP server

2. Add the server configuration:
```json
{
  "mcpServers": {
    "kospi-kosdaq": {
      "command": "uvx",
      "args": ["kospi_kosdaq_stock_server"],
      "env": {
        "KAKAO_ID": "your_kakao_id",
        "KAKAO_PW": "your_kakao_password"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Python 3.10+ - Kakao account (2FA must be disabled) - Playwright Chromium browser
VariableDescriptionRequired
KAKAO_IDConfiguration value read at startup.Optional
KAKAO_PWConfiguration value read at startup.Optional

Example prompts to try

  • Use Kospi Kosdaq Stock Server to Prerequisites.
  • Use Kospi Kosdaq Stock Server to macOS.
  • Use Kospi Kosdaq Stock Server to Windows.

Frequently asked questions

It connects Kospi Kosdaq Stock Server to MCP-compatible AI assistants such as Claude and Cursor, exposing 9 tools (Prerequisites, macOS, Windows, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Kospi Kosdaq Stock Server directly.