{"openapi":"3.0.3","info":{"title":"Gnist Context — World Bank","description":"World Bank development indicators — poverty, health, education, and economic data by country.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/worldbank/`\n- **Toolkit page:** `/toolkits/worldbank`\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/worldbank/get_indicator":{"post":{"tags":["Economics"],"summary":"get_indicator","description":"Fetch a time series for a World Bank indicator.\n\nArgs:\n    country_code: ISO 3166-1 alpha-2 or alpha-3 country code (e.g. \"US\", \"USA\", \"NO\").\n                  Use \"WLD\" for global aggregates or \"all\" for every country.\n    indicator_code: World Bank indicator ID (e.g. \"NY.GDP.MKTP.CD\" for GDP,\n                    \"SP.POP.TOTL\" for population). Use search_indicators to find codes.\n    year_from: Start year (inclusive). If omitted, uses mrv instead.\n    year_to: End year (inclusive). If omitted, uses year_from as single year.\n    mrv: Most recent values to return (1–50, default 10). Used when year_from/year_to are not set.\n\nReturns:\n    Time series of indicator values with date, value, and country metadata.\n    Values may be null for years where data is unavailable.","operationId":"worldbank_get_indicator","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_code":{"description":"ISO 3166-1 alpha-2 or alpha-3 country code (e.g. \"US\", \"USA\", \"NO\"). Use \"WLD\" for global aggregates or \"all\" for every country.","type":"string"},"indicator_code":{"description":"World Bank indicator ID (e.g. \"NY.GDP.MKTP.CD\" for GDP, \"SP.POP.TOTL\" for population). Use search_indicators to find codes.","type":"string"},"year_from":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Start year (inclusive). If omitted, uses mrv instead."},"year_to":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"End year (inclusive). If omitted, uses year_from as single year."},"mrv":{"default":10,"description":"Most recent values to return (1–50, default 10). Used when year_from/year_to are not set.","type":"integer"}},"required":["country_code","indicator_code"],"type":"object"}}}}}},"/rest/worldbank/search_indicators":{"post":{"tags":["Economics"],"summary":"search_indicators","description":"Search the World Bank indicator catalog by keyword.\n\nCovers 1,400+ socioeconomic indicators including GDP, population, health,\neducation, trade, energy, environment, and more.\n\nArgs:\n    query: Search term (e.g. \"gdp\", \"literacy rate\", \"co2 emissions\").\n    per_page: Number of results to return (1–50, default 20).\n\nReturns:\n    List of matching indicators with ID, name, unit, and topic classification.\n    Use the indicator id field with get_indicator or compare_countries.","operationId":"worldbank_search_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":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"description":"Search term (e.g. \"gdp\", \"literacy rate\", \"co2 emissions\").","type":"string"},"per_page":{"default":20,"description":"Number of results to return (1–50, default 20).","type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/worldbank/country_profile":{"post":{"tags":["Economics"],"summary":"country_profile","description":"Get a snapshot of key development indicators for a country.\n\nCovers: GDP (total and per capita), population, life expectancy, and CO2 emissions.\nData comes from World Bank Open Data (CC-BY-4.0).\n\nArgs:\n    country_code: ISO 3166-1 alpha-2 or alpha-3 country code (e.g. \"NO\", \"USA\", \"DE\").\n    year: Specific year to retrieve. Defaults to most recent available data.\n\nReturns:\n    Country profile with GDP, population, life expectancy, and CO2 figures.\n    Any field may be null if the World Bank has no data for that country/year combination.","operationId":"worldbank_country_profile","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_code":{"description":"ISO 3166-1 alpha-2 or alpha-3 country code (e.g. \"NO\", \"USA\", \"DE\").","type":"string"},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Specific year to retrieve. Defaults to most recent available data."}},"required":["country_code"],"type":"object"}}}}}},"/rest/worldbank/compare_countries":{"post":{"tags":["Economics"],"summary":"compare_countries","description":"Compare one indicator across multiple countries for a given year.\n\nArgs:\n    indicator_code: World Bank indicator ID (e.g. \"NY.GDP.MKTP.CD\").\n                    Use search_indicators to find the right code.\n    country_codes: List of ISO 3166-1 alpha-2 or alpha-3 codes (e.g. [\"US\", \"DE\", \"JP\"]).\n                   Maximum 20 countries per request.\n    year: The year to compare (e.g. 2022).\n\nReturns:\n    Indicator values for each country in the requested year.\n    Values may be null if data is unavailable for a country/year pair.","operationId":"worldbank_compare_countries","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":{"indicator_code":{"description":"World Bank indicator ID (e.g. \"NY.GDP.MKTP.CD\"). Use search_indicators to find the right code.","type":"string"},"country_codes":{"description":"List of ISO 3166-1 alpha-2 or alpha-3 codes (e.g. [\"US\", \"DE\", \"JP\"]). Maximum 20 countries per request.","items":{"type":"string"},"type":"array"},"year":{"description":"The year to compare (e.g. 2022).","type":"integer"}},"required":["indicator_code","country_codes","year"],"type":"object"}}}}}},"/rest/worldbank/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":"worldbank_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."}}}}