imf_query_dataset
Query a dataflow by dimension key over a time range; large result sets spill to DataCanvas
How to use it
Project documentation lists imf_query_dataset for the Imf MCP Server MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), then check which tools your installed version makes available. Tool availability can depend on configuration and credentials. A server handshake does not verify this tool’s behavior. See the full listing for setup details.
Install Imf MCP Server
docker run --rm -p 3010:3010 imf-mcp-serverOther tools in Imf MCP Server (8)
List DataCanvas tables and columns staged by a prior imfquerydataset call
Run a read-only SQL SELECT across staged DataCanvas tables for multi-country comparisons and aggregations
Fetch a dataflow's dimension list and a codelist preview per dimension — resolves human terms to SDMX codes before querying
List IMF SDMX dataflows available on the portal, a page at a time, with optional name/ID substring filtering
field shows the exact dot-separated dimension order required by imfquerydataset
errors include availability context from the upstream constraint endpoint: a dataflow that publishes no series at all is reported as such and points at a different dataflow, since no key would work; otherwise seriescount=0 means the code has no coverage and dataflowavailability names codes that do,
/ endperiod accept YYYY, YYYY-SN, YYYY-QN, YYYY-MM, or YYYY-MM-DD whatever the series frequency, and cover the whole period they name — endperiod: 2023 includes 2023-M12 and 2023-Q4
is the upstream code — PT, USD, XDC, IX, NUM. Every key shape reports the same unit: the portal drops the unit block when a key uses + on the dimension that carries it, and one extra attributes-only request recovers it, so USA.NGDPRPCH+NGDPD.A and USA.NGDPRPCH+NGDPD. both report USD and PT. That key