korea-data-mcp

MCP server for Korean company data — identity, registration status, and month-by-month employment from government payroll records, in English.

{
  "mcpServers": {
    "korea-company": {
      "command": "npx",
      "args": ["-y", "korea-data-mcp"],
      "env": { "KCID_API_KEY": "kcid_..." }
    }
  }
}

Get a key at https://notonlystock.com/korea/account — new accounts start with 5,000 free credits, no card.

Tools

| Tool | Returns | Credits | |---|---|---| | lookup_korean_company | Full record by BRN, worksite addresses included | 100 | | search_korean_companies | Records by name, industry, region, size, status | 100 per row | | get_employment_history | 36 months of pension subscribers, hires and separations | 1,000 | | convert_korean_address | Official English form of a Korean street address | 1 | | korean_holidays | Is this date a Korean business day, or list a year's holidays — English names | 1 | | find_korean_rail_stop | Subway and commuter-rail stations by name, English or Korean | 1 per row | | get_rail_departures | Every scheduled departure from a station, in time order | 1 per row | | get_credit_balance | Balance | 0 |

Each tool states its own cost, so an agent can budget before it calls. Rail times follow the GTFS convention and may exceed 24 hours — a train leaving at 1am the next service day reads 25:00:00. Which days a service runs, public holidays included, is at GET /transit/calendar, which is free. search_korean_companies accepts count_only to see how many match for 100 credits before pulling rows, and limit (up to 1,000) to cap the bill. A full page returns next_cursor; pass it back as cursor to continue — paging costs the same per row.

Coverage

152,367 Korean for-profit corporate headquarters with 10 or more insured employees. The monthly employment series exists for 91.9% of them — filter on has: "pension_series" to get only those, or read employment_series on any record.

Registration numbers are validated against the National Tax Service, so placeholder numbers that appear in the source registry are not in here.

What is in the data →

What this does not do

No score, no grade, no ranking, no opinion about any company. No sanctions, penalties or litigation history. No personal data. Facts and their sources only.

MIT licensed. The API is v0 and may change without notice until v1.