`search_dataflows`

Pack: oecd · Endpoint: https://gateway.pipeworx.io/oecd/mcp

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

Search OECD’s SDMX dataflow registry by keyword. Returns matching dataflow refs ready to pass to fetch_dataset. If results are noisy, refine with a more specific keyword or restrict by agency.

Parameters

Name	Type	Required	Description
`query`	string	yes	Keyword (matches dataflow names + descriptions)
`agency`	string	no	Optional agency filter, e.g., OECD.SDD.NAD, OECD.ECO, OECD.ENV
`limit`	number	no	Max results (default 25, max 100)

Example call

Arguments

{
  "query": "unemployment rate"
}

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":"search_dataflows","arguments":{"query":"unemployment rate"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('search_dataflows', {
  "query": "unemployment rate"
});

More examples

{
  "query": "health expenditure",
  "agency": "OECD.ELS",
  "limit": 10
}

Response shape

Always returns: total_matched, returned, dataflows

Field	Type	Description
`total_matched`	number	Total number of dataflows matching query
`returned`	number	Number of results returned (capped by limit)
`dataflows`	array	Matching dataflows

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total_matched": {
      "type": "number",
      "description": "Total number of dataflows matching query"
    },
    "returned": {
      "type": "number",
      "description": "Number of results returned (capped by limit)"
    },
    "dataflows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "flow_ref": {
            "type": "string",
            "description": "Complete SDMX dataflow reference"
          },
          "agency": {
            "type": [
              "string",
              "null"
            ],
            "description": "Agency identifier"
          },
          "id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Dataflow ID"
          },
          "version": {
            "type": [
              "string",
              "null"
            ],
            "description": "Dataflow version"
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Dataflow name"
          }
        },
        "required": [
          "flow_ref",
          "agency",
          "id",
          "version",
          "name"
        ]
      },
      "description": "Matching dataflows"
    }
  },
  "required": [
    "total_matched",
    "returned",
    "dataflows"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "oecd": {
      "url": "https://gateway.pipeworx.io/oecd/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_dataflows