{"openapi":"3.1.0","info":{"title":"Econ API","version":"0.1.0","description":"IMF WEO snapshots, indicators, rankings and comparisons; World Bank indicators; Eurostat; open-data portal search; BLS labour statistics.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://econ.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/econ/docs"},"termsOfService":"https://connectorbay.com/econ/terms"},"servers":[{"url":"https://econ.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/econ/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/country_snapshot":{"post":{"operationId":"country_snapshot","summary":"A country's macro picture from the IMF WEO: real GDP growth, inflation, unemployment, GDP (USD bn), GDP per","description":"A country's macro picture from the IMF WEO: real GDP growth, inflation, unemployment, GDP (USD bn), GDP per\n    capita (USD and PPP), government debt and balance (% GDP), current account (% GDP), population — for recent years\n    and projections. Use for \"how is Brazil's economy doing\", \"India GDP growth and inflation\", \"Japan's debt\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"Country name or ISO3 code.","examples":["India","USA","Germany","euro area"],"title":"Country","type":"string"},"year_from":{"anyOf":[{"maximum":2035,"minimum":1980,"type":"integer"},{"type":"null"}],"default":null,"description":"First year (default recent years).","title":"Year From"},"year_to":{"anyOf":[{"maximum":2035,"minimum":1980,"type":"integer"},{"type":"null"}],"default":null,"description":"Last year (default two years ahead).","title":"Year To"}},"required":["country"],"title":"country_snapshotArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/imf_indicator":{"post":{"operationId":"imf_indicator","summary":"One IMF WEO indicator for several countries over a year range (default recent years plus two projected). Use","description":"One IMF WEO indicator for several countries over a year range (default recent years plus two projected). Use\n    for \"inflation in Turkey vs Argentina since 2020\", \"GDP growth of the BRICS\", \"unemployment in Spain and Greece\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"indicator":{"description":"Indicator name or WEO code.","examples":["gdp growth","inflation","unemployment","gdp per capita","government debt","NGDP_RPCH"],"title":"Indicator","type":"string"},"countries":{"description":"Country names or ISO3 codes (1–10).","examples":[["India","China","USA"]],"items":{"type":"string"},"title":"Countries","type":"array"},"year_from":{"anyOf":[{"maximum":2035,"minimum":1980,"type":"integer"},{"type":"null"}],"default":null,"title":"Year From"},"year_to":{"anyOf":[{"maximum":2035,"minimum":1980,"type":"integer"},{"type":"null"}],"default":null,"title":"Year To"}},"required":["indicator","countries"],"title":"imf_indicatorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/imf_ranking":{"post":{"operationId":"imf_ranking","summary":"Rank the world's economies on an IMF indicator for a year — highest or lowest — optionally only countries above","description":"Rank the world's economies on an IMF indicator for a year — highest or lowest — optionally only countries above\n    a population size. Use for \"richest countries per capita\", \"fastest-growing economies in 2026\", \"which countries\n    have the highest inflation\", \"most indebted governments\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"indicator":{"description":"Indicator name or WEO code.","examples":["gdp per capita","gdp growth","inflation","government debt"],"title":"Indicator","type":"string"},"year":{"anyOf":[{"maximum":2035,"minimum":1980,"type":"integer"},{"type":"null"}],"default":null,"description":"Year (default current year).","title":"Year"},"top":{"default":15,"description":"How many to list.","maximum":60,"minimum":1,"title":"Top","type":"integer"},"lowest":{"default":false,"description":"Rank ascending instead (lowest first).","title":"Lowest","type":"boolean"},"min_population_m":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Only economies with at least this many million people.","title":"Min Population M"}},"required":["indicator"],"title":"imf_rankingArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/compare_countries":{"post":{"operationId":"compare_countries","summary":"Side-by-side IMF snapshot of several countries for one year: GDP, GDP per capita, growth, inflation,","description":"Side-by-side IMF snapshot of several countries for one year: GDP, GDP per capita, growth, inflation,\n    unemployment, debt, current account, population. Use for \"compare India and China\", \"Nordic economies side by side\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"countries":{"description":"2–8 countries.","examples":[["India","China","Indonesia"]],"items":{"type":"string"},"title":"Countries","type":"array"},"year":{"anyOf":[{"maximum":2035,"minimum":1980,"type":"integer"},{"type":"null"}],"default":null,"title":"Year"}},"required":["countries"],"title":"compare_countriesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/world_bank":{"post":{"operationId":"world_bank","summary":"A World Bank development indicator for countries over recent years — health, education, environment,","description":"A World Bank development indicator for countries over recent years — health, education, environment,\n    technology, poverty, trade and more (400+ named indicators; codes accepted). Use for \"life expectancy in\n    Nigeria over time\", \"internet penetration in India vs Brazil\", \"CO2 per capita in Qatar\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"indicator":{"description":"Indicator name or WDI code.","examples":["life expectancy","internet users","co2 emissions per capita","gini","SP.POP.TOTL"],"title":"Indicator","type":"string"},"countries":{"description":"Country names or ISO3 codes (1–10).","examples":[["Nigeria","Kenya"]],"items":{"type":"string"},"title":"Countries","type":"array"},"years":{"default":6,"description":"Most recent N years.","maximum":30,"minimum":1,"title":"Years","type":"integer"}},"required":["indicator","countries"],"title":"world_bankArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/eurostat":{"post":{"operationId":"eurostat","summary":"Official EU statistics from Eurostat for countries, the euro area or the EU: monthly unemployment and HICP","description":"Official EU statistics from Eurostat for countries, the euro area or the EU: monthly unemployment and HICP\n    inflation, quarterly GDP growth and house prices, annual population and government debt, minimum wages,\n    household electricity prices. Use for \"euro area inflation\", \"Spain youth unemployment\", \"German house prices\",\n    \"minimum wage in Poland\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"indicator":{"description":"unemployment | youth unemployment | inflation | core inflation | gdp growth | gdp growth quarterly | house prices | population | government debt | minimum wage | electricity prices","title":"Indicator","type":"string"},"countries":{"description":"EU/EEA countries, 'euro area' or 'EU' (1–10).","examples":[["Germany","France","euro area"]],"items":{"type":"string"},"title":"Countries","type":"array"},"periods":{"default":6,"description":"Most recent N periods.","maximum":24,"minimum":1,"title":"Periods","type":"integer"}},"required":["indicator","countries"],"title":"eurostatArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/datasets_search":{"post":{"operationId":"datasets_search","summary":"Find open government datasets on data.gov.uk or the EU open-data portal: title, publisher, description,","description":"Find open government datasets on data.gov.uk or the EU open-data portal: title, publisher, description,\n    formats, last update and link. Use for \"UK datasets on air quality\", \"EU open data on renewable energy\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Topic words.","examples":["air quality","road accidents","school performance"],"title":"Query","type":"string"},"portal":{"default":"uk","description":"uk (data.gov.uk) | eu (data.europa.eu)","title":"Portal","type":"string"},"max_results":{"default":8,"maximum":20,"minimum":1,"title":"Max Results","type":"integer"}},"required":["query"],"title":"datasets_searchArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/dataset":{"post":{"operationId":"dataset","summary":"Details of a data.gov.uk dataset: description, publisher, licence, tags and downloadable resources with","description":"Details of a data.gov.uk dataset: description, publisher, licence, tags and downloadable resources with\n    formats and URLs. Use after datasets_search.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dataset_id":{"description":"data.gov.uk dataset id (from datasets_search).","examples":["road-accidents-safety-data"],"title":"Dataset Id","type":"string"}},"required":["dataset_id"],"title":"datasetArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/us_labor_stats":{"post":{"operationId":"us_labor_stats","summary":"U.S. labour and price statistics from the Bureau of Labor Statistics: monthly unemployment rate, CPI (with","description":"U.S. labour and price statistics from the Bureau of Labor Statistics: monthly unemployment rate, CPI (with\n    year-on-year inflation computed), nonfarm payrolls, hourly and weekly earnings, participation, job openings,\n    PPI, productivity. Use for \"US unemployment rate\", \"US inflation right now\", \"how many jobs were added\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"series":{"default":"unemployment rate","description":"unemployment rate | cpi | nonfarm payrolls | average hourly earnings | labor force participation | job openings | ppi | employment cost index | weekly earnings | productivity — or a BLS series id.","title":"Series","type":"string"},"years":{"default":2,"description":"Years of history.","maximum":10,"minimum":1,"title":"Years","type":"integer"}},"title":"us_labor_statsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}