Korean DART MCP
MCP server for Korean company filings from OpenDART: 83 API methods in 15 tools, XBRL parsing and HWP and PDF attachments
- 121 ★ on the repository
- Last commit
Extended access
Why this level
- The server calls the external OpenDART API with your key and downloads filing files
- Analytical scores follow the author's formulas and do not replace investment advice
Install
- Works in
Manual install
/plugin marketplace add chrisryugj/korean-dart-mcp
/plugin install korean-dartThe OpenDART key is requested once during installation.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The server calls the external OpenDART API with your key and downloads filing files
- Analytical scores follow the author's formulas and do not replace investment advice
This is third-party code. Review the repository files before installing.
What it does
Korean DART MCP connects an agent to OpenDART, the disclosure system of Korea's Financial Supervisory Service. Eighty-three API methods are folded into fifteen tools: a search over filings, financial statements, insider holdings and trades, and corporate events. The server resolves company names from a directory it keeps in SQLite. Three analytical tools sit on top of the raw data. `insider_signal` aggregates executive buying and selling into a signal, `disclosure_anomaly` scores accounting red flags from 0 to 100, and `buffett_quality_snapshot` compares companies on five metrics across several years. `get_xbrl` turns XBRL statements into Markdown tables, and `get_attachments` converts HWP and PDF attachments into text the agent reads section by section. A market-wide search over more than 90 days is split into 90-day chunks automatically. A free OpenDART key is required.
Who it is for. Analysts and private investors who study Korean listed companies from primary sources: reports, insider stakes and filing attachments.
Good fit when
- You want to know whether a company's executives and large holders have been buying its shares over the past year
- From a 300-page annual report in Korean you need only the risk and main business sections
- You need every company that announced a share buyback in the last 30 days
- Three companies are compared on return on equity, debt load and growth over five years
- XBRL statements are needed as a table with account hierarchy and sum checks
Not a fit when
- You need quotes, charts or real-time data: the server has filings only
- You need to call rare OpenDART methods directly: compressing 83 methods into 15 tools leaves some out
- You analyse in pandas dataframes: the author himself points to OpenDartReader and dart-fss for that
Example request
Show whether Samsung Electronics executives and large holders bought shares over the past year, and aggregate it into a signal.MCP
- Transport
- stdio
- Authentication
- API key
Environment variables
DART_API_KEYrequired, secret- Free 40-character OpenDART key.
Limitations
You need a free 40-character OpenDART key with a limit of 20,000 requests a day, and Node.js 20.19 or newer. Filings and reports are in Korean, and translation is left to the agent. The insider, accounting-flag and quality scores follow the author's own formulas; they support research, and the investment decision stays with a person. Rare API methods are unavailable because of the compression into 15 tools. The author also notes that the market for Korean DART servers is small and the ecosystem is at an early stage.
How to disable. Remove the korean-dart plugin through /plugin or delete the server entry from the MCP settings file. Remove the DART_API_KEY key from the configuration.
FAQ
Where do I get an OpenDART key?
Register on opendart.fss.or.kr and apply for a key; a 40-character key arrives by email at once. The free limit is 20,000 requests a day, and you put the key into the `DART_API_KEY` variable.
How do I connect the server to Claude Code?
Run `/plugin marketplace add chrisryugj/korean-dart-mcp`, then `/plugin install korean-dart`. The key is requested once during installation.
What does the setup wizard do?
`npx -y korean-dart-mcp setup` asks for the key, lets you pick a client among Claude Desktop, Cursor, Claude Code, Windsurf, VS Code, Gemini CLI, Zed or Antigravity, and patches the settings file. On Windows it wraps the launch in `cmd /c npx`.
How do I read a report attachment?
Call `get_attachments` in `extract` mode: it converts an HWP or PDF attachment into Markdown. In the README example a 2.2 MB PDF became text in 3.7 seconds.
How is it different from OpenDartReader?
OpenDartReader and dart-fss return tables for Python, while this server hands results to an agent over MCP. By the author's comparison it is the only Node.js one with insider analysis and XBRL parsing.
Discussion
No questions or reviews yet.
Related
MCP serversMCP server for Korean stock analysis: DART disclosures and financials, daily prices and issuer data from KRX
MCP server over Korean DART and US SEC EDGAR disclosures: company financials, peer comparison and valuation for an agent.
Korean taxes computed by code and not by a model: 109 tools for corporate, income and VAT tax with a statute in the answer
Financial Datasets MCP
Financial Datasets MCP Server
An MCP server for the Financial Datasets API: company financials, stock and crypto prices and news for the agent
An MCP server for SEC EDGAR: US company filings, forms 10-K, 10-Q and 8-K, XBRL-parsed financials and insider trades
A financial analysis MCP server: 500+ methods from company statements, ratios, indicators, risk metrics and macro data
README in short
The README is in Korean, with an English version. It opens with a one-command install and five scenarios for a private investor, then shows measured results on real data, a comparison table with other DART tools and a candid list of weaknesses. The analytical layer, three install routes and the OpenDART key follow.