{"openapi":"3.0.3","info":{"title":"Gnist Context — UN SDG","description":"UN Sustainable Development Goals — 231 indicators across 17 goals covering poverty, health, education, climate, and inequality for 193 countries.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/unsdg/`\n- **Toolkit page:** `/toolkits/unsdg`\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/unsdg/list_sdg_goals":{"post":{"tags":["Economics"],"summary":"list_sdg_goals","description":"List all 17 UN Sustainable Development Goals.\n\nReturns each goal's code (1-17), title, and description. Use the goal code\nto explore targets and indicators via get_goal_targets.\n\nExamples:\n    list_sdg_goals() → All 17 goals (poverty, hunger, health, education, etc.)","operationId":"unsdg_list_sdg_goals","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/unsdg/get_goal_targets":{"post":{"tags":["Economics"],"summary":"get_goal_targets","description":"Get targets and indicators for a specific SDG goal.\n\nReturns the goal's targets (e.g. 1.1, 1.2) with their indicators and\ndata series codes. Use series codes with get_sdg_series_data for actual values.\n\nExamples:\n    get_goal_targets(1) → Targets for 'No Poverty' (1.1 extreme poverty, 1.2 national poverty...)\n    get_goal_targets(13) → Targets for 'Climate Action'","operationId":"unsdg_get_goal_targets","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":{"goal_code":{"description":"SDG goal number (1-17). E.g. 1 = No Poverty, 13 = Climate Action.","type":"integer"}},"required":["goal_code"],"type":"object"}}}}}},"/rest/unsdg/get_sdg_indicator_data":{"post":{"tags":["Economics"],"summary":"get_sdg_indicator_data","description":"Get observation data for SDG indicators.\n\nReturns time-series data for the specified indicators, optionally filtered\nby country and time period. Each observation includes value, source,\ngeographic area, and any dimension breakdowns (age, sex, location, etc.).\n\nExamples:\n    get_sdg_indicator_data(['1.1.1'], [156], 2010, 2023) → China poverty rate 2010-2023\n    get_sdg_indicator_data(['4.1.1'], [578]) → Norway education completion data\n    get_sdg_indicator_data(['13.2.2']) → All countries' greenhouse gas emissions\n\nReturns:\n    Paginated observations with value, source, geo area, time period, and dimensions.","operationId":"unsdg_get_sdg_indicator_data","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_codes":{"description":"Indicator code(s), e.g. ['1.1.1'] for extreme poverty rate.","items":{"type":"string"},"type":"array"},"area_codes":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"default":null,"description":"Geo area code(s). E.g. [578] for Norway, [840] for USA. Use search_sdg_geo_areas to find codes."},"time_start":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Start year (e.g. 2015)."},"time_end":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"End year (e.g. 2023)."},"page":{"default":1,"description":"Page number (default 1).","type":"integer"},"page_size":{"default":50,"description":"Results per page, max 200 (default 50).","type":"integer"}},"required":["indicator_codes"],"type":"object"}}}}}},"/rest/unsdg/get_sdg_series_data":{"post":{"tags":["Economics"],"summary":"get_sdg_series_data","description":"Get observation data for specific SDG data series.\n\nMore granular than indicator data — a single indicator may have multiple series\nwith different measurement methodologies. Use get_goal_targets to discover\navailable series codes.\n\nExamples:\n    get_sdg_series_data(['SI_POV_DAY1'], [840], 2000, 2023) → US $2.15/day poverty\n    get_sdg_series_data(['EN_ATM_GHGT_AIP'], [578]) → Norway greenhouse gas index\n\nReturns:\n    Paginated observations with value, source, and disaggregation dimensions.","operationId":"unsdg_get_sdg_series_data","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":{"series_codes":{"description":"Series code(s), e.g. ['SI_POV_DAY1'] for poverty rate.","items":{"type":"string"},"type":"array"},"area_codes":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"default":null,"description":"Geo area code(s). E.g. [578] for Norway."},"time_start":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Start year."},"time_end":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"End year."},"page":{"default":1,"description":"Page number.","type":"integer"},"page_size":{"default":50,"description":"Results per page, max 200.","type":"integer"}},"required":["series_codes"],"type":"object"}}}}}},"/rest/unsdg/search_sdg_geo_areas":{"post":{"tags":["Economics"],"summary":"search_sdg_geo_areas","description":"Search for SDG geo area codes by name.\n\nReturns matching country and region codes that can be used with the\nindicator and series data tools.\n\nExamples:\n    search_sdg_geo_areas('Norway') → [{'code': '578', 'name': 'Norway'}]\n    search_sdg_geo_areas('Africa') → All African regions and sub-regions","operationId":"unsdg_search_sdg_geo_areas","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 for country or region name (e.g. 'Norway', 'Africa').","type":"string"}},"required":["query"],"type":"object"}}}}}},"/rest/unsdg/get_sdg_series_dimensions":{"post":{"tags":["Economics"],"summary":"get_sdg_series_dimensions","description":"Get available dimensions (disaggregations) for a data series.\n\nShows what breakdowns are available — age groups, sex, location type,\nreporting type, etc. Useful for understanding what granularity exists\nbefore querying data.\n\nExamples:\n    get_sdg_series_dimensions('SI_POV_DAY1') → Age, Sex, Reporting Type dimensions","operationId":"unsdg_get_sdg_series_dimensions","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":{"series_code":{"description":"Series code, e.g. 'SI_POV_DAY1'.","type":"string"}},"required":["series_code"],"type":"object"}}}}}},"/rest/unsdg/get_sdg_data_availability":{"post":{"tags":["Economics"],"summary":"get_sdg_data_availability","description":"Get which countries and regions have data for a specific series.\n\nUseful for checking data coverage before querying — not all series\nhave data for all countries.\n\nExamples:\n    get_sdg_data_availability('SI_POV_DAY1') → Countries with poverty data","operationId":"unsdg_get_sdg_data_availability","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":{"series_code":{"description":"Series code, e.g. 'SI_POV_DAY1'.","type":"string"}},"required":["series_code"],"type":"object"}}}}}},"/rest/unsdg/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":"unsdg_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."}}}}