list_data_catalog
Pack: estat-japan · Endpoint: https://gateway.pipeworx.io/estat-japan/mcp
Browse the e-Stat high-level data catalog (dataset/table groupings) with an optional free-text filter. Returns catalog entries with dataset IDs, names, and organization metadata. This endpoint is slow at e-Stat and often exceeds its 35s budget, in which case it returns {found:false, reason:“upstream_timeout”}; search_stats answers “which Japanese statistics table covers X” faster. Requires _apiKey.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | no | Optional free-text filter, Japanese or English |
limit | number | no | Page size, 1-100. Defaults to 20 when omitted, so a bare call is already bounded. |
start_position | number | no | 1-based offset (default 1) |
lang | string | no | J (Japanese, default) | E (English) |
data_type | string | no | Restrict to one file format: XLS | CSV | PDF | XML | XLS_REP | DB |
survey_years | string | no | Survey period: yyyy, yyyymm, or yyyymm-yyyymm |
stats_code | string | no | Government statistics code, e.g. “00200521” (population census) |
stats_field | string | no | Statistical field code, 2 digits (major) or 4 digits (minor) |
Example call
Arguments
{
"query": "労働"
}
curl
curl -X POST https://gateway.pipeworx.io/estat-japan/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_data_catalog","arguments":{"query":"労働"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('list_data_catalog', {
"query": "労働"
});
More examples
{
"lang": "E",
"limit": 15
}
Response shape
Full JSON Schema
{
"type": "object",
"description": "Response from e-Stat getDataCatalog endpoint containing table groupings"
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"estat-japan": {
"url": "https://gateway.pipeworx.io/estat-japan/mcp"
}
}
}
See Getting Started for client-specific install steps.