oecd_describe_flow

Pack: oecd · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/oecd_describe_flow for the schema, then POST the same URL with its arguments for the data.

Show the dimensions of an OECD dataflow in key order, and (when you pass dimension) the codes of one dimension, optionally filtered by search text (e.g. dimension “REF_AREA”, search “korea”). Use this to learn the codes before oecd_query. Reads the live published structure.

Parameters

NameTypeRequiredDescription
flow_refstringyesSDMX dataflow reference from list_curated_flows or search_dataflows
dimensionstringnoDimension id to list codes for, e.g. REF_AREA, MEASURE, SECTOR
searchstringnoCase-insensitive text matched against code ids and names
limitnumbernoMax codes returned (default 50, max 200)

Example call

Arguments

{
  "flow_ref": "OECD.SDD.TPS,DSD_IMTS@DF_IMTS,1.0"
}

curl

curl -X POST https://gateway.pipeworx.io/oecd/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"oecd_describe_flow","arguments":{"flow_ref":"OECD.SDD.TPS,DSD_IMTS@DF_IMTS,1.0"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('oecd_describe_flow', {
  "flow_ref": "OECD.SDD.TPS,DSD_IMTS@DF_IMTS,1.0"
});

More examples

{
  "flow_ref": "OECD.SDD.TPS,DSD_IMTS@DF_IMTS,1.0",
  "dimension": "REF_AREA",
  "search": "g20"
}

Response shape

FieldTypeDescription
flow_refstring
dimensionsarray
time_dimensionstring | null
key_templatestring
dimensionstring
positionnumber
total_matchednumber
returnednumber
codesarray
errorstring
messagestring
notestring
Full JSON Schema
{
  "type": "object",
  "additionalProperties": true,
  "properties": {
    "flow_ref": {
      "type": "string"
    },
    "dimensions": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "time_dimension": {
      "type": [
        "string",
        "null"
      ]
    },
    "key_template": {
      "type": "string"
    },
    "dimension": {
      "type": "string"
    },
    "position": {
      "type": "number"
    },
    "total_matched": {
      "type": "number"
    },
    "returned": {
      "type": "number"
    },
    "codes": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "error": {
      "type": "string"
    },
    "message": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  }
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}
Connect to just the oecd pack
{
  "mcpServers": {
    "oecd": {
      "url": "https://gateway.pipeworx.io/oecd/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build November 21, 2026