Skip to content
MCP server

Korea Data MCP

Korean filings, stock prices, apartment trades, statutes and statistics from official APIs

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.1.10
Listing updated
today

Similar MCP servers

About Korea Data MCP

Korea Data MCP is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Raw Korean government APIs hide traps that quietly produce wrong answers, and this server exists to handle them. Its example: OpenDART returns a second-quarter figure in the field an agent would read as half-year revenue. The server returns both periods with explicit dates. It documents 101 such traps, including laws listed as current that take effect later, cancelled apartment deals, and district codes that changed in 2026.

It draws on OpenDART, data.go.kr, law.go.kr and the Bank of Korea ECOS service, so you need a free key from each source you use. It runs locally as a single binary or one-click Claude Desktop bundle, and the README says keys and questions go only to the government APIs, with no telemetry. The README counts 25 tools.

An evaluation of 10 questions reported one call each with the server, against about three times as many calls and one miss using the raw APIs.

Install

Run in a terminal

claude mcp add korea-data-mcp --env OPENDART_API_KEY='<OPENDART_API_KEY>' --env DATAGOKR_SERVICE_KEY='<DATAGOKR_SERVICE_KEY>' --env LAWGOKR_OC='<LAWGOKR_OC>' --env ECOS_API_KEY='<ECOS_API_KEY>' -- npx -y https://github.com/YoungsoonLee/korea-data-mcp/releases/download/v0.1.10/korea-data-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "korea-data-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/YoungsoonLee/korea-data-mcp/releases/download/v0.1.10/korea-data-mcp.mcpb"
      ],
      "env": {
        "OPENDART_API_KEY": "<OPENDART_API_KEY>",
        "DATAGOKR_SERVICE_KEY": "<DATAGOKR_SERVICE_KEY>",
        "LAWGOKR_OC": "<LAWGOKR_OC>",
        "ECOS_API_KEY": "<ECOS_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "korea-data-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/YoungsoonLee/korea-data-mcp/releases/download/v0.1.10/korea-data-mcp.mcpb"
      ],
      "env": {
        "OPENDART_API_KEY": "<OPENDART_API_KEY>",
        "DATAGOKR_SERVICE_KEY": "<DATAGOKR_SERVICE_KEY>",
        "LAWGOKR_OC": "<LAWGOKR_OC>",
        "ECOS_API_KEY": "<ECOS_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "korea-data-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/YoungsoonLee/korea-data-mcp/releases/download/v0.1.10/korea-data-mcp.mcpb"
      ],
      "env": {
        "OPENDART_API_KEY": "<OPENDART_API_KEY>",
        "DATAGOKR_SERVICE_KEY": "<DATAGOKR_SERVICE_KEY>",
        "LAWGOKR_OC": "<LAWGOKR_OC>",
        "ECOS_API_KEY": "<ECOS_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "korea-data-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/YoungsoonLee/korea-data-mcp/releases/download/v0.1.10/korea-data-mcp.mcpb"
      ],
      "env": {
        "OPENDART_API_KEY": "<OPENDART_API_KEY>",
        "DATAGOKR_SERVICE_KEY": "<DATAGOKR_SERVICE_KEY>",
        "LAWGOKR_OC": "<LAWGOKR_OC>",
        "ECOS_API_KEY": "<ECOS_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "korea-data-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/YoungsoonLee/korea-data-mcp/releases/download/v0.1.10/korea-data-mcp.mcpb"
      ],
      "env": {
        "OPENDART_API_KEY": "<OPENDART_API_KEY>",
        "DATAGOKR_SERVICE_KEY": "<DATAGOKR_SERVICE_KEY>",
        "LAWGOKR_OC": "<LAWGOKR_OC>",
        "ECOS_API_KEY": "<ECOS_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • OPENDART_API_KEYOpenDART key for corporate filings, financials, dividends, shareholders, stakes in other companies and major decisions (opendart.fss.or.kr)
  • DATAGOKR_SERVICE_KEYdata.go.kr Decoding key for holidays, corporations, business status, apartment trades and rents, stock prices, pension workplaces
  • LAWGOKR_OClaw.go.kr OC for statutes and court rulings (set at open.law.go.kr)
  • ECOS_API_KEYBank of Korea ECOS key for interest rates, exchange rates, prices, GDP and other statistics (ecos.bok.or.kr/api)

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

entity_resolve_company
Identifies a company from a name or number and returns identifiers and status.
opendart_search_companies
Searches companies and checks whether each is listed.
opendart_get_financials
Financial statements with period dates, including full scope.
opendart_get_investments
Stakes in other companies.
opendart_list_corporate_actions
Rights issues, buybacks, mergers and other major decisions.
opendart_get_ownership_reports
Reports by 5% holders and insiders.
opendart_get_dividends
Dividend data.
opendart_get_major_shareholders
Largest shareholders.
ecos_get_series
Bank of Korea statistical series.
ecos_search_series
Searches ECOS series.
datagokr_list_apartment_rents
Apartment rents.
datagokr_get_pension_workplaces
National Pension Service workplaces with 12-month history.

What it does

Corporate filings
Financials, dividends, major shareholders, stakes and major decisions.
Property trades and rents
Apartment sales and rents with cancelled deals removed.
Statutes and rulings
Law text in force on a given date, plus court rulings.
Economic series
Bank of Korea rates, exchange rates and other statistics.
Company resolution
Identifies a company from a name or number, with former names.
Local and private
Runs on your machine without telemetry.

Good for

  • Compare a company's half-year revenue and dividends
  • Check whether a supplier's business is still active
  • Find median apartment prices for a district
  • Ask whether a law article is in force yet

Pricing

Open source

Uses free official API keys

Korea Data MCP FAQ

What keys are needed?

Keys for OpenDART, data.go.kr, law.go.kr and ECOS, depending on what you use.

Where does it run?

Locally, as a binary or a Claude Desktop bundle.

Does it send data to a third party?

The README says keys and questions go only to the government APIs.

Can I use Korean?

Yes, English or Korean.

Is Korea Data MCP free?

Yes. Korea Data MCP is open source, so you can use and self-host it for free.

How do I add Korea Data MCP to Claude Code?

Run this command in your terminal: claude mcp add korea-data-mcp --env OPENDART_API_KEY='<OPENDART_API_KEY>' --env DATAGOKR_SERVICE_KEY='<DATAGOKR_SERVICE_KEY>' --env LAWGOKR_OC='<LAWGOKR_OC>' --env ECOS_API_KEY='<ECOS_API_KEY>' -- npx -y https://github.com/YoungsoonLee/korea-data-mcp/releases/download/v0.1.10/korea-data-mcp.mcpb

What are the best alternatives to Korea Data MCP?

The closest alternatives to Korea Data MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons, Solana MCP by Vybe and Tapetide - Indian Stock Market MCP.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers