{"openapi":"3.1.0","info":{"title":"imf-datamapper-series","version":"0.1.0","description":"Returns one IMF DataMapper indicator (e.g. NGDP_RPCH real GDP growth) for one or more countries, optionally limited to a year range. Output has unit, per-country series of {year, value, forecast_flag}, and a top-level forecast_flag. A point is a forecast when year >= the current UTC year.; Searches the IMF DataMapper indicator catalog by keyword over code, label and description (e.g. inflation, debt, unemployment). Returns indicator code, label, unit, dataset and description to pass to get_series. Empty query lists the first matches.","x-guidance":"IMF DataMapper Series returns IMF World Economic Outlook and related indicator series by country. `search_indicators` finds indicator codes by keyword (GDP growth, inflation, debt). `get_series` returns one indicator for one or many countries with an optional year range, units and a forecast flag on every point. Live passthrough of the free IMF DataMapper API (cite IMF), deterministic, no LLM. Every response carries `source` URLs and `asOf`. Tools: `get_series`, `search_indicators`.","contact":{"email":"jeff@fosterinstruments.com"}},"servers":[{"url":"https://imf-datamapper-series.x402supply.com"}],"paths":{"/mcp":{"post":{"operationId":"imf-datamapper-series_call","summary":"Call imf-datamapper-series via MCP tools/call","tags":["imf-datamapper-series"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method","params"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"method":{"const":"tools/call"},"params":{"type":"object","required":["name","arguments"],"properties":{"name":{"const":"get_series"},"arguments":{"type":"object","properties":{"indicator":{"type":"string","minLength":1,"maxLength":40,"pattern":"^[A-Za-z0-9_.]+$","description":"IMF indicator code, e.g. NGDP_RPCH. Find codes with search_indicators"},"countries":{"type":"string","minLength":2,"maxLength":200,"description":"Comma-separated IMF country codes (ISO alpha-3), e.g. USA,DEU,JPN. Up to 20"},"startYear":{"type":"integer","minimum":1980,"maximum":2100,"description":"First year to include"},"endYear":{"type":"integer","minimum":1980,"maximum":2100,"description":"Last year to include"}},"required":["indicator","countries"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},{"type":"object","required":["jsonrpc","id","method","params"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"method":{"const":"tools/call"},"params":{"type":"object","required":["name","arguments"],"properties":{"name":{"const":"search_indicators"},"arguments":{"type":"object","properties":{"query":{"type":"string","maxLength":100,"description":"Keyword(s); all words must match. Empty lists indicators"},"dataset":{"type":"string","maxLength":20,"pattern":"^[A-Za-z0-9_]*$","description":"Optional dataset code filter, e.g. WEO"},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Maximum indicators to return, 1-100","default":20}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}}]}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"JSON-RPC 2.0 response envelope. `result.content[0].text` is a JSON-encoded string matching the schema in `x-mcp-result-schema`.","properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"result":{"type":"object","properties":{"content":{"type":"array","items":{"type":"object","properties":{"type":{"const":"text"},"text":{"type":"string"}}}}}}},"x-mcp-result-schema":{"type":"object","required":["indicator","label","unit","forecast_from_year","forecast_flag","series","missingCountries","source","asOf"],"properties":{"indicator":{"type":"string"},"label":{"type":"string"},"unit":{"type":["string","null"]},"dataset":{"type":["string","null"]},"publication":{"type":["string","null"]},"forecast_from_year":{"type":"integer"},"forecast_flag":{"type":"boolean"},"series":{"type":"array","items":{"type":"object","required":["country","name","points"],"properties":{"country":{"type":"string"},"name":{"type":["string","null"]},"points":{"type":"array","items":{"type":"object","required":["year","value","forecast_flag"],"properties":{"year":{"type":"integer"},"value":{"type":"number"},"forecast_flag":{"type":"boolean"}}}}}}},"missingCountries":{"type":"array","items":{"type":"string"}},"source":{"type":"array","items":{"type":"string"}},"asOf":{"type":"string"}}}},{"type":"object","description":"JSON-RPC 2.0 response envelope. `result.content[0].text` is a JSON-encoded string matching the schema in `x-mcp-result-schema`.","properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"result":{"type":"object","properties":{"content":{"type":"array","items":{"type":"object","properties":{"type":{"const":"text"},"text":{"type":"string"}}}}}}},"x-mcp-result-schema":{"type":"object","required":["query","count","indicators","source","asOf"],"properties":{"query":{"type":"string"},"count":{"type":"integer"},"totalMatches":{"type":"integer"},"indicators":{"type":"array","items":{"type":"object","required":["indicator","label","unit","dataset"],"properties":{"indicator":{"type":"string"},"label":{"type":"string"},"unit":{"type":["string","null"]},"dataset":{"type":["string","null"]},"description":{"type":["string","null"]}}}},"source":{"type":"array","items":{"type":"string"}},"asOf":{"type":"string"}}}}]}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]}}},"/tools/get_series":{"post":{"operationId":"imf-datamapper-series_get_series_http","summary":"Returns one IMF DataMapper indicator (e.g. NGDP_RPCH real GDP growth) for one or more countries, optionally limited to a year range. Output has unit, per-country series of {year, value, forecast_flag}, and a top-level forecast_flag. A point is a forecast when year >= the current UTC year.","tags":["imf-datamapper-series"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"indicator":{"type":"string","minLength":1,"maxLength":40,"pattern":"^[A-Za-z0-9_.]+$","description":"IMF indicator code, e.g. NGDP_RPCH. Find codes with search_indicators"},"countries":{"type":"string","minLength":2,"maxLength":200,"description":"Comma-separated IMF country codes (ISO alpha-3), e.g. USA,DEU,JPN. Up to 20"},"startYear":{"type":"integer","minimum":1980,"maximum":2100,"description":"First year to include"},"endYear":{"type":"integer","minimum":1980,"maximum":2100,"description":"Last year to include"}},"required":["indicator","countries"],"additionalProperties":false},"example":{"indicator":"NGDP_RPCH","countries":"USA","startYear":2024,"endYear":2026}}}},"responses":{"200":{"description":"Tool result (plain JSON, not MCP-wrapped)","content":{"application/json":{"schema":{"type":"object","required":["indicator","label","unit","forecast_from_year","forecast_flag","series","missingCountries","source","asOf"],"properties":{"indicator":{"type":"string"},"label":{"type":"string"},"unit":{"type":["string","null"]},"dataset":{"type":["string","null"]},"publication":{"type":["string","null"]},"forecast_from_year":{"type":"integer"},"forecast_flag":{"type":"boolean"},"series":{"type":"array","items":{"type":"object","required":["country","name","points"],"properties":{"country":{"type":"string"},"name":{"type":["string","null"]},"points":{"type":"array","items":{"type":"object","required":["year","value","forecast_flag"],"properties":{"year":{"type":"integer"},"value":{"type":"number"},"forecast_flag":{"type":"boolean"}}}}}}},"missingCountries":{"type":"array","items":{"type":"string"}},"source":{"type":"array","items":{"type":"string"}},"asOf":{"type":"string"}}},"example":{"indicator":"NGDP_RPCH","label":"Real GDP growth","unit":"Annual percent change","dataset":"WEO","publication":"World Economic Outlook (October 2026)","forecast_from_year":2026,"forecast_flag":true,"series":[{"country":"USA","name":"United States","points":[{"year":2024,"value":3,"forecast_flag":false},{"year":2025,"value":2.3,"forecast_flag":false},{"year":2026,"value":2.3,"forecast_flag":true}]}],"missingCountries":[],"source":["https://www.imf.org/external/datamapper/api/v1/NGDP_RPCH","https://www.imf.org/external/datamapper/api/v1/indicators"],"asOf":"2026-10-08 14:43:32"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]}}},"/tools/search_indicators":{"post":{"operationId":"imf-datamapper-series_search_indicators_http","summary":"Searches the IMF DataMapper indicator catalog by keyword over code, label and description (e.g. inflation, debt, unemployment). Returns indicator code, label, unit, dataset and description to pass to get_series. Empty query lists the first matches.","tags":["imf-datamapper-series"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","maxLength":100,"description":"Keyword(s); all words must match. Empty lists indicators"},"dataset":{"type":"string","maxLength":20,"pattern":"^[A-Za-z0-9_]*$","description":"Optional dataset code filter, e.g. WEO"},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Maximum indicators to return, 1-100","default":20}},"additionalProperties":false},"example":{"query":"gdp growth","limit":1}}}},"responses":{"200":{"description":"Tool result (plain JSON, not MCP-wrapped)","content":{"application/json":{"schema":{"type":"object","required":["query","count","indicators","source","asOf"],"properties":{"query":{"type":"string"},"count":{"type":"integer"},"totalMatches":{"type":"integer"},"indicators":{"type":"array","items":{"type":"object","required":["indicator","label","unit","dataset"],"properties":{"indicator":{"type":"string"},"label":{"type":"string"},"unit":{"type":["string","null"]},"dataset":{"type":["string","null"]},"description":{"type":["string","null"]}}}},"source":{"type":"array","items":{"type":"string"}},"asOf":{"type":"string"}}},"example":{"query":"gdp growth","count":1,"totalMatches":5,"indicators":[{"indicator":"NGDP_RPCH","label":"Real GDP growth","unit":"Annual percent change","dataset":"WEO","description":"Gross domestic product is the most commonly used single measure of a country's overall economic activity. It represents the total value at constant prices of final goods and services produced within a country during a specified time period, such as one year."}],"source":["https://www.imf.org/external/datamapper/api/v1/indicators"],"asOf":"2026-10-14 12:43:10"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]}}}}}