MCP Directory

How to add Korea Stock MCP Server to Cursor

Analyze Korean stocks via official DART disclosures and KRX (KOSPI/KOSDAQ/KONEX) market data. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Korea Stock MCP Server config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Korea Stock MCP Server's tools to confirm it's connected.

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 Cursor

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

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.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 Cursor?

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