How to add Korea Stock MCP Server to Claude Desktop

Analyze Korean stocks via official DART disclosures and KRX (KOSPI/KOSDAQ/KONEX) market data. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 146★ · stdio · apikey

Claude Desktop config for Korea Stock MCP Server

npx -y korea-stock-mcp@latest

{
  "mcpServers": {
    "korea-stock-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "korea-stock-mcp@latest"
      ],
      "env": {
        "DART_API_KEY": "<YOUR_DART_API_KEY>",
        "KRX_API_KEY": "<YOUR_KRX_API_KEY>"
      }
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Korea Stock MCP Server config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Korea Stock MCP Server's tools appear under the 🔌 tools menu.

Before you start

Node.js 18 or higher
DART API key from OPEN DART (opendart.fss.or.kr)
KRX API key from the KRX OPEN API portal (6 stock data services enabled; approval takes ~1 day)
An MCP client such as Claude Desktop

What Korea Stock MCP Server can do in Claude Desktop

get_disclosure_list

Search disclosure reports by type, company, and date.

get_corp_code

Look up a DART-registered company's unique code, company name, and stock code; search by company name (corp_name) or stock code (stock_code).

get_disclosure

Parse the original disclosure report file via the DART API; for large documents it returns a TOC and a specific section can be fetched with section_id.

get_financial_statement

Retrieve XBRL financial statements for listed and major unlisted companies, including all account data from periodic reports.

get_stock_base_info

Get basic information (stock name, code, market classification) for KOSPI, KOSDAQ, and KONEX listed stocks.

get_stock_trade_info

Get daily trading data (price, volume, market capitalization) for KOSPI, KOSDAQ, and KONEX stocks.

get_market_type

Query the market classification (KOSPI/KOSDAQ/KONEX) for a given stock code.

get_today_date

Return the current date in YYYYMMDD format for accurate date handling by the AI.

Security

Requires two API keys (DART_API_KEY and KRX_API_KEY) passed as environment variables. Obtain a DART key from OPEN DART (opendart.fss.or.kr) and a KRX key from the KRX OPEN API portal (KRX approval takes ~1 day, and you must enable 6 stock data services).

Korea Stock MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Korea Stock MCP Server config there under the "mcpServers" key and restart the client.

Is Korea Stock MCP Server safe to use with Claude Desktop?

Which API keys do I need?

Two keys: a DART_API_KEY from OPEN DART (opendart.fss.or.kr) and a KRX_API_KEY from the KRX OPEN API portal. For KRX you must enable 6 stock data services, and approval takes about 1 day.

How does it handle very large disclosure reports?

Automatically. Documents under 1MB are returned in full; documents 1MB or larger return a Table of Contents first, and the AI selects and fetches only the relevant sections (using section_id). No manual action is required.

Which markets are covered?

KOSPI, KOSDAQ, and KONEX via the KRX API, plus disclosure and financial data for listed and major unlisted companies via DART.

View repo Full Korea Stock MCP Server page