`find_series`

Pack: dbnomics · 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/find_series for the schema, then POST the same URL with its arguments for the data.

Browse series with structured filters. Useful when you know the provider+dataset and want to enumerate series by dimensions. If a filter matches nothing, the response lists the dimension codes the dataset actually accepts.

Parameters

Name	Type	Required	Description
`provider`	string	yes	Provider code
`dataset`	string	yes	Dataset code
`dimensions`	object	no	Optional dimension filter map. A value may be one code or a list of codes to OR together, e.g. {“FREQ”:“M”} or {“FREQ”:[“M”,“Q”],“CURRENCY”:[“USD”,“GBP”]}.
`additionalProperties`	string	no
`items`	string	no
`limit`	number	no	1-1000 (default 100)
`offset`	number	no	0-based offset
`observations`	boolean	no	Include observations (default false to save bandwidth)

Example call

Arguments

{
  "provider": "ECB",
  "dataset": "EXR",
  "dimensions": {
    "FREQ": "M"
  }
}

curl

curl -X POST https://gateway.pipeworx.io/dbnomics/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_series","arguments":{"provider":"ECB","dataset":"EXR","dimensions":{"FREQ":"M"}}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('find_series', {
  "provider": "ECB",
  "dataset": "EXR",
  "dimensions": {
    "FREQ": "M"
  }
});

More examples

{
  "provider": "EUROSTAT",
  "dataset": "une_rt_a",
  "dimensions": {
    "geo": "DE",
    "sex": "T"
  },
  "limit": 3
}

Response shape

Field	Type	Description
`series`	object	Series matching dimension filters
`limit`	number	Limit applied
`offset`	number	Offset applied
`total_count`	number	Total series count

Full JSON Schema

{
  "type": "object",
  "properties": {
    "series": {
      "description": "Series matching dimension filters",
      "type": "object",
      "properties": {
        "docs": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "dataset_code": {
                "type": "string"
              },
              "dataset_name": {
                "type": "string"
              },
              "dimensions": {
                "type": "object",
                "properties": {
                  "CURRENCY": {
                    "type": "string"
                  },
                  "CURRENCY_DENOM": {
                    "type": "string"
                  },
                  "EXR_SUFFIX": {
                    "type": "string"
                  },
                  "EXR_TYPE": {
                    "type": "string"
                  },
                  "FREQ": {
                    "type": "string"
                  }
                }
              },
              "indexed_at": {
                "type": "string"
              },
              "provider_code": {
                "type": "string"
              },
              "series_code": {
                "type": "string"
              },
              "series_name": {
                "type": "string"
              }
            }
          }
        },
        "limit": {
          "type": "number"
        },
        "num_found": {
          "type": "number"
        },
        "offset": {
          "type": "number"
        }
      }
    },
    "limit": {
      "type": "number",
      "description": "Limit applied"
    },
    "offset": {
      "type": "number",
      "description": "Offset applied"
    },
    "total_count": {
      "type": "number",
      "description": "Total series count"
    }
  }
}

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 dbnomics pack

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

See Getting Started for client-specific install steps.

find_series