Skip to content
MCP server

Korea Stock MCP

MCP server giving AI assistants access to Korean stock prices and DART disclosures

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally
Version
1.1.4
Listing updated
today

Similar MCP servers

About Korea Stock MCP

Korea Stock MCP is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

The README says this server connects AI clients to official Korean market data, pulling daily KOSPI, KOSDAQ and KONEX trading figures from the Korea Exchange and corporate filings from the DART electronic disclosure system. Once configured, an assistant can look up company codes, search filings by company and date, and read parsed disclosure text or XBRL financial statement line items.

Large annual and quarterly reports are handled by returning a table of contents first when a document exceeds about 1 MB, so the assistant can request only the sections relevant to a question. The project also includes example analyses covering sales, operating profit and market capitalization trends for specific listed companies.

The server is aimed at developers and investors who want an assistant to research Korean listed companies. It requires separate DART and KRX API keys, and the README states that its output is informational and not investment advice.

Install

Run in a terminal

claude mcp add korea-stock-mcp --env DART_API_KEY='<DART_API_KEY>' --env KRX_API_KEY='<KRX_API_KEY>' -- npx -y korea-stock-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "korea-stock-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "korea-stock-mcp"
      ],
      "env": {
        "DART_API_KEY": "<DART_API_KEY>",
        "KRX_API_KEY": "<KRX_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • DART_API_KEYDART API key for the serviceRequired
  • KRX_API_KEYKRX API key for the serviceRequired

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

get_disclosure_list
Search disclosure reports by type, company and date.
get_corp_code
Look up DART corporate codes, company names and stock codes.
get_disclosure
Fetch parsed original disclosure report content, with section access for large documents.
get_financial_statement
Retrieve XBRL financial statement account data from periodic reports.
get_stock_base_info
Basic information for KOSPI, KOSDAQ and KONEX listed stocks.
get_stock_trade_info
Daily trading data including prices, volume and market capitalization.
get_market_type
Return the market classification of a stock code.
get_today_date
Return the current date in YYYYMMDD format.

What it does

Disclosure search
Finds DART filings by company, disclosure type and date range.
Parsed filing content
Returns the text of original disclosure reports, with a table of contents for large documents.
XBRL financial statements
Provides account-level data from periodic reports for listed and major unlisted companies.
Daily trading data
Supplies daily prices, volume and market capitalization for KOSPI, KOSDAQ and KONEX stocks.
Corporate code lookup
Maps company names or stock codes to DART corporate codes.
Section-level fetching
Retrieves a specific section of a large filing by its section identifier.

Good for

  • Pulling quarterly sales and operating profit for a Korean listed company
  • Finding the foreign investor allocation in an IPO securities registration filing
  • Checking daily trading volume and market cap trends for a KOSDAQ stock
  • Summarising a company's business segments from its annual report

Pricing

Open source

Free open-source server under the ISC license; requires free DART and KRX API keys.

Korea Stock MCP FAQ

What API keys are required?

Both a DART API key and a KRX API key are required. The README explains how to apply for each, and notes that KRX approval can take about one day.

How are large filings handled?

Documents of 1 MB or more are returned as a table of contents first, and the assistant then fetches the sections it needs.

What Node version is needed for local development?

The README says Node.js 18 or higher is required.

Is Korea Stock MCP free?

Yes. Korea Stock MCP is open source, so you can use and self-host it for free.

How do I add Korea Stock MCP to Claude Code?

Run this command in your terminal: claude mcp add korea-stock-mcp --env DART_API_KEY='<DART_API_KEY>' --env KRX_API_KEY='<KRX_API_KEY>' -- npx -y korea-stock-mcp

What are the best alternatives to Korea Stock MCP?

The closest alternatives to Korea Stock MCP are FinBridge, stocks-llm, Hedgenaru Korean Stocks, MCP Stock Analyst and 0si.ai Disclosures.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers