korea-stock-insight-mcp 0.1.0

MCP server for Korean stock market analysis (DART disclosures + KRX prices). English-first, drop-in for Claude Desktop / Cursor.

Korea Stock Insight MCP

MCP server for Korean stock market analysis. Drop-in for Claude Desktop, Cursor, Cline, and any MCP-compatible client. English-first tool descriptions for global LLM analysts researching Korean equities.

What you get

Tool	What it does
get_today_date	Today in KST/UTC (YYYYMMDD) — call before any date-range query
get_corp_code	Resolve Korean company name or 6-digit ticker → DART corp_code
get_disclosure_list	Recent DART filings (date, title, type, receipt no.)
get_disclosure	Filing metadata + canonical viewer URL
get_financial_statement	Full XBRL financial statements (consolidated/separate, quarterly/annual)
get_stock_quote	Daily OHLCV from KOSPI/KOSDAQ (via yfinance, no key required)

DART (전자공시시스템) is South Korea's electronic disclosure system — the SEC EDGAR equivalent, operated by the Financial Supervisory Service (FSS).

Quick start (Claude Desktop)

1. Get a free DART API key

Register at opendart.fss.or.kr and grab your API key from the user page. It's free, instant, and unlimited for retail use.

2. Add to your Claude Desktop config

Edit claude_desktop_config.json (location: macOS ~/Library/Application Support/Claude/, Windows %APPDATA%\Claude\):

{
  "mcpServers": {
    "korea-stock-insight": {
      "command": "uvx",
      "args": ["korea-stock-insight-mcp"],
      "env": {
        "DART_API_KEY": "YOUR_DART_KEY_HERE"
      }
    }
  }
}

Or with pipx / direct pip:

{
  "mcpServers": {
    "korea-stock-insight": {
      "command": "korea-stock-insight-mcp",
      "env": {"DART_API_KEY": "YOUR_DART_KEY_HERE"}
    }
  }
}

3. Restart Claude Desktop and try

"What were Samsung Electronics' most recent disclosures? Pull their last quarter's revenue and operating profit."

Claude will chain get_corp_code("Samsung Electronics") → get_disclosure_list("005930") → get_financial_statement(corp_code, 2025, "FY") automatically.

Sample queries

• "Compare the Q1 2025 operating margins of Samsung Electronics, SK Hynix, and LG Energy Solution."
• "Show me all M&A-related disclosures for Naver in the last 60 days."
• "What's KODEX 200's price trend over the past 3 months?"
• "Pull Kakao's most recent annual report and summarize the risk factors section."

Roadmap

v0.2 (in progress) — Full disclosure body extraction (zipped XBRL → plain text)

Pro tier (separate hosted SSE endpoint, $19/mo at mcp.ywhan.com) — Claude-summarized disclosures in English, sentiment scoring, impact scores, real-time webhook push, auto-generated investment theses.

Comparison

	This (free)	This (Pro, $19/mo)	jjlabsio/korea-stock-mcp	dartpoint.ai
Price	Free	$19/mo	Free	B2B quote
Language	English-first	English-first	Korean	Korean
Hosting	stdio (local)	SSE (hosted)	stdio (local)	SSE (hosted)
Raw DART/KRX	✅	✅	✅	✅
English summaries	❌	✅	❌	❌
Sentiment / impact	❌	✅	❌	partial
Real-time webhooks	❌	✅	❌	❌

License

MIT. See LICENSE.

Acknowledgments

• DART OpenAPI by Korea's Financial Supervisory Service
• KRX daily prices via yfinance
• Model Context Protocol by Anthropic