# jjlabsio/korea-stock-mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/jjlabsio/korea-stock-mcp  
**GitHub Stars:** 175  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/jjlabsio-korea-stock-mcp

## Description
An MCP Server for Korean stock analysis using OPEN DART API and KRX API

## Tools
Capabilities this server exposes over MCP:

- **get_disclosure_list** — Disclosure Search
- **get_corp_code** — Corporate Code Inquiry
- **get_disclosure** — Disclosure Report Content
- **get_financial_statement** — Financial Statements
- **get_stock_base_info** — Basic Stock Information
- **get_stock_trade_info** — Daily Trading Information
- **get_market_type** — Market Type Inquiry
- **get_today_date** — Today's Date Inquiry

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "korea-stock-mcp": {
    "command": "npx",
    "args": ["-y","korea-stock-mcp@latest"],
    "env": {
      "DART_API_KEY": "",
      "KRX_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `DART_API_KEY`, `KRX_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What jjlabsio/korea-stock-mcp MCP server does

The jjlabsio/korea-stock-mcp MCP server exposes Korean company and stock-market data through the Model Context Protocol. It connects to two official sources: OPEN DART, the electronic disclosure system, and KRX, the Korea Exchange API. This makes it suitable for workflows that combine corporate filings with market data.

DART-backed capabilities include searching disclosures by company, disclosure type, and date; finding a company’s DART corporate code; retrieving parsed disclosure-report content; and reading XBRL financial-statement data. The financial-statement tool covers account data in periodic reports for listed companies and major unlisted companies.

KRX-backed capabilities cover basic listing information and daily trading information for KOSPI, KOSDAQ, and KONEX securities. Results can include stock identifiers, market classification, prices, trading volume, and market capitalization. A separate market-type lookup can identify whether a stock belongs to KOSPI, KOSDAQ, or KONEX. The server also provides the current date in YYYYMMDD format.

## How it works

The agent calls MCP tools instead of handling the DART or KRX request formats directly. A typical company research flow can start by resolving a company name or stock code with `get_corp_code`, then searching relevant filings with `get_disclosure_list`, and finally requesting a report with `get_disclosure`.

Large disclosure reports receive special handling. Documents smaller than 1 MB are returned in full. For documents at or above that size, the tool first returns a table of contents. The agent can then request a relevant section using `section_id`, reducing the amount of report content returned in one response. Breaking complex questions into company lookup, disclosure search, report retrieval, and targeted section requests is supported by this workflow.

## Setup and configuration

Using the jjlabsio/korea-stock-mcp MCP server requires one API key from OPEN DART and one from KRX. KRX access also requires applying for the applicable stock services; the README lists six daily-trading and basic-information services across KOSPI, KOSDAQ, and KONEX, with approval reported as taking approximately one day.

For Claude Desktop, configure the server with the `korea-stock-mcp@latest` npm package and provide these environment variables:

- `DART_API_KEY`: the OPEN DART authentication key.
- `KRX_API_KEY`: the KRX API authentication key.

The repository also documents local development with Node.js 18 or later. Install dependencies with `npm install`, create a root `.env` file containing both keys, and use `npm run inspect` to test the source through MCP Inspector.

## Tools and capabilities

- `get_disclosure_list`: searches company disclosures by type, company, and date.
- `get_corp_code`: finds a DART corporate code, company name, or stock code.
- `get_disclosure`: retrieves and parses an original disclosure report, or a selected large-document section.
- `get_financial_statement`: returns XBRL financial-statement account data.
- `get_stock_base_info`: returns KOSPI, KOSDAQ, and KONEX listing information.
- `get_stock_trade_info`: returns daily trading data for supported markets.
- `get_market_type`: identifies a stock’s market category.
- `get_today_date`: returns the current date in `YYYYMMDD` format.

## Limitations and notes

The jjlabsio/korea-stock-mcp MCP server depends on external DART and KRX API access, so users must obtain and configure both credentials. KRX service approval is required for the listed stock-data endpoints. Large reports are not always returned as complete documents; section-level retrieval may be needed after the table of contents is returned. The project describes its output as information for analysis, not investment advice, and places investment decisions with the user.

_Full upstream README: https://allmcps.com/mcp/jjlabsio-korea-stock-mcp/readme_