ko-stock-mcp

An MCP server that exposes Korean DART (전자공시시스템, Financial Supervisory Service electronic disclosure) data to MCP clients such as Claude Desktop.

한국어 문서는 README.ko.md를 참고하세요.

Tools

Both DART (electronic disclosure) and KRX (Korea Exchange) tools are provided.

DART (disclosure)

KRX (Korea Exchange) — requires KRX_API_KEY

Typical flow — disclosures/financials: get_corp_code → (get_disclosure_list | get_financial_statement | get_company_info) → get_disclosure for full text. Market data: (optionally get_market_type →) get_stock_trade_info | get_stock_base_info (bas_dd must be a business day; non-trading days return empty).

KRX tools return a friendly error when KRX_API_KEY is unset; DART features are unaffected. Note get_market_type works with just the DART key (via corp class).

KRX response fields

get_stock_trade_info / get_stock_base_info return the raw KRX fields verbatim under result (amounts/quantities are strings, dates are YYYYMMDD).

get_stock_trade_info (daily trading data)

get_stock_base_info (stock base info)

get_market_type returns { "market": "KOSPI"|"KOSDAQ"|"KONEX", "source": "dart"|"krx"|"cache" } (source is where the classification came from).

Related MCP server: dart-mcp

Requirements

• Python >= 3.10

• uv

• A DART Open API key — sign up at https://opendart.fss.or.kr (free, instant).

• (Optional) A KRX Open API key — sign up at https://openapi.krx.co.kr, request a key, then apply for the six stock services (3 daily-trade + 3 base-info); approval takes ~1 day. Only needed for the KRX market-data tools.

Setup

uv sync
cp .env.example .env   # then put your DART_API_KEY in .env

Run / develop

# Launch the MCP Inspector for local testing
uv run mcp dev src/ko_stock_mcp/server.py

# Or run the server directly (stdio)
uv run ko-stock-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "ko-stock-mcp": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/ko-stock-mcp", "run", "python", "-m", "ko_stock_mcp.server"]
    }
  }
}

uv --directory runs the server with this project as the working directory, so .env (with DART_API_KEY, and optionally KRX_API_KEY) is loaded automatically — no need to duplicate the keys here. If you prefer, you can instead pass them explicitly:

"env": { "DART_API_KEY": "<YOUR_DART_API_KEY>", "KRX_API_KEY": "<YOUR_KRX_API_KEY>" }

On macOS the config lives at ~/Library/Application Support/Claude/claude_desktop_config.json. Restart Claude Desktop after editing.

License

MIT — see LICENSE.