{"openapi":"3.0.3","info":{"title":"Gnist Context — Climate TRACE (Carbon Emissions)","description":"Global greenhouse gas emissions data — country rankings, facility-level sources, sector breakdowns for CO2, CH4, N2O and 60+ gases covering 252 countries.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/climate-trace/`\n- **Toolkit page:** `/toolkits/climate-trace`\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/climate-trace/rank_countries_by_emissions":{"post":{"tags":["Environment"],"summary":"rank_countries_by_emissions","description":"Rank countries by greenhouse gas emissions.\n\nUses Climate TRACE data covering 252 countries and 60+ greenhouse gases.\nReturns country rankings with total emissions and optional sector breakdowns.\n\nArgs:\n    gas: Gas type to rank by (default co2e_100yr).\n    start: Start year filter.\n    end: End year filter.\n    sectors: Comma-separated sector filter.\n    continent: Continent filter.\n\nReturns:\n    Ranked list of countries with emissions totals.","operationId":"climate_trace_rank_countries_by_emissions","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":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"gas":{"default":"co2e_100yr","description":"Gas type: 'co2', 'co2e_20yr', 'co2e_100yr', 'ch4', 'n2o'. Default 'co2e_100yr'.","type":"string"},"start":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Start year (inclusive). Omit for all available years."},"end":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"End year (inclusive). Omit for all available years."},"sectors":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated sectors (e.g. 'power,transportation'). Omit for all sectors."},"continent":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Continent filter: 'Africa', 'Asia', 'Europe', 'North America', 'Oceania', 'South America'."}},"type":"object"}}}}}},"/rest/climate-trace/search_emission_sources":{"post":{"tags":["Environment"],"summary":"search_emission_sources","description":"Search for top emission sources (facilities, power plants, etc.).\n\nReturns ranked emission sources with location, sector, and emissions data.\nSources include power plants, factories, oil/gas facilities, and more.\n\nArgs:\n    year: Filter by emissions year.\n    gas: Gas type (default co2e_100yr).\n    sectors: Comma-separated sector filter.\n    country: ISO country code filter.\n    limit: Max results (1-100, default 20).\n\nReturns:\n    List of emission sources with name, location, sector, and emissions.","operationId":"climate_trace_search_emission_sources","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":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Emissions year (e.g. 2022). Omit for latest."},"gas":{"default":"co2e_100yr","description":"Gas type (default 'co2e_100yr').","type":"string"},"sectors":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated sectors (e.g. 'power,manufacturing')."},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO country code (e.g. 'US', 'CHN', 'NOR')."},"limit":{"default":20,"description":"Number of results (1-100, default 20).","type":"integer"}},"type":"object"}}}}}},"/rest/climate-trace/get_emission_source":{"post":{"tags":["Environment"],"summary":"get_emission_source","description":"Get detailed information for a specific emission source.\n\nReturns full details including time series emissions data for a single\nfacility or source identified by its Climate TRACE source ID.\n\nArgs:\n    source_id: Climate TRACE source ID.\n\nReturns:\n    Source details with name, location, sector, and emissions time series.","operationId":"climate_trace_get_emission_source","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":{"source_id":{"description":"Climate TRACE source ID. Use search_emission_sources to find IDs.","type":"string"}},"required":["source_id"],"type":"object"}}}}}},"/rest/climate-trace/get_aggregate_emissions":{"post":{"tags":["Environment"],"summary":"get_aggregate_emissions","description":"Get aggregate greenhouse gas emissions data.\n\nReturns total emissions aggregated by the specified filters — useful for\ncomparing sectors, countries, or tracking emissions over time.\n\nArgs:\n    year: Filter by emissions year.\n    gas: Gas type (default co2e_100yr).\n    sectors: Comma-separated sector filter.\n    country: ISO country code filter.\n\nReturns:\n    Aggregated emissions data for the specified filters.","operationId":"climate_trace_get_aggregate_emissions","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":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Emissions year (e.g. 2022). Omit for latest."},"gas":{"default":"co2e_100yr","description":"Gas type (default 'co2e_100yr').","type":"string"},"sectors":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated sectors (e.g. 'power,transportation')."},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO country code (e.g. 'US', 'CHN', 'DEU')."}},"type":"object"}}}}}},"/rest/climate-trace/list_emission_sectors":{"post":{"tags":["Environment"],"summary":"list_emission_sectors","description":"List all available emission sectors in Climate TRACE.\n\nReturns the complete list of sectors used to categorize emission sources,\nsuch as power, transportation, manufacturing, agriculture, etc.\n\nReturns:\n    List of all sector definitions.","operationId":"climate_trace_list_emission_sectors","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/climate-trace/list_emission_countries":{"post":{"tags":["Environment"],"summary":"list_emission_countries","description":"List all countries tracked by Climate TRACE.\n\nReturns the full list of 252 countries with emissions data available.\n\nReturns:\n    List of all country definitions.","operationId":"climate_trace_list_emission_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":[]}]}},"/rest/climate-trace/report_feedback":{"post":{"tags":["Environment"],"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":"climate_trace_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":"Environment","description":"Data sources: Environment"}],"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."}}}}