get_data
Pack: imf · Endpoint: https://gateway.pipeworx.io/imf/mcp
Fetch IMF time-series data for an indicator and country. Uses SDMX CompactData format. Example: get_data({ database_id: “IFS”, frequency: “A”, indicator: “NGDP_XDC”, country: “US”, start: “2018”, end: “2023” }) returns annual nominal GDP for the US.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
database_id | string | yes | IMF database ID, e.g. “IFS”, “BOP”, “DOT”, “WEO” |
frequency | string | yes | Data frequency: “A” (annual), “Q” (quarterly), “M” (monthly) |
indicator | string | yes | Indicator code, e.g. “NGDP_XDC” for nominal GDP. Use search_indicators to find codes. |
country | string | no | ISO 2-letter country code, e.g. “US”, “GB”, “JP”. Omit for all countries. |
start | string | no | Start period, e.g. “2018” or “2018-Q1” or “2018-01” |
end | string | no | End period, e.g. “2023” or “2023-Q4” or “2023-12” |
Example call
Arguments
{
"database_id": "IFS",
"frequency": "A",
"indicator": "NGDP_XDC",
"country": "US",
"start": "2018",
"end": "2023"
}
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":{"database_id":"IFS","frequency":"A","indicator":"NGDP_XDC","country":"US","start":"2018","end":"2023"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('get_data', {
"database_id": "IFS",
"frequency": "A",
"indicator": "NGDP_XDC",
"country": "US",
"start": "2018",
"end": "2023"
});
More examples
{
"database_id": "WEO",
"frequency": "A",
"indicator": "NGDPD",
"start": "2020",
"end": "2024"
}
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.