Skip to main content
Glama
hypn4

opendart-fss-mcp

by hypn4

opendart-fss-mcp

Python 3.14+

한국어

MCP server for Korea's DART (Financial Supervisory Service) corporate disclosure API.

What is OpenDART?

DART (Data Analysis, Retrieval and Transfer System) is Korea's equivalent of the SEC's EDGAR system. It is the official electronic disclosure system operated by the Financial Supervisory Service (FSS) where all Korean corporations submit their financial reports, major event disclosures, and shareholding information.

OpenDART provides a public API to access this data programmatically.

Features

  • 84 tools covering 6 DART API categories — disclosure search, financial statements, periodic reports, shareholding, major events, and securities registration

  • Runs as a stdio or HTTP (Streamable HTTP) MCP server

  • Works with Claude Desktop, Claude Code, and any MCP-compatible client

  • Built on FastMCP and opendart-fss SDK

Prerequisites

Installation

uv pip install opendart-fss-mcp

Or install from source:

git clone https://github.com/hypn4/opendart-fss-mcp.git cd opendart-fss-mcp uv sync

Configuration

Copy .env.example to .env and set your values:

cp .env.example .env

Variable

Description

Default

OPENDART_API_KEY

OpenDART API key (required)

OPENDART_MCP_TRANSPORT

Transport protocol: stdio | http

stdio

OPENDART_MCP_HOST

HTTP bind address

127.0.0.1

OPENDART_MCP_PORT

HTTP port

8000

OPENDART_MCP_LOG_LEVEL

Log level: DEBUG | INFO | WARNING | ERROR | CRITICAL

INFO

Usage

Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

From PyPI:

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

From source:

{ "mcpServers": { "opendart": { "command": "uv", "args": [ "run", "--directory", "/path/to/opendart-fss-mcp", "opendart-mcp" ], "env": { "OPENDART_API_KEY": "your_api_key_here" } } } }

Claude Code

From PyPI:

claude mcp add opendart -e OPENDART_API_KEY=your_api_key_here -- uvx --from opendart-fss-mcp opendart-mcp

From source:

claude mcp add opendart -e OPENDART_API_KEY=your_api_key_here -- uv run --directory /path/to/opendart-fss-mcp opendart-mcp

CLI

# stdio mode (default) opendart-mcp # HTTP mode opendart-mcp --transport http --host 127.0.0.1 --port 8000

FastMCP

fastmcp run src/opendart_fss_mcp/server.py:mcp

Available Tools

84 tools organized into 6 categories:

Category

Prefix

Tools

Description

Disclosure

disclosure_

5

Company search, disclosure list, document viewer

Financial

financial_

7

Financial statements (single/multi account, XBRL)

Report

report_

28

Periodic report key items (compensation, capital, directors, etc.)

Shareholding

shareholder_

2

Major shareholder and executive holdings

Major Events

event_

36

M&A, capital changes, stock events, lawsuits, and more

Registration

registration_

6

Securities registration statement details

Development

# Install dev dependencies uv sync # Run tests uv run pytest # Lint & format uv run ruff check . uv run ruff format . # Type check uv run pyright

License

MIT

  • OpenDART — Official OpenDART API portal

  • DART — Electronic Disclosure System

  • opendart-fss — Python SDK for OpenDART API

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hypn4/opendart-fss-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server