{"openapi":"3.0.3","info":{"title":"Gnist Context — Electricity Maps","description":"Real-time energy grid data — carbon intensity, generation mix, and power breakdown by zone.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/electricity-maps/`\n- **Toolkit page:** `/toolkits/electricity-maps`\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/electricity-maps/get_carbon_intensity":{"post":{"tags":["Environment"],"summary":"get_carbon_intensity","description":"Get the carbon intensity of electricity production for a grid zone.\n\nCarbon intensity measures how much CO₂-equivalent is emitted per kWh of electricity\nconsumed, expressed in gCO₂eq/kWh. Lower is greener.\n\nArgs:\n    zone: Electricity Maps zone code (e.g. \"NO\", \"DE\", \"FR\", \"GB\", \"US-CAL-CISO\").\n          See https://app.electricitymaps.com for a full list of zone codes.\n    datetime: Optional ISO 8601 datetime string to look up historical intensity.\n              If omitted, returns the latest available value.\n              Historical data covers approximately the past 24 hours.\n\nReturns:\n    Carbon intensity in gCO₂eq/kWh with zone, timestamp, and estimation metadata.","operationId":"electricity_maps_get_carbon_intensity","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":{"zone":{"description":"Electricity Maps zone code (e.g. \"NO\", \"DE\", \"FR\", \"GB\", \"US-CAL-CISO\"). See https://app.electricitymaps.com for a full list of zone codes.","type":"string"},"datetime":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional ISO 8601 datetime string to look up historical intensity. If omitted, returns the latest available value. Historical data covers approximately the past 24 hours."}},"required":["zone"],"type":"object"}}}}}},"/rest/electricity-maps/get_grid_mix":{"post":{"tags":["Environment"],"summary":"get_grid_mix","description":"Get the current electricity production breakdown by energy source for a grid zone.\n\nShows how electricity is being generated right now — what percentage comes from\nrenewables, fossil fuels, nuclear, etc. Useful for understanding a region's\nenergy profile or for EU CSRD Scope 2 emissions reporting.\n\nArgs:\n    zone: Electricity Maps zone code (e.g. \"NO\", \"DE\", \"FR\", \"GB\", \"US-CAL-CISO\").\n\nReturns:\n    Production breakdown by source (MW), total production, renewable percentage,\n    fossil-free percentage, and IPCC lifecycle emission factor per source.","operationId":"electricity_maps_get_grid_mix","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":{"zone":{"description":"Electricity Maps zone code (e.g. \"NO\", \"DE\", \"FR\", \"GB\", \"US-CAL-CISO\").","type":"string"}},"required":["zone"],"type":"object"}}}}}},"/rest/electricity-maps/forecast_intensity":{"post":{"tags":["Environment"],"summary":"forecast_intensity","description":"Get predicted carbon intensity for a grid zone over the coming hours.\n\nForecasts are generated by Electricity Maps based on weather models and\nscheduled generation. Useful for scheduling compute workloads, EV charging,\nor other deferrable energy consumption to lower-carbon windows.\n\nArgs:\n    zone: Electricity Maps zone code (e.g. \"NO\", \"DE\", \"FR\", \"GB\", \"US-CAL-CISO\").\n    hours_ahead: How many hours of forecast to return (1–48, default 24).\n\nReturns:\n    Hourly forecast entries with predicted carbon intensity in gCO₂eq/kWh.","operationId":"electricity_maps_forecast_intensity","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":{"zone":{"description":"Electricity Maps zone code (e.g. \"NO\", \"DE\", \"FR\", \"GB\", \"US-CAL-CISO\").","type":"string"},"hours_ahead":{"default":24,"description":"How many hours of forecast to return (1–48, default 24).","type":"integer"}},"required":["zone"],"type":"object"}}}}}},"/rest/electricity-maps/find_greenest_region":{"post":{"tags":["Environment"],"summary":"find_greenest_region","description":"Compare carbon intensity across multiple grid zones and rank them by greenness.\n\nUseful for routing compute workloads, data center jobs, or EV charging to the\ncleanest available grid. Lower carbon intensity = greener electricity.\n\nArgs:\n    zones: List of Electricity Maps zone codes to compare\n           (e.g. [\"NO\", \"SE\", \"FI\", \"DE\", \"FR\"]).\n    window_hours: Averaging window in hours (1 = current value, default 1).\n                  Values > 1 average over recent history for a smoother signal.\n\nReturns:\n    Zones ranked from greenest to most carbon-intensive, with intensity values\n    and the recommended zone for low-carbon scheduling.","operationId":"electricity_maps_find_greenest_region","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":{"zones":{"description":"List of Electricity Maps zone codes to compare (e.g. [\"NO\", \"SE\", \"FI\", \"DE\", \"FR\"]).","items":{"type":"string"},"type":"array"},"window_hours":{"default":1,"description":"Averaging window in hours (1 = current value, default 1). Values > 1 average over recent history for a smoother signal.","type":"integer"}},"required":["zones"],"type":"object"}}}}}},"/rest/electricity-maps/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":"electricity_maps_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."}}}}