# Korea Public Data

> Korea Public Data is an open-source MCP server for legal and government. Look up Korean business status, public holidays, road addresses and apartment trades. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://appmonster.co.kr
- **Repository:** https://github.com/groove79/kmcp/tree/HEAD/packages/public-data
- **MCP Registry name:** io.github.groove79/mcp-public-data
- **Categories:** legal and government, analytics and data
- **Listing updated:** 2026-11-15

## About

This server wraps four Korean government data services for agents that work with Korean businesses and property. kr_check_business takes up to 100 business registration numbers and reports whether each is active, suspended or closed, with tax type and closure date, from the National Tax Service. kr_holidays returns public and substitute holidays for a year or month from the Korea Astronomy and Space Science Institute. kr_search_address finds road or lot addresses, postal codes, buildings and administrative codes, and kr_apt_trades lists apartment sale transactions for a district code and month, optionally filtered by name.

All four tools are read-only. It runs locally over stdio from the npm package @appmonster/mcp-public-data and needs free keys: a data.go.kr service key (decoded form) for three of the tools, and a business.juso.go.kr key for address search. The README is bilingual, with Korean example prompts, and the project is MIT licensed.

## Features

- **Business status check:** Checks up to 100 registration numbers at a time.
- **Holiday calendar:** Public and substitute holidays by year or month.
- **Address search:** Road and lot addresses with postal codes and admin codes.
- **Apartment trades:** Sale records by district code and month.
- **Free keys:** Uses free government API keys.
- **Read-only:** None of the tools change data.

## Good for

- Verify a supplier's business registration is still active
- Put the right public holidays in a delivery notice
- Normalise a Korean address and find its postal code
- Check recent apartment sale prices in a district

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-public-data --env DATA_GO_KR_KEY='<DATA_GO_KR_KEY>' --env JUSO_KEY='<JUSO_KEY>' -- npx -y @appmonster/mcp-public-data
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-public-data": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-public-data"
      ],
      "env": {
        "DATA_GO_KR_KEY": "<DATA_GO_KR_KEY>",
        "JUSO_KEY": "<JUSO_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-public-data": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-public-data"
      ],
      "env": {
        "DATA_GO_KR_KEY": "<DATA_GO_KR_KEY>",
        "JUSO_KEY": "<JUSO_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-public-data": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-public-data"
      ],
      "env": {
        "DATA_GO_KR_KEY": "<DATA_GO_KR_KEY>",
        "JUSO_KEY": "<JUSO_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-public-data": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-public-data"
      ],
      "env": {
        "DATA_GO_KR_KEY": "<DATA_GO_KR_KEY>",
        "JUSO_KEY": "<JUSO_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-public-data": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-public-data"
      ],
      "env": {
        "DATA_GO_KR_KEY": "<DATA_GO_KR_KEY>",
        "JUSO_KEY": "<JUSO_KEY>"
      }
    }
  }
}
```

## Tools

- `kr_check_business`: Returns NTS status for up to 100 business numbers
- `kr_holidays`: Returns public and substitute holidays for a year or month
- `kr_search_address`: Searches road or lot addresses with postal code and admin code
- `kr_apt_trades`: Lists apartment sale transactions for a district code and month

## FAQ

### What keys does it need?

DATA_GO_KR_KEY from data.go.kr for business, holiday and apartment tools, and JUSO_KEY from business.juso.go.kr for address search. Both are free.

### How do I run it?

Add npx -y @appmonster/mcp-public-data to your MCP config with the keys as environment variables.

### What licence is it?

MIT.

### How many business numbers per call?

Up to 100.

### Is Korea Public Data free?

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

### How do I add Korea Public Data to Claude Code?

Run this command in your terminal: claude mcp add mcp-public-data --env DATA_GO_KR_KEY='<DATA_GO_KR_KEY>' --env JUSO_KEY='<JUSO_KEY>' -- npx -y @appmonster/mcp-public-data

### What are the best alternatives to Korea Public Data?

The closest alternatives to Korea Public Data are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## 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.
- [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.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.

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