MCP Directory

How to add Korea Stock MCP Server to Windsurf

Analyze Korean stocks via official DART disclosures and KRX (KOSPI/KOSDAQ/KONEX) market data. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

Windsurf 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

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Korea Stock MCP Server config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Korea Stock MCP Server's tools become available to Cascade.

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 Windsurf

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 + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_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 Windsurf?

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

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