# jjlabsio-korea-stock-mcp

Search Korean company disclosures, financial statements, and KRX stock data through DART and KRX APIs. Useful for company and market analysis.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 183
- Author: jjlabsio
- License: ISC · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jjlabsio/korea-stock-mcp
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/jjlabsio-korea-stock-mcp

## What it does

This MCP server connects an AI coding client to official DART and KRX APIs. It searches disclosures by company and date, parses report data, exposes XBRL financial statements, and returns stock profiles for KOSPI, KOSDAQ, and KONEX. Daily trading data includes price, volume, and market capitalization.

The server handles large disclosure files in stages. Files below 1MB are returned in full; larger files first produce a table of contents, then Claude can retrieve a relevant section with `section_id`. Available tools include `get_disclosure_list`, `get_corp_code`, `get_disclosure`, `get_financial_statement`, `get_stock_base_info`, `get_stock_trade_info`, `get_market_type`, and `get_today_date`.

You need API keys from both DART and KRX to retrieve the data. Local development uses Node.js 18 or newer, so that requirement matters if you plan to run the project from source.

## Requirements
- Remote server: `https://server.smithery.ai/@jjlabsio/korea-stock-mcp/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http jjlabsio-korea-stock-mcp https://server.smithery.ai/@jjlabsio/korea-stock-mcp/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add jjlabsio-korea-stock-mcp --url https://server.smithery.ai/@jjlabsio/korea-stock-mcp/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "jjlabsio-korea-stock-mcp": {
            "url": "https://server.smithery.ai/@jjlabsio/korea-stock-mcp/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "jjlabsio-korea-stock-mcp": {
            "type": "http",
            "url": "https://server.smithery.ai/@jjlabsio/korea-stock-mcp/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http jjlabsio-korea-stock-mcp https://server.smithery.ai/@jjlabsio/korea-stock-mcp/mcp
```

## When to use it
- search company disclosures by date
- retrieve parsed report content
- inspect XBRL financial statements
- compare stock price and trading volume
- identify a market from a stock code

## Example prompts
- Search the company’s disclosures for the requested date range and list the reports.
- Retrieve the company’s financial statements and compare revenue with operating profit.
- Identify the market for this stock code, then show its daily trading data.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md