Log inSubmit server
Korean Dart MCP logo

Korean Dart MCP

Queries Korean OpenDART disclosures through 15 MCP tools for filings, financials, ownership, XBRL, and document extraction.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Korean Dart 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": {
    "korean-dart-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "korean-dart-mcp"
      ]
    }
  }
}

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

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 korean-dart-mcp

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 6d ago.

Overview

korean-dart-mcp connects AI assistants to Korea’s Financial Supervisory Service OpenDART disclosure data through 15 MCP tools. It covers corporate filings, financial statements, ownership changes, XBRL data, insider activity, disclosure risk signals, and Markdown conversion for DART XML and attached HWP/PDF documents. Reach for it when researching Korean listed companies from primary disclosure sources rather than charts or real-time market data.

Use cases

  • Search recent Korean corporate disclosures by event type
  • Compare companies using multi-year quality metrics
  • Review insider buying and selling clusters
  • Extract filing attachments for section-level analysis
  • Inspect XBRL accounts and calculation relationships

Key features

  • 15 MCP tools backed by 83 OpenDART APIs
  • Preset searches for common disclosure events
  • Insider activity and disclosure anomaly analysis
  • XBRL Markdown output with calculation checks
  • HWP, PDF, DOCX, XLSX, and XML extraction
  • Capital-event and ownership timelines

Security & health

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

ActiveLast checked Today

Recent health check succeeded.

4/4 checks healthy over the last 7d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · korean-dart-mcp (npm)

Adoption & maintenance

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

GitHub stars119Stargazers on the source repository.
npm downloads2.8kPackage downloads in the last 30 days.
Last commit7d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.

How Korean Dart MCP works

What korean-dart-mcp does

korean-dart-mcp exposes Korean OpenDART electronic disclosure data to MCP-compatible AI clients. The package consolidates 83 OpenDART API endpoints into 15 tools covering filings, company financials, ownership reports, capital events, XBRL statements, and document attachments.

Its analysis-oriented tools add structured views on top of raw disclosures. insider_signal groups reported insider buying and selling into cluster signals, while disclosure_anomaly scores selected accounting and governance indicators and returns supporting evidence. buffett_quality_snapshot compares multi-year quality measures such as ROE, debt-to-equity, revenue growth, and earnings growth against a checklist.

DART XML filings can be rendered with headings and tables, while attached HWP, HWPX, PDF, DOCX, and XLSX files can be extracted for searching and summarization.

How it works

The server uses the OpenDART API as its disclosure source and runs as an MCP server for clients such as Claude Desktop, Cursor, Windsurf, Claude Code, VS Code, Gemini CLI, and Zed. A setup command interactively collects an OpenDART authentication key, detects supported installed clients, and updates their configuration.

Disclosure search includes preset queries for common event types, including treasury-share transactions, annual reports, capital increases, convertible bonds, mergers, and splits. Searches spanning more than 90 days without a company code are divided into shorter requests to work around the whole-market query limit. get_corporate_event can combine multiple event types into a timeline, and get_major_holdings combines major-shareholder and executive-shareholding data.

XBRL extraction can return a fuller Markdown representation of balance-sheet, income-statement, and cash-flow accounts. It parses presentation and calculation relationships and can check whether parent values reconcile with their component accounts, including industry-specific taxonomy prefixes such as the DX namespace used by financial groups.

Setup and configuration

Node.js 20.19 or newer is required. The quickest installation path is:

Terminal
npx -y korean-dart-mcp setup

The wizard asks for an OpenDART authentication key. The key can be skipped during setup and configured later. OpenDART provides the key through its service registration process.

The wizard then offers client selections for Claude Desktop, Cursor, Claude Code, Windsurf, VS Code, Gemini CLI, and Zed. It patches the selected configuration files and instructs the user to restart the client. On Windows, the generated configuration wraps npx with cmd /c to avoid command discovery problems.

Tools and capabilities

Named capabilities include:

  • search_disclosures for date-bounded filing searches and preset event filters.
  • download_document for converting DART XML documents to Markdown.
  • get_attachments for listing or extracting filing attachments.
  • get_xbrl for structured XBRL accounts, taxonomy relationships, and calculation checks.
  • get_corporate_event for capital-event timelines.
  • get_major_holdings for 5% ownership and executive or major-shareholder reports.
  • insider_signal for aggregated insider buying and selling activity.
  • disclosure_anomaly for disclosure-based risk scoring and evidence.
  • buffett_quality_snapshot for multi-year quality metrics and checklist comparisons.

Limitations and notes

The package is intended for research assistance, not automated investment decisions. It focuses on Korean OpenDART disclosures and does not provide charting or real-time stock prices. Interpreting outputs requires familiarity with measures such as ROE, CAGR, and debt ratios. Large attachment extractions can produce substantial Markdown and may benefit from an AI client with a larger context window. An OpenDART authentication key is needed for normal data access.

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 Korean Dart MCP

korean-dart-mcp is an MCP server that connects AI assistants to Korea’s Financial Supervisory Service OpenDART disclosure system. Its main tools search filings, inspect financials and XBRL, review ownership and insider activity, analyze disclosure anomalies, compare company quality metrics, and convert DART documents or attachments to Markdown.

Run `npx -y korean-dart-mcp setup` with Node.js 20.19 or newer. The interactive wizard requests an OpenDART authentication key, detects supported clients, and patches their MCP configuration. Restart the selected client after setup completes.

korean-dart-mcp supports Claude Desktop, Cursor, Windsurf, Claude Code, VS Code, Gemini CLI, and Zed. Its setup wizard can detect these clients and configure the selected installation automatically.

Yes. Use `get_attachments` in extraction mode to convert supported filing attachments into Markdown. The documented formats include PDF, HWP, HWPX, DOCX, and XLSX, allowing an AI client to search and summarize sections from the source document.

No. korean-dart-mcp focuses on OpenDART filings, financial data, ownership, XBRL, and document extraction rather than charting or real-time stock prices. Use it for disclosure-based company research and treat its analysis as research assistance.

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 PreviewKorean Dart MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/korean-dart-mcp?style=directory)](https://allmcps.com/mcp/korean-dart-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/korean-dart-mcp"><img src="https://allmcps.com/api/badge/korean-dart-mcp?style=directory" alt="Korean Dart MCP on AllMCPs" /></a>