How to integrate Electricity Maps MCP with Atomic Agent

Connect Atomic Agent to Electricity Maps MCP. Check current carbon intensity in california, compare renewable energy across european zones, and more using natural language, with authentication handled for you.

Electricity Maps logoElectricity Maps
Api Key

Electricity Maps is a data service for grid carbon intensity, power mix, and energy market data. It helps teams track emissions, renewable energy, power flows, and prices by zone.

49 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Electricity Maps.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Electricity Maps account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Electricity Maps with

How Atomic Agent connects to Electricity Maps

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Electricity Maps to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Electricity Maps. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Electricity Maps account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Electricity Maps MCP server, and what's possible with it?

The Electricity Maps MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Electricity Maps account. It provides structured and secure access to grid carbon intensity, electricity mix, power flows, load, energy shares, forecasts, and day-ahead prices, so your agent can monitor grid conditions, compare historical energy data, review future forecasts, and analyze electricity costs on your behalf.

  • Carbon intensity monitoring: Have your agent check the latest, historical, or past carbon intensity for a zone, including grid-average and fossil-only values.
  • Energy mix and renewable analysis: Let the agent review current, historical, and forecasted electricity generation by source, along with carbon-free and renewable energy shares.
  • Grid flow and load tracking: Direct your agent to examine electricity flows and net, total, or total-reported load for a zone across current, historical, past, and forecast periods.
  • Grid condition forecasting: Instruct your agent to assess forecasted carbon intensity, carbon-free percentages, renewable percentages, electricity mix, flows, source generation, energy shares, and load.
  • Day-ahead price research: Have your agent retrieve current, historical, past, or actual day-ahead prices for a zone or locational marginal prices for a pricing node over a selected time range.

Use Electricity Maps from Atomic Agent

With your account connected, ask Atomic Agent to work with Electricity Maps in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Electricity Maps action and event your agent gets out of the box.

Get Carbon Intensity Forecast

Get a grid-average or fossil-only carbon intensity forecast for a zone.

Get Carbon Intensity History

Get the last 24 hours of grid-average or fossil-only carbon intensity for a zone.

Get Carbon Intensity Latest

Get the latest grid-average or fossil-only carbon intensity for a zone.

Get Carbon Intensity Past

Get grid-average or fossil-only carbon intensity for a zone at a given datetime.

Get Carbon Intensity Past Range

Get grid-average or fossil-only carbon intensity for a zone over a datetime range.

Get Electricity Flows Forecast

Get the electricity flows forecast for a zone.

Get Electricity Flows History

Get the last 24 hours of electricity flows for a zone.

Get Electricity Flows Latest

Get the latest electricity flows for a zone.

Get Electricity Flows Past

Get the electricity flows for a zone at a given datetime.

Get Electricity Flows Past Range

Get the electricity flows for a zone and a given datetime range.

Get Electricity Mix Forecast

Get the electricity mix forecast for a zone.

Get Electricity Mix History

Get the last 24 hours of electricity mix for a zone.

Get Electricity Mix Latest

Get the latest electricity mix for a zone.

Get Electricity Mix Past

Get the electricity mix for a zone at a given datetime.

Get Electricity Mix Past Range

Get the electricity mix for a zone and a given datetime range.

Get Electricity Source Forecast

Get forecasted electricity generation values for the selected source_type in a zone.

Get Electricity Source History

Get the last 24 hours of electricity generation values for the selected source_type in a zone.

Get Electricity Source Latest

Get the latest electricity generation values for the selected source_type in a zone.

Get Electricity Source Past

Get electricity generation values for the selected source_type in a zone at a given datetime.

Get Electricity Source Past Range

Get electricity generation values for the selected source_type in a zone over a given datetime range.

Get Energy Share Forecast

Get the carbon-free or renewable electricity share forecast for a zone.

Get Energy Share History

Get the last 24 hours of carbon-free or renewable electricity share for a zone.

Get Energy Share Latest

Get the latest carbon-free or renewable electricity share for a zone.

Get Energy Share Past

Get the carbon-free or renewable electricity share at a given datetime.

Get Energy Share Past Range

Get carbon-free or renewable electricity share values over a datetime range.

Get Grid Level Forecast

Get forecasted carbon-intensity, carbon-free-percentage, or renewable-percentage grid levels.

Get Grid Level Latest

Get the latest carbon-intensity, carbon-free-percentage, or renewable-percentage grid level.

Get Grid Level Past

Get a carbon-intensity, carbon-free-percentage, or renewable-percentage grid level for an exact past hourly bucket.

Get Grid Level Past Range

Get carbon-intensity, carbon-free-percentage, or renewable-percentage grid levels over an hourly range of at most 10 days.

Get Load Forecast

Get a net, total, or total-reported electricity load forecast.

Get Load History

Get the last 24 hours of net, total, or total-reported load.

Get Load Latest

Get the latest net, total, or total-reported electricity load value.

Get Load Past

Get net, total, or total-reported load at a given datetime.

Get Load Past Range

Get net, total, or total-reported load over a datetime range.

Get Day-Ahead Locational Marginal Price Actual

Get actual day-ahead locational marginal prices for a pricing node and datetime range.

Get Day-Ahead Locational Marginal Price History

Get the last 24 hours of day-ahead locational marginal prices for a pricing node.

Get Day-Ahead Locational Marginal Price Latest

Get the latest day-ahead locational marginal price for a pricing node.

Get Day-Ahead Locational Marginal Price Past

Get the day-ahead locational marginal price for a pricing node at a given datetime.

Get Day-Ahead Locational Marginal Price Past Range

Get day-ahead locational marginal prices for a pricing node and past datetime range of at most 10 days.

Get Day-Ahead Price Actual

Get settled and published day-ahead prices for a zone and datetime range.

Get Day-Ahead Price Combined

Get both actual and forecasted day-ahead prices for a zone in a single response.

Get Day-Ahead Price Forecast

Get the day-ahead price forecast for a zone.

Get Day-Ahead Price History

Get the last 24 hours of day-ahead price for a zone.

Get Day-Ahead Price Latest

Get the latest day-ahead price for a zone.

Get Day-Ahead Price Past

Get the day-ahead price for a zone at a given datetime.

Get Day-Ahead Price Past Range

Get the day-ahead price for a zone and a given datetime range.

Get Zone

Get metadata for a single Electricity Maps zone.

List Updates Since

List data points for a zone that have been updated since a given datetime.

List Zones

List all commercially available Electricity Maps zones.

FAQ

Frequently asked questions

Start with Electricity Maps.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Electricity Maps tool your agent needs.Free to start.

Start building