fetch_dataset
Pack: bis · Endpoint: https://gateway.pipeworx.io/bis/mcp
Fetch tidy rows from a BIS dataflow. flow_ref examples: “BIS,WS_CBPOL_D,1.0” (daily policy rates). The key string is a dot-separated dimension filter (e.g., “D.US” — frequency.country). Use start_period / end_period like “2020”, “2020-Q1”, “2020-01”.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
flow_ref | string | yes | SDMX dataflow reference |
key | string | no | Dot-separated dimension key (empty for all) |
start_period | string | no | Inclusive start |
end_period | string | no | Inclusive end |
limit | number | no | Cap rows (default 5000) |
Example call
curl -X POST https://gateway.pipeworx.io/bis/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fetch_dataset","arguments":{}}}'Response shape
Always returns: flow_ref, source_url, columns, truncated, count, rows
| Field | Type | Description |
|---|---|---|
flow_ref | string | SDMX dataflow reference used |
source_url | string | BIS web URL for this dataflow |
columns | array | Column headers from CSV |
truncated | boolean | Whether result was truncated by limit |
count | number | Number of data rows returned |
rows | array | Tidy data rows as key-value objects |
Full JSON Schema
{
"type": "object",
"properties": {
"flow_ref": {
"type": "string",
"description": "SDMX dataflow reference used"
},
"source_url": {
"type": "string",
"description": "BIS web URL for this dataflow"
},
"columns": {
"type": "array",
"items": {
"type": "string"
},
"description": "Column headers from CSV"
},
"truncated": {
"type": "boolean",
"description": "Whether result was truncated by limit"
},
"count": {
"type": "number",
"description": "Number of data rows returned"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {
"type": "string"
},
"description": "Map of column name to value"
},
"description": "Tidy data rows as key-value objects"
}
},
"required": [
"flow_ref",
"source_url",
"columns",
"truncated",
"count",
"rows"
]
}Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"bis": {
"url": "https://gateway.pipeworx.io/bis/mcp"
}
}
}See Getting Started for client-specific install steps.