@pipeworx/imf
Connect: https://gateway.pipeworx.io/imf/mcp · Install: one-click buttons
Tools: 3
The International Monetary Fund’s macro database. Country-level GDP, inflation, current account, fiscal balance, exchange rates, debt, employment, demographics — across 190+ member countries. The standard cross-country macro source. Free, no auth.
Why this matters for AI agents
For cross-country macro analysis, the IMF’s databases (WEO — World Economic Outlook; IFS — International Financial Statistics; BOP — Balance of Payments) are the canonical source. Where FRED is US-focused, IMF is global and harmonized. Where World Bank focuses on development, IMF focuses on macro/fiscal/financial.
Common flows:
- Country macro snapshot. GDP, inflation, current account for a given country.
- Cross-country comparison. Pull the same indicator across multiple countries to compare.
- Time-series analysis. Historical data for trend analysis.
Used by the trade_country_profile compound and pairs well with Comtrade (trade flows) and BLS (US labor).
Auth
None. IMF Data API is fully public, free.
Major databases
| Database | Coverage | Use |
|---|---|---|
| WEO (World Economic Outlook) | Annual & semi-annual | GDP, inflation, fiscal, current account forecasts |
| IFS (International Financial Statistics) | Monthly/quarterly | Money, banking, prices, government finance |
| BOP (Balance of Payments) | Quarterly | Current/capital/financial accounts |
| DOTS (Direction of Trade) | Monthly | Bilateral trade (mirror to Comtrade) |
| GFS (Government Finance Statistics) | Annual | Government revenue, expenditure, debt |
Common pitfalls
- Country code variants. IMF uses ISO 3-letter codes (USA, GBR, DEU). Comtrade uses 3-digit numeric. Census uses 2-letter. Cross-source linking needs translation.
- WEO publishes twice yearly. April and October. Forecasts can shift dramatically between releases — always cite the vintage (e.g., “WEO October 2024”).
- Exchange-rate definitions vary. Period average vs. end-of-period vs. PPP vs. real effective. IMF data has all four; specify which.
- Coverage gaps. Small economies and politically isolated countries (North Korea, Venezuela, Eritrea) have spotty data. The IMF API returns nulls; don’t treat null as zero.
- Real vs. nominal. Default GDP is nominal in current-USD. For comparisons over time or across rapid-inflation economies, you usually want real (inflation-adjusted, in constant prices) or PPP-adjusted.
- Lag. Annual data published with 6–18 month lag depending on country reporting. Quarterly data faster, ~2–3 month lag for major economies.
Tools
- get_datasets — List or search the IMF’s datasets — CPI, WEO (World Economic Outlook), BOP (Balance of Payments), IMTS (trade in goods), GFS (government finance), MFS (monetary and financial), FSI (financial soundnes
- get_data — Fetch an IMF time series. Identify the series by dataset plus a
dimensionsmap of named codes, e.g. get_data({dataset:“CPI”, dimensions:{COUNTRY:“USA”, INDEX_TYPE:“CPI”, COICOP_1999:“_T”, TYPE_OF_TR - search_indicators — Discover what a dataset accepts: its dimension names in key order, and the codes available for each, filtered by
query. Use this before get_data — e.g. search_indicators({dataset:“CPI”, query:“unite
Tools
-
get_data— 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_TR -
get_datasets— List or search the IMF's datasets — CPI, WEO (World Economic Outlook), BOP (Balance of Payments), IMTS (trade in goods), GFS (government finance), MFS (monetary and financial), FSI (financial soundnes -
search_indicators— Discover what a dataset accepts: its dimension names in key order, and the codes available for each, filtered by `query`. Use this before get_data — e.g. search_indicators({dataset: CPI , query: unite