@pipeworx/sdmx-structure

Connect: https://pipeworx.io/mcp — every tool in the catalog, including @pipeworx/sdmx-structure’s. 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

Dataflow dimensions and code lists — “what do the codes in this dataset mean” — for any SDMX 2.1 statistical registry: Eurostat, OECD, the European Central Bank, the UN Statistics Division (via the data.un.org SDMX hub), the IMF, the Bank for International Settlements, ILOSTAT, and the Australian Bureau of Statistics. This is the STRUCTURE half of SDMX, distinct from pulling observations — use it to decode a dimension’s codes or to learn the key order a registry’s own get_data tool needs.

Tools

• sdmx_dataflow_structure(registry, dataflow, agency?, version?, max_codes_per_dimension?) — the ordered dimensions of one dataflow, each with its codelist’s code→label pairs (capped per dimension, with a truncation flag and the true total count). Resolves the dataflow’s real DSD (Data Structure Definition) reference rather than assuming the dataflow id equals the DSD id — they differ for many flows (Eurostat’s UNE_RT_M dataflow v1.0 points at DSD UNE_RT_M v155.0; BIS’s WS_CBPOL dataflow points at a differently named DSD, BIS_CBPOL).
• sdmx_codelist(registry, id, agency?, version?, filter?, limit?) — one codelist’s code→label pairs by id alone, with no dataflow needed. Useful once you already know a codelist id (from sdmx_dataflow_structure’s codelist field, or from documentation) and just want the codes, optionally filtered by a substring.
• sdmx_find_dataflow(registry, query, agency?, limit?) — keyword search across a registry’s dataflow catalogue by id or name, to find the id to pass to sdmx_dataflow_structure.

Registries

Pass agency to override the default when a dataflow is published by a different maintaining agency than the registry’s usual one (common on OECD, e.g. OECD.SDD.NAD).

Not included: Stats NZ. Its SDMX endpoint requires a platform API key (Ocp-Apim-Subscription-Key, injected by the gateway from PLATFORM_STATSNZ_KEY) and a literal, non-URL-encoded comma in its flowRef path segment — neither fits this pack’s keyless, URL-encoded-path design, and the stats-nz pack already ships a dedicated structure tool. See that pack.

Overlap with existing packs — read before calling this for ILO or ABS. The ilostat pack already ships dataflow_structure for ILO dataflows, and the abs-au pack already ships dataflow_structure for ABS dataflows — both inline codes directly, the same job sdmx_dataflow_structure here does. This pack supports registry: "ilo" and registry: "abs" only for the standalone sdmx_codelist lookup (a codelist by id, no dataflow needed) that neither of those packs exposes. Prefer ilostat’s / abs-au’s own dataflow_structure for an ILO or ABS dataflow — every response from this pack for those two registries repeats that in an overlap field.

Auth

Keyless. No auth on any of the eight registries above.

Data sources

• Eurostat SDMX 2.1 REST API — https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1 — structure endpoints (/dataflow, /datastructure, /codelist) answer SDMX-ML XML only; every JSON Accept header and format=SDMX-JSON query param this pack tried either 406s or is silently ignored (confirmed live 2026-10-08). The eurostat pack’s own data endpoint (/dissemination/statistics/1.0/data) is a different API that does speak JSON-stat — the two are not interchangeable.
• OECD SDMX 2.1 REST API — https://sdmx.oecd.org/public/rest.
• European Central Bank Data Portal — https://data-api.ecb.europa.eu/service — structure endpoints are XML only, same split the ecb pack already documents for its own /dataflow call (fleet #1158): the DATA endpoints speak SDMX-JSON, the STRUCTURE endpoints (/dataflow, /datastructure, /codelist) do not.
• UN Statistics Division SDMX hub — https://data.un.org/legacy/ws/rest — the documented https://data.un.org/ws/rest/... path 302-redirects here; this pack calls the redirect target directly. It is a small, multi-agency hub (~15 dataflows observed) carrying UNSD’s own flows (DF_UNDATA_ENERGY, DF_UNDATA_COUNTRYDATA) alongside mirrored IAEG-SDGs, UIS and World Bank flows under their own agency ids — pass agency if a dataflow you want belongs to one of those rather than UNSD.
• IMF SDMX 2.1 REST API — https://api.imf.org/external/sdmx/2.1. IMF concept-level representation trap: some IMF dimensions carry no localRepresentation.enumeration at all — e.g. EER’s COUNTRY and INDICATOR dimensions. Their codelist is declared on the shared CONCEPT instead: the dimension’s conceptIdentity URN points at a concept scheme (e.g. IMF:CS_MASTER_DATA), and that concept’s own coreRepresentation.enumeration is the real codelist (IMF:CL_COUNTRY for COUNTRY). This pack follows that chain automatically; a naive implementation that only reads dimension.localRepresentation will report those dimensions as codeless.
• Bank for International Settlements SDMX 2.1 REST API — https://stats.bis.org/api/v2/structure (note the /structure segment — BIS nests dataflow/datastructure/codelist resources under it, unlike every other registry here).
• ILOSTAT SDMX 2.1 REST API — https://sdmx.ilo.org/rest. Accept-Language trap: ILO’s backend returns a bare 500 languageTag1 body for any request with no Accept-Language header at all — reproduced with Node’s/Workers’ fetch (which sends none by default) but NOT with curl, confirmed live 2026-10-08. This pack sends Accept-Language: en on every outbound request to every registry (harmless elsewhere) specifically because of this.
• Australian Bureau of Statistics Data API — https://data.api.abs.gov.au/rest — the documented host api.data.abs.gov.au does not resolve; this is the same live host the abs-au pack already found and documented.

Size trap, all registries: fetching a DSD with references=children pulls in every codelist it uses in one response — Eurostat’s UNE_RT_M alone is 3.7MB because its GEO (country/region) codelist is 2.6MB. This pack never does that: it fetches the DSD with references=none (a few KB — just the dimension list and each dimension’s codelist REFERENCE), then fetches only the codelists actually needed, one at a time, each capped to max_codes_per_dimension (default 50, max 500) with a truncation flag and the true total code count.

A 404 on a structure endpoint always means “no such id” — unlike a data endpoint, there is no “dataflow exists but no observations matched” ambiguity for a structure query, so this pack does not need the data-endpoint no_records/no_dataflow split that shared/src/sdmx-miss.ts provides for other packs’ get_data tools. Every 404 here comes back as a structured {error: "not_found", ...} naming sdmx_find_dataflow as the next step. A 200 that parses to zero dimensions or zero dataflows is reported as a loud upstream_parse: error, never as a silent empty result.

Tools

• sdmx_dataflow_structure — Get the structure of one dataflow from any SDMX 2.1 registry: its ordered dimensions and, for each, the valid codes with labels. This answers “what do the codes in dataflow X mean” and “what key do I
• sdmx_codelist — Fetch one codelist’s code->label mapping by id, from any SDMX 2.1 registry, without needing a dataflow. Use this when you already know a codelist id (e.g. from sdmx_dataflow_structure’s codelist fie
• sdmx_find_dataflow — Keyword-search a registry’s full dataflow catalogue by id or name substring. Use this to find the dataflow id to pass to sdmx_dataflow_structure when you only know a topic. Example: sdmx_find_dataflow