Environment

Data source: Climate TRACE (climatetrace.org)

MCP MCP Protocol

Endpoint https://context.gnist.ai/mcp/climate-trace/

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

claude_desktop_config.json

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

Shell

curl -X POST "https://context.gnist.ai/mcp/climate-trace/" \
  -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_emission_source", "arguments": {"source_id": "example"}}}'

API REST API

API Root https://context.gnist.ai/rest/climate-trace/

7 endpoints available:

GET /rest/climate-trace/rank_countries_by_emissions
GET /rest/climate-trace/search_emission_sources
GET /rest/climate-trace/get_emission_source
GET /rest/climate-trace/get_aggregate_emissions
GET /rest/climate-trace/list_emission_sectors
GET /rest/climate-trace/list_emission_countries
GET /rest/climate-trace/report_feedback

Shell

curl "https://context.gnist.ai/rest/climate-trace/get_emission_source?source_id=example" \
  -H "Gnist-API-Key: YOUR_API_KEY"

Python

import httpx

resp = httpx.get(
    "https://context.gnist.ai/rest/climate-trace/get_emission_source",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    params={
        "source_id": "example"
},
)
print(resp.json())

OpenAPI Spec · Full API Docs

CLI Command Line

Command gc climate-trace

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

Install

pip install gnistai

Available Tools (7)

rank_countries_by_emissions

Rank countries by greenhouse gas emissions.

Parameter	Type	Required	Description
`gas`	`string`	optional	Gas type: 'co2', 'co2e_20yr', 'co2e_100yr', 'ch4', 'n2o'. Default 'co2e_100yr'. (default: "co2e_100yr")
`start`	`any`	optional	Start year (inclusive). Omit for all available years.
`end`	`any`	optional	End year (inclusive). Omit for all available years.
`sectors`	`any`	optional	Comma-separated sectors (e.g. 'power,transportation'). Omit for all sectors.
`continent`	`any`	optional	Continent filter: 'Africa', 'Asia', 'Europe', 'North America', 'Oceania', 'South America'.

search_emission_sources

Search for top emission sources (facilities, power plants, etc.).

Parameter	Type	Required	Description
`year`	`any`	optional	Emissions year (e.g. 2022). Omit for latest.
`gas`	`string`	optional	Gas type (default 'co2e_100yr'). (default: "co2e_100yr")
`sectors`	`any`	optional	Comma-separated sectors (e.g. 'power,manufacturing').
`country`	`any`	optional	ISO country code (e.g. 'US', 'CHN', 'NOR').
`limit`	`integer`	optional	Number of results (1-100, default 20). (default: 20)

get_emission_source

Get detailed information for a specific emission source.

Parameter	Type	Required	Description
`source_id`	`string`	required	Climate TRACE source ID. Use search_emission_sources to find IDs.

get_aggregate_emissions

Get aggregate greenhouse gas emissions data.

Parameter	Type	Required	Description
`year`	`any`	optional	Emissions year (e.g. 2022). Omit for latest.
`gas`	`string`	optional	Gas type (default 'co2e_100yr'). (default: "co2e_100yr")
`sectors`	`any`	optional	Comma-separated sectors (e.g. 'power,transportation').
`country`	`any`	optional	ISO country code (e.g. 'US', 'CHN', 'DEU').