@vertical-mcp/dart-mcp

MCP server for Korea's DART (Data Analysis, Retrieval and Transfer) electronic disclosure system, operated by the Financial Supervisory Service (FSS). Exposes company disclosures, company profiles, and financial statements via the OpenDART public API.

한국 금융감독원(FSS)이 운영하는 DART(전자공시시스템)의 공개 API(OpenDART)를 MCP 서버로 래핑한 패키지. 기업 공시, 기업 개황, 재무제표를 Claude·Cursor 등 MCP 호환 클라이언트에서 바로 조회할 수 있다.

Tools

| Tool | Description | |------|-------------| | search_disclosures | Search disclosures by date range, company corp_code, disclosure type, and market (KOSPI / KOSDAQ / KONEX). | | get_company_info | Get company profile: name, CEO, registration numbers, address, homepage, IR page, industry code, establishment date, fiscal year-end month. | | get_financial_summary | Get full financial statement line items (BS / IS / CIS / CF / SCE) for a given year and report. Supports consolidated (CFS) or separate (OFS). |

Quick start

1. Register for an OpenDART API key

Register free at https://opendart.fss.or.kr. You'll receive a 40-character crtfc_key. The key is issued immediately after email verification.

2. Install

npx @vertical-mcp/dart-mcp

Or install globally:

npm install -g @vertical-mcp/dart-mcp
dart-mcp

3. Configure your MCP client

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "dart-mcp": {
      "command": "npx",
      "args": ["-y", "@vertical-mcp/dart-mcp"],
      "env": {
        "DART_API_KEY": "your-40-char-key-here"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "dart-mcp": {
      "command": "npx",
      "args": ["-y", "@vertical-mcp/dart-mcp"],
      "env": {
        "DART_API_KEY": "your-40-char-key-here"
      }
    }
  }
}

Smithery-hosted (coming soon)

When the Smithery hosted deploy is live, you can register the session-scoped dartApiKey via Smithery's config UI — no local env var needed.

Environment variables

| Variable | Required | Description | |----------|----------|-------------| | DART_API_KEY | Yes | 40-character OpenDART API key from https://opendart.fss.or.kr. |

Examples

Find Samsung Electronics disclosures in the last week

search_disclosures({
  corp_code: "00126380",
  bgn_de: "20260415",
  end_de: "20260422",
  page_count: 20
})

Get Hyundai Motor's company profile

get_company_info({ corp_code: "00164742" })

Get SK Hynix 2024 annual consolidated financials

get_financial_summary({
  corp_code: "00164779",
  bsns_year: "2024",
  reprt_code: "11011",
  fs_div: "CFS"
})

Finding corp_code

OpenDART uses its own 8-digit corp_code — not the 6-digit stock ticker. You can fetch the full mapping (CORPCODE.xml, ~120 k entries) from OpenDART's /api/corpCode.xml endpoint. A helper list_corp_codes tool is on the v0.2 roadmap.

Development

git clone https://github.com/vertical-mcp/dart-mcp.git
cd dart-mcp
npm install
npm run build
npm start

Scripts

• npm run dev — watch mode via tsx
• npm run build — compile to dist/
• npm run typecheck — no-emit type check
• npm run clean — remove dist/

Roadmap

• v0.1 — search_disclosures, get_company_info, get_financial_summary (this release)
• v0.2 — list_corp_codes, get_major_shareholders, get_audit_report, disclosure document full-text fetch
• v0.3 — XBRL normalization, multi-period trend queries, insider transactions

Legal / attribution

• Data source: OpenDART — Korea Financial Supervisory Service.
• This package is an unofficial community wrapper. It is not affiliated with or endorsed by the FSS.
• Rate limit: ~20,000 requests/day per API key (OpenDART policy).

License

MIT © 2026 Yongbum Kim