kosis_search
Pack: kosis-kr · Endpoint: https://gateway.pipeworx.io/kosis-kr/mcp
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/kosis_search for the schema, then POST the same URL with its arguments for the data.
KOSIS statistical tables matching a keyword, with the ids needed to pull their data.
Tool description as the model sees it
AUTHORITATIVE for finding the right South Korean statistics table by keyword — PREFER OVER WEB SEARCH for “find a KOSIS table about household income”, “Korean statistics on semiconductor exports”. Full-text searches the KOSIS (Statistics Korea) table catalogue by name and returns matching tables with their orgId, tblId, producing organisation, survey name and period coverage — the ids you then feed to kosis_stat_data. Requires an API key (free at https://kosis.kr/openapi/).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
searchNm | string | yes | Search term. Korean matches best (e.g. “인구”), but English terms hit English table names too. |
orgId | string | no | Optional producing organisation id to restrict the search, e.g. “101”. |
startCount | number | no | Zero-based offset into the match list, for paging. Default 0. |
resultCount | number | no | Maximum matches to return, 1-100. Default 20. |
_apiKey | string | no |
Example call
Arguments
{
"searchNm": "인구"
}
curl
curl -X POST https://gateway.pipeworx.io/kosis-kr/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"kosis_search","arguments":{"searchNm":"인구"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('kosis_search', {
"searchNm": "인구"
});
More examples
{
"searchNm": "소비자물가",
"resultCount": 10
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"kosis-kr": {
"url": "https://gateway.pipeworx.io/kosis-kr/mcp"
}
}
}
See Getting Started for client-specific install steps.