`get_data`

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

Fetch an IMF time series. Identify the series by dataset plus a dimensions map of named codes, e.g. get_data({dataset:“CPI”, dimensions:{COUNTRY:“USA”, INDEX_TYPE:“CPI”, COICOP_1999:“_T”, TYPE_OF_TRANSFORMATION:“IX”, FREQUENCY:“M”}, start:“2024-01”}). Dimension names and order differ per dataset — use search_indicators to see what a dataset accepts. Any dimension you omit is left open, returning every code for it. Returns observations as {period, value} plus the dimension values of each series.

Parameters

Name	Type	Required	Description
`dataset`	string	yes	Dataset id from get_datasets, e.g. “CPI”, “WEO”, “BOP”, “IMTS”.
`dimensions`	object	no	Map of dimension code to value, e.g. {“COUNTRY”:“USA”,“FREQUENCY”:“M”}. A value may be a list to OR codes together: {“COUNTRY”:[“USA”,“GBR”]}. Omitted dimensions match everything. Use search_indicators to discover valid names and codes.
`together`	unknown	no
`additionalProperties`	string	no
`items`	string	no
`start`	string	no	Start period, e.g. “2020”, “2024-01”, “2024-Q1”.
`end`	string	no	End period, e.g. “2025”, “2024-12”, “2024-Q4”.
`limit`	number	no	Max series to return, 1-100 (default 20).

Example call

Arguments

{
  "dataset": "CPI",
  "dimensions": {
    "COUNTRY": "USA",
    "INDEX_TYPE": "CPI",
    "COICOP_1999": "_T",
    "TYPE_OF_TRANSFORMATION": "IX",
    "FREQUENCY": "M"
  },
  "start": "2024-01",
  "end": "2024-04"
}

curl

curl -X POST https://gateway.pipeworx.io/imf/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_data","arguments":{"dataset":"CPI","dimensions":{"COUNTRY":"USA","INDEX_TYPE":"CPI","COICOP_1999":"_T","TYPE_OF_TRANSFORMATION":"IX","FREQUENCY":"M"},"start":"2024-01","end":"2024-04"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_data', {
  "dataset": "CPI",
  "dimensions": {
    "COUNTRY": "USA",
    "INDEX_TYPE": "CPI",
    "COICOP_1999": "_T",
    "TYPE_OF_TRANSFORMATION": "IX",
    "FREQUENCY": "M"
  },
  "start": "2024-01",
  "end": "2024-04"
});

More examples

{
  "dataset": "CPI",
  "dimensions": {
    "COUNTRY": "USA",
    "FREQUENCY": "M"
  },
  "start": "2024-01",
  "end": "2024-02",
  "limit": 20
}

Response shape

Full JSON Schema

{
  "type": "object",
  "description": "IMF SDMX CompactData response with time-series observations"
}

Connect

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

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

See Getting Started for client-specific install steps.

get_data