emission-factors MCP server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@emission-factors MCP server What's the Scope 2 emission factor for ZIP 94105?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
emission-factors MCP server
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.
Option A - Remote server (recommended, zero install)
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/mcpCursor - 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.jsononly 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 |
| EPA eGRID CO2e + full generation mix for a ZIP |
|
| Same, resolved from lat/lon via Census geocoder |
|
| Emission factors for up to 100 ZIPs at once |
|
| Scope 2 CO2e for a ZIP + kWh, location-based and market-based (Green-e residual mix) |
|
| Hourly grid carbon intensity (EIA-930, ~24h lag) |
|
| Plant emissions (EPA CAMD): facility summaries or unit-hour records |
|
| Utility-specific tariff, not state average (OpenEI URDB) |
|
| State-average retail rate by sector (EIA-861) |
|
| Rank 2-25 candidate sites on grid carbon, $/kWh and cleanest daily window |
|
| Cleanest N-hour window of the day to run a flexible load, in local time |
|
| Scope 1 CO2e for fuels burned on site (EPA GHG Emission Factors Hub) |
|
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 | 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
retryAfterhint.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
REST API - the same data over plain HTTP:
curl "https://emission-factors.com/api/lookup?zip=94105". See the API docs and OpenAPI spec.Hosted MCP setup guide - emission-factors.com/mcp-setup
Machine-readable summary for agents - emission-factors.com/llms.txt
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 stdioQuick smoke test with the MCP Inspector:
npx @modelcontextprotocol/inspector node dist/index.jsThe 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 toolscalculate_emissionsARead-onlyInspect
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_emissionsARead-onlyInspect
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_hoursARead-onlyInspect
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_sitesARead-onlyInspect
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_rateARead-onlyInspect
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_intensityARead-onlyInspect
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_batchARead-onlyInspect
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_coordinatesARead-onlyInspect
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_factorARead-onlyInspect
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_emissionsARead-onlyInspect
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_tariffARead-onlyInspect
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
Scored across 11 tools
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.
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.
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.
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
Related MCP Connectors
Carbon MCP — UK Carbon Intensity API (free, no auth)
EPA Emissions MCP — wraps EPA Envirofacts REST API (free, no auth)
Unofficial GridStatus MCP — wraps the GridStatus.io REST API (api.gridstatus.io/v1)
Live US retail electricity plans, utility price-to-compare rates, ZIP-to-utility lookup. Read-only.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceBrowse 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 npm3Apache 2.0
- FlicenseAqualityBmaintenanceEnables natural-language querying of US utility emissions, generation mix, and climate alignment data through any MCP client.7-
- AlicenseAqualityCmaintenanceLive 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.6MIT
- AlicenseNot gradedqualityBmaintenanceProvides real-time grid carbon intensity, power generation breakdown, and carbon-intensity forecasts for any zone or lat/lon location.101 npmMIT