@pipeworx/kosis-kr
Connect: https://gateway.pipeworx.io/kosis-kr/mcp · Install: one-click buttons
No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.
Tools: 3
Korean national statistics (KOSIS) — browse, search and pull time series from Statistics Korea’s official statistical database of ~100,000 tables covering population, prices, employment, trade and industry.
Tools
kosis_stat_list({ parentListId, vwCd, _apiKey })— walk the table directory one level at a time.kosis_search({ searchNm, orgId, startCount, resultCount, _apiKey })— find tables by keyword; returns theorgId+tblIdpair the data tool needs.kosis_stat_data({ orgId, tblId, itmId, objL1, objL2, prdSe, newEstPrdCnt, startPrdDe, endPrdDe, _apiKey })— observations from one table.
Auth
Platform key (PLATFORM_KOSIS_KEY) with BYO override via ?_apiKey=.
Free registration at https://kosis.kr/openapi/ — sign up, request OpenAPI
access per service, key issued immediately (no manual approval step).
Data sources
- https://kosis.kr/openapi/statisticsList.do — table directory.
- https://kosis.kr/openapi/statisticsSearch.do — keyword search over tables.
- https://kosis.kr/openapi/Param/statisticsParameterData.do — observations.
Traps
- KOSIS reports an invalid or missing key as HTTP 200 with a body of
{"err":"11","errMsg":"유효하지않은 인증KEY입니다."}. Every status-code check reads that as success. This pack inspectserron a 200 and raises. prdSemust match what the table actually publishes. Asking a monthly table for"Y"returns zero observations with no error.- Korean-language search terms match far more tables than English ones.
- The success payload is unverified — no fleet key exists. Field names come
from the published parameter guide; every tool also returns
raw, so a caller with a real key gets the untouched payload if a name here is stale.
Tools
- kosis_stat_list — The KOSIS statistical table directory for South Korea, one level at a time.
- kosis_stat_data — Observations from one KOSIS statistical table for South Korea.
- kosis_search — KOSIS statistical tables matching a keyword, with the ids needed to pull their data.
Tools
kosis_search— KOSIS statistical tables matching a keyword, with the ids needed to pull their data.kosis_stat_data— Observations from one KOSIS statistical table for South Korea.kosis_stat_list— The KOSIS statistical table directory for South Korea, one level at a time.