Economics

Data source: UN Stats SDG API v5

MCP MCP Protocol

Endpoint https://context.gnist.ai/mcp/unsdg/

nobloat — strip report_feedback tool URL-based auth (for clients without header support)

claude_desktop_config.json

{
  "mcpServers": {
    "gnist-unsdg": {
      "url": "https://context.gnist.ai/mcp/unsdg/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Shell

curl -X POST "https://context.gnist.ai/mcp/unsdg/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_goal_targets", "arguments": {"goal_code": 1}}}'

API REST API

API Root https://context.gnist.ai/rest/unsdg/

8 endpoints available:

GET /rest/unsdg/list_sdg_goals
GET /rest/unsdg/get_goal_targets
GET /rest/unsdg/get_sdg_indicator_data
GET /rest/unsdg/get_sdg_series_data
GET /rest/unsdg/search_sdg_geo_areas
GET /rest/unsdg/get_sdg_series_dimensions
GET /rest/unsdg/get_sdg_data_availability
GET /rest/unsdg/report_feedback

Shell

curl "https://context.gnist.ai/rest/unsdg/get_goal_targets?goal_code=1" \
  -H "Gnist-API-Key: YOUR_API_KEY"

Python

import httpx

resp = httpx.get(
    "https://context.gnist.ai/rest/unsdg/get_goal_targets",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    params={
        "goal_code": 1
},
)
print(resp.json())

OpenAPI Spec · Full API Docs

CLI Command Line

Command gc unsdg

CLI documentation will be available when the GnistAI SDK is published.

Install

pip install gnistai

Available Tools (8)

list_sdg_goals

List all 17 UN Sustainable Development Goals.

get_goal_targets

Get targets and indicators for a specific SDG goal.

Parameter	Type	Required	Description
`goal_code`	`integer`	required	SDG goal number (1-17). E.g. 1 = No Poverty, 13 = Climate Action.

get_sdg_indicator_data

Get observation data for SDG indicators.

Parameter	Type	Required	Description
`indicator_codes`	`list[string]`	required	Indicator code(s), e.g. ['1.1.1'] for extreme poverty rate.
`area_codes`	`any`	optional	Geo area code(s). E.g. [578] for Norway, [840] for USA. Use search_sdg_geo_areas to find codes.
`time_start`	`any`	optional	Start year (e.g. 2015).
`time_end`	`any`	optional	End year (e.g. 2023).
`page`	`integer`	optional	Page number (default 1). (default: 1)
`page_size`	`integer`	optional	Results per page, max 200 (default 50). (default: 50)

get_sdg_series_data

Get observation data for specific SDG data series.

Parameter	Type	Required	Description
`series_codes`	`list[string]`	required	Series code(s), e.g. ['SI_POV_DAY1'] for poverty rate.
`area_codes`	`any`	optional	Geo area code(s). E.g. [578] for Norway.
`time_start`	`any`	optional	Start year.
`time_end`	`any`	optional	End year.
`page`	`integer`	optional	Page number. (default: 1)
`page_size`	`integer`	optional	Results per page, max 200. (default: 50)