{"openapi":"3.0.3","info":{"title":"Gnist Context — IMF","description":"International Monetary Fund datasets — global economic indicators and financial statistics.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/imf/`\n- **Toolkit page:** `/toolkits/imf`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/imf/list_weo_indicators":{"post":{"tags":["Economics"],"summary":"list_weo_indicators","description":"List all available World Economic Outlook indicators from the IMF.\n\nThe WEO covers macroeconomic variables across 196 countries with\nhistorical data and 5-year forecasts, updated twice per year (April\nand October). Use this to discover indicator codes before calling\nget_weo_forecast() with specific indicators.\n\nReturns:\n    count and list of indicators with code, label, description, unit, source, dataset.","operationId":"imf_list_weo_indicators","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}]}},"/rest/imf/get_weo_forecast":{"post":{"tags":["Economics"],"summary":"get_weo_forecast","description":"Get World Economic Outlook forecasts and historical data for a country.\n\nBy default returns 6 headline macro indicators: real GDP growth, inflation,\nunemployment, current account balance, government debt, and fiscal balance.\n\nCountry codes use ISO alpha-3 (e.g. USA, GBR, DEU, NOR, CHN, JPN, BRA).\n\nArgs:\n    country: ISO alpha-3 country code (e.g. 'USA', 'NOR', 'DEU', 'CHN').\n    indicators: WEO indicator codes. If omitted, returns the 6 defaults.\n                Use list_weo_indicators() to discover all available codes.\n    start_year: Include observations from this year (inclusive).\n    end_year: Include observations up to this year (inclusive).\n\nReturns:\n    country, source note, and indicators list with observations (period, value).","operationId":"imf_get_weo_forecast","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"country":{"description":"ISO alpha-3 country code (e.g. 'USA', 'NOR', 'DEU', 'CHN').","type":"string"},"indicators":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"WEO indicator codes. If omitted, returns the 6 defaults. Use list_weo_indicators() to discover all available codes."},"start_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Include observations from this year (inclusive)."},"end_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Include observations up to this year (inclusive)."}},"required":["country"],"type":"object"}}}}}},"/rest/imf/get_commodity_prices":{"post":{"tags":["Economics"],"summary":"get_commodity_prices","description":"Get primary commodity price data from the IMF PCPS dataset.\n\nDefault commodities: Brent Crude Oil, Gold, Copper, Aluminum, Natural Gas (US).\n\nArgs:\n    commodities: List of PCPS commodity codes. Defaults to 5 key commodities.\n    start_period: Start period (YYYY-MM for monthly, YYYY for annual).\n    end_period: End period (YYYY-MM or YYYY).\n    frequency: 'M' for monthly (default) or 'A' for annual.\n\nReturns:\n    source, available_codes list, and series with code, name, unit, and observations.","operationId":"imf_get_commodity_prices","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"commodities":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"List of PCPS commodity codes. Defaults to 5 key commodities."},"start_period":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Start period (YYYY-MM for monthly, YYYY for annual)."},"end_period":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"End period (YYYY-MM or YYYY)."},"frequency":{"default":"M","description":"'M' for monthly (default) or 'A' for annual.","type":"string"}},"type":"object"}}}}}},"/rest/imf/get_trade_balance":{"post":{"tags":["Economics"],"summary":"get_trade_balance","description":"Get bilateral or aggregate trade statistics from the IMF DOTS dataset.\n\nUse partner='W00' (or omit) to get a country's total world trade.\nSpecify a partner code for bilateral flows.\n\nArgs:\n    reporter: ISO alpha-2 country code of the reporting country (e.g. 'US', 'DE').\n    partner: ISO alpha-2 partner code, or 'W00' for world total (default).\n    start_year: Start year (inclusive).\n    end_year: End year (inclusive).\n\nReturns:\n    reporter, partner, and series with exports, imports, and trade balance.","operationId":"imf_get_trade_balance","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"reporter":{"description":"ISO alpha-2 country code of the reporting country (e.g. 'US', 'DE').","type":"string"},"partner":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO alpha-2 partner code, or 'W00' for world total (default)."},"start_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Start year (inclusive)."},"end_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"End year (inclusive)."}},"required":["reporter"],"type":"object"}}}}}},"/rest/imf/get_country_overview":{"post":{"tags":["Economics"],"summary":"get_country_overview","description":"Get a macro snapshot for a country combining WEO headline indicators.\n\nReturns the most recent actuals and near-term IMF forecasts covering GDP growth,\ninflation, unemployment, current account, government debt, and fiscal balance.\n\nArgs:\n    country: ISO alpha-3 country code (e.g. 'USA', 'NOR', 'DEU').\n\nReturns:\n    country, source, window (year range), and indicators dict with latest values.","operationId":"imf_get_country_overview","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"country":{"description":"ISO alpha-3 country code (e.g. 'USA', 'NOR', 'DEU').","type":"string"}},"required":["country"],"type":"object"}}}}}},"/rest/imf/report_feedback":{"post":{"tags":["Economics"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"imf_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Economics","description":"Data sources: Economics"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}