Log inSubmit server
Korea Stock MCP logo

Korea Stock MCP

by jjlabsio

Analyzes Korean stock prices, disclosures, company data, and financial statements through DART and KRX APIs.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Korea Stock MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "jjlabsio-korea-stock-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "korea-stock-mcp@latest"
      ],
      "env": {
        "DART_API_KEY": "YOUR_VALUE_HERE",
        "KRX_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y korea-stock-mcp@latest

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

The jjlabsio/korea-stock-mcp MCP server gives AI agents access to Korean corporate disclosures, financial statements, and KRX stock data. It combines official OPEN DART and Korea Exchange APIs through tools for company lookup, disclosure retrieval, market classification, and daily trading information. Reach for it when an agent needs source data for Korean listed-company or market analysis rather than general financial information. DART and KRX API keys are required, and Claude Desktop is supported through an npx configuration.

Use cases

  • Search Korean company disclosures by date and type
  • Compare financial-statement figures across reporting periods
  • Retrieve daily KOSPI, KOSDAQ, or KONEX trading data
  • Inspect selected sections of large disclosure reports

Key features

  • OPEN DART disclosure and financial-statement access
  • KRX stock and daily trading data
  • Corporate code and market-type lookup
  • Large-document table-of-contents handling
  • Claude Desktop configuration

Tools8

What Korea Stock MCP lets your agent do. Expand a tool for its parameters.

Self-reported~77 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

6/6 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · korea-stock-mcp@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars183Stargazers on the source repository.
npm downloads637Package downloads in the last 30 days.
Last commit2d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed8Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Korea Stock MCP works

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.

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.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Korea Stock MCP

Run it through npx with `npx -y korea-stock-mcp@latest`, then configure `DART_API_KEY` and `KRX_API_KEY` in the MCP client.

Yes. The README provides a Claude Desktop configuration using the `korea-stock-mcp@latest` package and the two required API key environment variables.

It requires an OPEN DART API key and a KRX API key. KRX users must also apply for the relevant stock-data services.

Yes. Reports under 1 MB are returned in full; larger reports return a table of contents first, after which a specific section can be requested with `section_id`.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewKorea Stock MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/jjlabsio-korea-stock-mcp?style=directory)](https://allmcps.com/mcp/jjlabsio-korea-stock-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/jjlabsio-korea-stock-mcp"><img src="https://allmcps.com/api/badge/jjlabsio-korea-stock-mcp?style=directory" alt="Korea Stock MCP on AllMCPs" /></a>