# Korea Data MCP

> Korea Data MCP is an open-source MCP server for finance and payments. Korean filings, stock prices, apartment trades, statutes and statistics from official APIs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, self-hosted
- **Repository:** https://github.com/youngsoonlee/korea-data-mcp
- **MCP Registry name:** io.github.YoungsoonLee/korea-data-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [analytics and data](https://ai-powered.com/categories/analytics-and-data), [legal and government](https://ai-powered.com/categories/legal-and-government)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [dashboard-icons](https://ai-powered.com/mcp/dashboard-icons): dashboard-icons is an open-source MCP server for analytics and data.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [DataArcus for Power BI](https://ai-powered.com/mcp/dataarcus-for-power-bi): DataArcus for Power BI is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/korea-data-mcp
