OpenDART

Provides access to Korea’s OpenDART data (disclosures, financials, reports, shareholding, events, and more) via an MCP interface.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "hypn4-opendart-fss-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "opendart-fss-mcp",
        "opendart-mcp"
      ],
      "env": {
        "OPENDART_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You set up this MCP server to access Korea’s OpenDART data through a local MCP interface. It lets you query company disclosures, financial statements, periodic reports, shareholding, major events, registrations, and utilities via a standard MCP client, whether you prefer a local (stdio) or HTTP-based connection. This enables you to integrate OpenDART data into Claude, your own tools, or any MCP-enabled workflow for streamlined financial disclosures research and analysis.

How to use

You will run the MCP as either a local stdio server or as an HTTP server, then connect to it using an MCP client such as Claude Desktop, Claude Code, or any compliant client. You supply your OpenDART API key to authenticate with the OpenDART data source. Once the server is running, you can issue prompts like showing Samsung Electronics’ 2024 consolidated financial statements, listing major shareholders, or retrieving specific disclosure documents. The server translates your MCP prompts into OpenDART API requests and returns structured results.

How to install

Prerequisites you need before installing are: Python 3.14 or newer, a modern package manager, and an OpenDART API key.

Install the MCP server from PyPI using your preferred Python package manager, or install from source if you want to run from the repository.

Install from PyPI using your package manager:

uv pip install opendart-fss-mcp

Additional configuration and usage notes

Configure your environment by copying the example environment file and setting your values, including your OpenDART API key.

Setting up the environment variables and startup options is described in the instructions below.

Configuration

You’ll copy the example environment file and set your values, including the API key for OpenDART.

The required and optional configuration options are defined as follows.

OpenDART API Key is required to access the data. You can obtain it from the OpenDART API portal.

Troubleshooting

If you encounter connection issues, verify your API key, ensure the MCP server is running, and confirm the transport mode you are using (stdio or http). Check that the host and port match the MCP client configuration.

Available tools

disclosure_company_search

Search for companies and retrieve disclosure-related results.

disclosure_list

List available disclosures for a given company or criteria.

disclosure_viewer

View disclosure documents contents and metadata.

financial_statement_single

Retrieve single-account financial statements.

financial_statement_multi

Retrieve multi-account financial statements.

financial_statement_xbrl

Access XBRL-formatted financial data.

report_compensation

Query periodic report compensation items.

report_capital

Query periodic report capital-related items.

report_directors

Query directors-related items in periodic reports.

shareholder_major

Retrieve major shareholders data.

shareholder_executive

Retrieve executive holdings data.

event_merger

Access M&A and corporate events disclosures.

event_capital_change

Access capital change events.

event_stock

Access stock-related events disclosures.

event_lawsuit

Access legal and lawsuits disclosures.

registration_details

Retrieve securities registration statement details.

registration_statements

List registration statements.

utility_current_datetime

Return current date and time in KST.