Skip to main content
Glama
emission-factors MCP server

emission-factors MCP server

emission-factors MCP server

License: MIT MCP No key required

Give Claude, Cursor, Cline, or any MCP client live access to US electricity data by ZIP code - grid-carbon emission factors, retail rates, hourly grid carbon intensity, power-plant emissions, and utility tariffs.

Backed by emission-factors.com, which wraps EPA eGRID, EIA-861, EIA-930, EPA CAMD, and OpenEI URDB into one ZIP-keyed API.

Free. No API key, no signup. The API is rate-limited per IP (2,000 requests/hour).


What you can ask

Once connected, your agent can answer things like:

  • "My HQ in ZIP 94105 uses 1.2M kWh/year. What's our Scope 2 carbon footprint and annual electricity cost?"

  • "Compare Denver, Austin, and Columbus for a new data center on grid carbon intensity and electricity price."

  • "What hour of the day is cleanest to run a 500 kW batch job in California this week?"

  • "Enrich this list of 40 store ZIP codes with each site's emission factor and carbon-free percentage."

  • "Which are the dirtiest power plants in Texas by CO2 over the last week?"

  • "Rank Ashburn VA, Abilene TX and The Dalles OR for a 10 MW data center on carbon and power cost."

  • "Our plant burns 40,000 therms of gas and 3,000 gallons of diesel a year - what's our Scope 1?"

  • "What's the actual PG&E residential tariff for 94105, not the state average?"

Related MCP server: RMI Utility Transition Hub — MCP Server

Why use it

  • Scope 2 carbon accounting - GHG Protocol location- and market-based emission factors for 33,700+ US ZIP codes (CDP, CSRD, California SB 253 inputs).

  • Site selection - compare candidate locations on both carbon intensity and electricity cost in one conversation.

  • Demand-response and load-shifting analysis - hourly grid carbon from EIA-930 (fixed per-fuel factors on in-BA generation: for timing, not inventory reporting).

  • Plant-level emissions - EPA CAMD data for fossil units over 25 MW: per-facility summaries or unit-hour records, published quarterly.

  • Agents and automation - a clean tool surface so an LLM can fetch authoritative government data instead of hallucinating factors.


Quick start

There are two ways to run this. Most people want Option A.

Nothing to install, always up to date. The hosted endpoint is https://emission-factors.com/mcp (Streamable HTTP, no key).

Claude (web, desktop app, mobile) - Add to Claude. The link opens Claude's custom-connector dialog with the name and URL filled in; select Add, then Connect. By hand: Customize -> Connectors -> Add custom connector, URL https://emission-factors.com/mcp, OAuth fields empty.

Claude Code

claude mcp add --transport http emission-factors https://emission-factors.com/mcp

Cursor - add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "emission-factors": {
      "url": "https://emission-factors.com/mcp"
    }
  }
}

Cline / Continue / Zed / other clients - add a remote (Streamable HTTP) MCP server with URL https://emission-factors.com/mcp. No key needed.

Claude Desktop's claude_desktop_config.json only starts local (stdio) servers - a "url" entry there does nothing. Use the connector link above, or Option B.

Option B - Local stdio server (this package)

Runs the server as a local process that proxies the same public API. Useful for clients that only support stdio transport, or if you want to self-host.

Run straight from GitHub (builds on install, requires Node 18+):

{
  "mcpServers": {
    "emission-factors": {
      "command": "npx",
      "args": ["-y", "github:rozetyp/emission-factors-mcp"]
    }
  }
}

Or clone and run from source:

git clone https://github.com/rozetyp/emission-factors-mcp.git
cd emission-factors-mcp
npm install        # builds dist/ via the prepare script
{
  "mcpServers": {
    "emission-factors": {
      "command": "node",
      "args": ["/absolute/path/to/emission-factors-mcp/dist/index.js"]
    }
  }
}

Optional environment variable: EMISSION_FACTORS_API_BASE (defaults to https://emission-factors.com) if you run your own instance of the API.


Tools

Eleven tools, keyed by US ZIP code (or a direct code where noted). The remote server and this stdio build expose the same set.

Tool

Purpose

Key inputs

lookup_emission_factor

EPA eGRID CO2e + full generation mix for a ZIP

zip

lookup_by_coordinates

Same, resolved from lat/lon via Census geocoder

lat, lon

lookup_batch

Emission factors for up to 100 ZIPs at once

zips[]

calculate_emissions

Scope 2 CO2e for a ZIP + kWh, location-based and market-based (Green-e residual mix)

zip, kwh, renewable_kwh

hourly_intensity

Hourly grid carbon intensity (EIA-930, ~24h lag)

zip or ba, hours

plant_emissions

Plant emissions (EPA CAMD): facility summaries or unit-hour records

facility_id or state, days

utility_tariff

Utility-specific tariff, not state average (OpenEI URDB)

zip, utility, or eiaid

electricity_rate

State-average retail rate by sector (EIA-861)

zip

compare_sites

Rank 2-25 candidate sites on grid carbon, $/kWh and cleanest daily window

zips[], annual_kwh, sector

cleanest_hours

Cleanest N-hour window of the day to run a flexible load, in local time

zip or ba, duration

calculate_fuel_emissions

Scope 1 CO2e for fuels burned on site (EPA GHG Emission Factors Hub)

items[]: fuel, quantity, unit

All tools return JSON. See full API docs for exact response shapes.


Data sources

Data

Source

Notes

Grid emission factors

EPA eGRID2023 Rev2 (+ eGRID2024 from Cornerstone via year=2024)

Annual, location-based, 27 subregions

Residual mix (market-based Scope 2)

Green-e Residual Mix 2025 (2023 data)

Per eGRID subregion

Fuel combustion factors (Scope 1)

GHG Emission Factors Hub 2026 (Cornerstone, successor to EPA's Hub); EPA 2025 via edition

63 fuels, AR6 GWPs (AR5 for 2025)

Retail electricity rates

EIA Form 861

State-level monthly average by sector

Hourly grid carbon intensity

EIA-930

Derived from hourly fuel mix, ~24h lag

Plant-level emissions

EPA CAMD

fossil units >25 MW, published quarterly (45+ days after quarter end)

Utility-specific tariffs

OpenEI URDB (NREL)

ZIP matched to its utility by EIA ID

ZIP / lat-lon resolution

US Census (ZCTA + Geocoder)

ZIP -> eGRID subregion mapping

Rate limits and auth

  • No API key, no signup. Every request is anonymous.

  • 2,000 requests/hour per IP. Generous for interactive use; if you hit it you get an HTTP 429 with a retryAfter hint.

  • The external-data endpoints are cached server-side (24h rates, 1h hourly intensity, 7d tariffs, 24h plant emissions), so repeated calls are fast and don't burn upstream quotas.

Also available


Development

npm install        # install deps and build (prepare -> tsc)
npm run build      # compile TypeScript to dist/
npm run dev        # watch mode
npm start          # run the built server over stdio

Quick smoke test with the MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

The server is a thin proxy: each tool maps to one /api/* endpoint on emission-factors.com, validates inputs, and returns the JSON response. There is no local state and no key handling.

License

MIT - see LICENSE. Data belongs to its respective US government sources (EPA, EIA, Census) and NREL/OpenEI; this project and the API are an unofficial wrapper, not affiliated with those agencies.

Available Tools

11 tools
calculate_emissionsA
Read-only
Inspect

Calculate Scope 2 CO2e for a facility from its ZIP and kWh, using both GHG Protocol methods: location-based (eGRID subregion rate) and market-based (Green-e residual mix applied to kWh not covered by RECs, PPAs or green tariffs). Returns kg CO2e for each method with the factors used.

Inputs: kwh (required), zip (required), year, renewable_kwh.

calculate_fuel_emissionsA
Read-only
Inspect

Calculate Scope 1 stationary-combustion emissions (CO2, CH4, N2O and CO2e) for fuels burned on site, using the GHG Emission Factors Hub 2026 (Cornerstone, successor to EPA's Hub; IPCC AR6 GWPs) by default, or EPA's 2025 edition (AR5) with edition=2025. Pass one or more items with fuel, quantity and unit, e.g. natural gas in therms/ccf/mcf/scf, propane/diesel/heating oil in gallons, coal in short tons. Biomass CO2 is reported separately (biogenic). Stationary sources only: for vehicle fuel the CO2 per gallon is the same, but CH4/N2O factors differ and are not included. Returns per-item and total CO2e. Pair with calculate_emissions for a facility's electricity (Scope 2).

Inputs: items (required), edition.

cleanest_hoursA
Read-only
Inspect

Find the cleanest (lowest grid carbon) contiguous window of N hours in the day to run a flexible load (batch jobs, EV charging, pumping, HVAC pre-cooling) at a US ZIP code or balancing authority. Based on the hour-of-day pattern of the last 7 days (168 hours) of EIA-930 data, in local time. Returns the cleanest and dirtiest windows, % saved vs the daily average, and all hours ranked. A scheduling guide from recent history, not a forecast.

Inputs: ba, zip, duration.

compare_sitesA
Read-only
Inspect

Compare and rank 2-25 candidate US sites (ZIP codes) for a facility, data center or EV/flexible load on grid carbon and electricity cost in one call. Per site: eGRID CO2e kg/kWh (location-based), Green-e residual mix (market-based), carbon-free %, $/kWh for the sector (the average of the ZIP's primary full-service utility - full-service first, then public power, IOU, co-op, the same heuristic as lookup's utility.primary - unless a delivery-only utility serves the ZIP (retail choice), else the state average; all EIA-861 2023, see rate_basis), and the cleanest daily window from the 7-day hourly profile of its balancing authority. With annual_kwh, also annual tCO2e and cost. Returns competition ranks by carbon, cost and combined, gap percentages, and best_* = null with *_tied lists when sites tie.

Inputs: zips (required), sector, duration, annual_kwh.

electricity_rateA
Read-only
Inspect

Get the latest monthly average retail electricity rate ($/kWh and cents/kWh) for any US ZIP code, broken out by sector (residential, commercial, industrial, etc.). Data is state-level from EIA Form 861 - a ballpark, not utility- or ZIP-specific tariffs (use utility_tariff for those).

Inputs: zip (required).

hourly_intensityA
Read-only
Inspect

Get hourly grid carbon intensity (kg CO2e per kWh) for any US ZIP code, derived from EIA-930 hourly fuel-mix data. Data lags up to about a day (not real-time). Returns time series with per-hour fuel mix, total generation, and carbon intensity. For timing and analysis (demand response, load shifting, grid patterns), not inventory reporting: it uses fixed per-fuel combustion factors on in-BA generation (no imports), so its values don't match eGRID's annual factors. For live or forecast intensity, WattTime or Electricity Maps are better options.

Inputs: ba, zip, hours, aggregate.

lookup_batchA
Read-only
Inspect

Look up emission factors for up to 100 ZIP codes in one call (split longer lists). Returns one compact row per ZIP - subregion, CO2e kg/kWh (location-based), residual mix (market-based), carbon-free %, utility - unless full is true, which returns every field (about 2 KB per ZIP).

Inputs: zips (required), full.

lookup_by_coordinatesA
Read-only
Inspect

Look up emission factors by latitude/longitude. Uses US Census Geocoder to resolve to ZIP first, then returns the same data as lookup_emission_factor. Useful when you have a facility address or lat/lon but no ZIP.

Inputs: lat (required), lon (required).

lookup_emission_factorA
Read-only
Inspect

Look up EPA eGRID electricity emission factors for a US ZIP code. Returns CO2e (kg/kWh and lb/MWh), CO2, CH4, N2O, NOx, SO2, non-baseload rate, carbon-free %, generation mix (coal/gas/nuclear/hydro/wind/solar etc.), eGRID subregion code, the data year, and the Green-e residual mix rate (the market-based Scope 2 factor). For Scope 2 emissions from a kWh total, use calculate_emissions, which does the arithmetic for both methods.

Inputs: zip (required), year.

plant_emissionsA
Read-only
Inspect

Get emissions from EPA Clean Air Markets Division (CAMD) for a specific US power plant or a state: fossil units over 25 MW reporting to the Acid Rain Program and CSAPR. Per facility returns total CO2 (short tons), gross generation (MWh), heat input (mmBtu), NOx and SO2 (lb), primary fuel type, operating hours, and derived emissions rate (kg CO2/MWh). CAMD publishes by quarter, so the default window is the last 7 days of the latest published quarter (latest_published_date in the response); later dates are not available yet. Default output is a per-facility summary from daily data; format=hourly returns unit-hour records for small windows. Use for plant-specific carbon accounting, state-level fossil emissions and "dirtiest plants in [state]" queries.

Inputs: end, days, begin, limit, +3 more.

utility_tariffA
Read-only
Inspect

Get the actual utility-specific electricity rate (not state average) for a US ZIP code or named utility. Returns the current default tariff with effective rate ($/kWh), fixed monthly charge, tier count, TOU indicator, and effective date. Data source: OpenEI URDB (NREL-hosted). With a ZIP, matches the ZIP's utility by EIA ID. Returns currently-effective tariffs; when URDB has none flagged as default (common for Commercial/Industrial) it returns the most recent ones and says so in warnings, including when the newest available tariff has expired. Does not cover Texas retail electric providers (deregulated market) - use electricity_rate there.

Inputs: zip, eiaid, limit, sector, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 11 tools

    Disambiguation4/5

    Most tools have distinct roles, and descriptions proactively cross-reference each other (electricity_rate vs utility_tariff, hourly_intensity vs eGRID, fuel vs electricity). The three lookup_* tools overlap conceptually but are cleanly split by input type (batch ZIPs, coordinates, single ZIP). compare_sites and cleanest_hours partially recombine underlying lookups, but their high-level intent is distinct.

    Naming Consistency3/5

    Roughly half the tools follow a verb_noun pattern (lookup_*, calculate_*, compare_sites), while the rest are bare noun phrases (electricity_rate, hourly_intensity, plant_emissions, utility_tariff, cleanest_hours). All are readable snake_case, but the naming scheme is mixed rather than systematic.

    Tool Count5/5

    11 tools is well within the healthy range and each maps to a meaningful capability (ZIP/lat-lon lookups, batch, rates, Scope 1 and 2 calculations, hourly intensity, plant data, site comparison, scheduling). No tool feels like filler or a redundant variant.

    Completeness4/5

    Coverage is strong for the US electricity-emissions domain: single/batch/coordinate factor lookups, state and utility rates, Scope 2 and Scope 1 calculators, hourly intensity, plant emissions, site ranking, and cleanest-hour scheduling. Gaps are minor and largely acknowledged (no forecasting, US-only scope), workable via external services.

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Browse and query the U.S. Energy Information Administration API v2 — electricity, petroleum, natural gas, coal, forecasts, and more via MCP. STDIO or Streamable HTTP.
      449 npm
      3
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      Live and historical electricity prices, demand, generation mix and carbon intensity for 25 grid zones (US, Europe, GB, Australia). Hosted endpoint plus local stdio bridge; free sample mode, free API key, or x402 pay-per-call.
      6
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides real-time grid carbon intensity, power generation breakdown, and carbon-intensity forecasts for any zone or lat/lon location.
      101 npm
      MIT