# Korea Stock MCP

> Korea Stock MCP is an open-source MCP server for finance and payments. MCP server giving AI assistants access to Korean stock prices and DART disclosures. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/jjlabsio/korea-stock-mcp
- **MCP Registry name:** io.github.jjlabsio/korea-stock-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

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

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

## Alternatives

- [FinBridge](https://ai-powered.com/mcp/finbridge): FinBridge is a freemium MCP server for finance and payments.
- [stocks-llm](https://ai-powered.com/mcp/stocks-llm): stocks-llm is a free MCP server for finance and payments.
- [Hedgenaru Korean Stocks](https://ai-powered.com/mcp/hedgenaru-korean-stocks): Hedgenaru Korean Stocks is a freemium MCP server for finance and payments.
- [MCP Stock Analyst](https://ai-powered.com/mcp/mcp-stock-analyst): MCP Stock Analyst is a freemium MCP server for finance and payments.
- [0si.ai Disclosures](https://ai-powered.com/mcp/0si-ai-disclosures): 0si.ai Disclosures is a freemium MCP server for finance and payments.
- [Bamsai](https://ai-powered.com/mcp/bamsai): Bamsai is an open-source MCP server for finance and payments.
- [Wudao A-Share Stock Data MCP](https://ai-powered.com/mcp/wudao-a-share-stock-data-mcp): Wudao A-Share Stock Data MCP is a freemium MCP server for finance and payments.
- [ComePass — Korean Companies & Public Procurement](https://ai-powered.com/mcp/comepass-korean-companies-and-public-procurement): ComePass — Korean Companies & Public Procurement is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/korea-stock-mcp
