Sdmx Structure MCP server

@pipeworx/sdmx-structure

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.

Part of Pipeworx — an MCP gateway connecting AI agents to 1745+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

Tools

— 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 UNERTM dataflow v1.0 points at DSD UNERTM v155.0; BIS's WSCBPOL dataflow points at a differently named DSD, BISCBPOL).

• sdmxdataflowstructure(registry, dataflow, agency?, version?, maxcodesper_dimension?)

codelist's code→label pairs by id alone, with no dataflow needed. Useful once you already know a codelist id (from sdmxdataflowstructure's codelist field, or from documentation) and just want the codes, optionally filtered by a substring.

• sdmx_codelist(registry, id, agency?, version?, filter?, limit?) — one

across a registry's dataflow catalogue by id or name, to find the id to pass to sdmxdataflowstructure.

• sdmxfinddataflow(registry, query, agency?, limit?) — keyword search

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 PLATFORMSTATSNZKEY) 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 dataflowstructure for ILO dataflows, and the abs-au pack already ships dataflowstructure for ABS dataflows — both inline codes directly, the same job sdmxdataflowstructure here does. This pack supports registry: "ilo" and registry: "abs" only for the standalone sdmxcodelist lookup (a codelist by id, no dataflow needed) that neither of those packs exposes. Prefer ilostat's / abs-au's own dataflowstructure 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

Shortened. The full README is on GitHub.