🇰🇷

Korea DART Financial Report MCP

v1.0.0

Data IngestionRecommendedLocal

Local MCP service running via uvx to access Korea Open DART data through structured tools, including stock code parsing by company name, list queries, report downloads, and full-text search. Requires DART API Key.

§ Quickstart

Add the following to your MCP client configuration (Cursor, Claude Desktop, etc.):

Settings (top right) → Cursor Settings → Features → MCP → Add New MCP Server. Set to command, type uvx, and provide env vars.

MCP Client Configuration

{
  "mcpServers": {
    "mcp-dart": {
      "command": "uvx",
      "args": [
        "agentladle-mcp-dart"
      ],
      "env": {
        "DART_API_KEY": "YOUR_DART_API_KEY_HERE",
        "UV_HTTP_TIMEOUT": "300"
      }
    }
  }
}

Config file locations

Please ensure Python uv tool is installed.

§ Tools Reference

6 tools

search_dart_company

Look up stock_code / corp_code by company name (Korean/English)

Parameter	Type	Required	Description
query	string	✓	公司名 / Company name
exact	boolean	—	是否精确相等 / Exact match
limit	number	—	最多返回数 / Limit

Returns:Array

list_dart_filings

List company DART filings by stock code

Parameter	Type	Required	Description
stock_code	string	✓	股票代码 / Stock code
bgn_de	string	—	起始日期 YYYYMMDD
end_de	string	—	终止日期 YYYYMMDD

Returns:Array

download_dart_report

Download DART ZIP and parse into cached JSON

Parameter	Type	Required	Description
rcept_no	string	✓	DART 接收号 / DART receipt no
stock_code	string	—	股票代码 / Stock code

Returns:Object

keyword_search

Korean full-text keyword search

Parameter	Type	Required	Description
rcept_no	string	✓	DART 接收号 / DART receipt no
keywords	string[]	✓	关键词列表 / List of keywords

Returns:Array

get_report_toc

Get complete section_tree directory with page ranges

Parameter	Type	Required	Description
rcept_no	string	✓	DART 接收号 / DART receipt no
stock_code	string	—	股票代码 / Stock code

Returns:Object

get_report_pages

Read pages by global page numbers or section_code

Parameter	Type	Required	Description
rcept_no	string	✓	DART 接收号 / DART receipt no
start_page	number	—	起始页 / Start page
page_count	number	—	返回页数 / Page count
end_page	number	—	结束页 / End page
section_code	string	—	DART 章节码 / DART section code

Returns:Array

§ Examples

Once configured, you can ask the AI directly:

Fast Full-text Search

Analyze the revenue situation in Samsung's latest financial report.

When cache exists, directly call keyword_search with Korean keywords like "매출" (revenue) to extract highlighted snippets.

Download and Analyze Specific Topic from Scratch

Query the R&D progress in LG Energy Solution's latest financial report.

Call search_dart_company to get code, list_dart_filings to check reports, download_dart_report to parse, and finally keyword_search.

Analyze Single-Page Announcement (HTML Extraction)

Extract Samsung's latest earnings guidance (잠정실적) and summarize profit changes.

Filter report_types=["I002"] in list_dart_filings for earnings preview, MCP will auto-use HTML parser for extraction and search.