resolved_from_datasets for the Ember grid factorPick a country above and click Run. The response carries the result, the formula, the grid factor resolved from Ember country-year data, and the CC BY 4.0 attribution chain.
One graph of 1,130 climate methodologies across five kinds: formulas, lookup tables, umbrella standards, governance frameworks, and credit registries. Parsed from primary sources, version-tracked, and dependency-mapped. Ask it in plain English and get an answer that names its sources, or call the same graph over REST and MCP to build it into your own products.
resolved_from_datasets for the Ember grid factorPick a country above and click Run. The response carries the result, the formula, the grid factor resolved from Ember country-year data, and the CC BY 4.0 attribution chain.
Hundreds of standards, dozens of registries, thousands of pages of methodology spread across PDFs, HTML annexes, XML schedules, and spreadsheets. Each one defines a calculation, a factor table, a disclosure requirement, or a ledger of credits. Almost none are machine readable. No two are integrated with each other.
The actual calculation is buried in prose, footnotes, and annexes across PDFs, HTML pages, and supplementary tables. Reading it is a job. Encoding it is a project.
A version bumps. An annex gets revised. A factor table is replaced. Downstream users find out months later, often by accident.
Consultancies, auditors, and platforms re-implement the same formulas, with no consensus on edge cases.
A number reported in a sustainability disclosure rarely carries the exact formula version and inputs that produced it. Auditors cannot replay it.
Climate accounting is a different conversation depending on which side of the desk you sit on. Methodology Graph is built to be the single source of truth across all four.
One POST /v1/calculate/<id> returns the result, the formula, the factor values, and the source citation. Wire it up, move on.
Pin to a methodology version, store the response, replay it in 2030 against the standard as it stood in 2026. Audit trail, not audit panic.
GHG Protocol, IPCC GWP, ISO 14067, PCAF, encoded once. You call our endpoint and spend the engagement on judgment, not on re-encoding standards.
The dependency tree shows every downstream methodology, framework, and registry that references your standard. Useful for revision planning and impact analysis.
Climate methodologies are not a single shape. Some are calculations, some are lookup tables, some are governance frameworks, some are credit registries, and some are umbrella standards that decompose into named parts. Each kind has its own URL space, served by the same engine, queryable through the same graph.
Math expressions and boolean rules. Call them with your inputs, receive the result with provenance attached. Examples: ICAO CORSIA LCA, PCAF financed emissions, SAFc CO2e abatement, EnergyTag matching.
Map a key to a value. Examples: IPCC AR6 GWP100 by gas (22 entries), ICAO CORSIA SAF default LCA by pathway (27 entries). Auto-resolved inside formulas that declare a dependency.
One named umbrella decomposes into typed components, each a callable methodology in its own right. Examples: EU RED III lifecycle (8 components), ISO 14067 product carbon footprint. Call the umbrella and the engine resolves each part recursively.
No calculation, just principles and requirements. Examples: TCFD, ISSB S1/S2, CSRD ESRS, ICVCM Core Carbon Principles. Detail endpoint includes upstream and downstream dependency context.
Credit and certificate registries that other methodologies depend on. Examples: Verra, Gold Standard, ACR, I-REC. Detail endpoint returns the list of consumers depending on the registry.
Lifecycle standards like EU RED III, ISO 14067, and GHG Protocol Product define a calculation as a sum of named components. The umbrella is a methodology; each part is a methodology in its own right; they are linked by typed edges. Call the umbrella with whatever you have, the engine walks the graph for the rest, and the response shows the full chain.
eu-red3 umbrella has 8 typed component edges into 8 sub-methodologies, each independently callable.Inspect the umbrella's structure, run the umbrella with whatever subset of components you have, or call any component standalone as its own methodology. Symbols you skip get resolved from their sub-methodology if a live one exists; optional symbols default to zero. The provenance trace shows where every number came from.
/v1/compositions/eu-red3
inspect structure
/v1/calculate/eu-red3
run umbrella
/v1/calculate/eu-red3-cultivation
run any component
Pass the inputs you have. The engine resolves the rest from the published source. The response carries the formula, the version, and every factor it substituted for you.
Calling GHG Protocol Scope 2? Pass the country and the year. The engine pulls the grid emission factor from Ember's 3,259 country-year electricity intensities, converts the unit, and substitutes it for the caller. The resolved value, the raw upstream value, and the multiplier are all in the response.
The formula text comes back with every result. So does the standard reference and the methodology version. No need to maintain a local copy of every standard you depend on.
Every factor carries its license forward. Ember's CC BY 4.0 attribution lands in the response automatically, alongside any other sources the calculation touched. Compliance and audit get the citation chain for free.
# caller provides kWh, country, year, method # engine resolves emission_factor_kgCO2e_per_kWh from Ember POST /v1/calculate/ghgp-s2 { "inputs": { "electricity_consumed_kWh": 1000, "country": "GBR", "year": "2023", "method": "location_based", "contractual_instrument_quality_passes": false } } 200 OK { "result": { "scope2_emissions_tCO2e": 0.217 }, "provenance": { "formula": "(electricity_consumed_kWh * emission_factor_kgCO2e_per_kWh) / 1000", "standard_reference": "WRI/WBCSD GHG Protocol Scope 2 Guidance (2015)", "resolved_from_datasets": { "emission_factor_kgCO2e_per_kWh": { "dataset": "factor-set:ember-yearly-electricity-2025", "key": "GBR_2024", "raw_value": 216.5, "applied_multiplier": 0.001, "value": 0.2165 } } }, "license_chain": { "attributions_required": [ { "source_name": "Ember Yearly Electricity Data", "license_short_name": "CC BY 4.0" } ] } }
The calculator you depend on has to stay correct when the standard issues a revision six months later. Methodology Graph treats catalog growth, change detection, and confidence review as continuous loops, run by typed agents on a fixed schedule.
Proposes new methodologies the catalog does not yet hold, and walks every known source for revisions. Runs on a fixed schedule, twice weekly for deep discovery, every few hours for incremental seed walks. The catalog grows without operator action.
For every newly classified methodology, a typed agent reads the document and writes a parser definition: formula, input schema, output schema, factor table references, and citations. The parser becomes machine executable. The source stays the authority.
A separate agent, run in isolation, audits the synthesizer's draft against the published standard. Returns a confidence score from 0 to 1 plus a verdict. Above threshold the calculator goes live. Below threshold it sits in a queue for operator review. Two passes by two agents, by design.
An hourly machine-correctness sweep over every live calculator and a continuous watch on every active source. Spots stale extractions, malformed outputs, schema mismatches, and dependency cascades. Re-feeds affected items into discovery, and fans out events to webhook subscribers so dependents hear about a revision before their next audit, not after.
The four roles run on Energy Web's globally distributed serverless runtime. Each role has a precise input contract and a structured response. Each role is run by a separate model chosen for the role's shape, fast and cheap for classification, deep and careful for synthesis, independent and conservative for review. Reliability comes from the surrounding plumbing, schema validation, idempotent writes, retryable queues, multi-stage consensus, not from making any single component cleverer.
Each stage reads from a typed queue, writes to the next, and acknowledges its message only on success. Any stage can be restarted, replayed, or scaled independently. The whole pipeline runs on Energy Web's globally distributed serverless runtime. Multi-format ingestion, multi-pass review, dependency cascades, and an hourly watch loop all sit on top.
Every methodology is a node; every reference is a typed edge. When IPCC publishes a revision to AR6 GWP100, we know automatically which of your live calculations it invalidates. Pick a methodology to see its downstream cascade.
The webhook closes the loop. Drift watch (stage 9 above) runs hourly. When a source revision is detected, the graph re-emits a plan.published webhook to every subscriber with the list of affected methodology ids. The auditor finds out before they ask.
A calculator only becomes callable if it passes two independent checks. The critic is an LLM scoring how faithfully the extracted formula matches the published standard. The machine-correctness check is a deterministic structural verifier that confirms the formula parses, evaluates to a real number, and has no divide-by-zero risks, no chained outputs, no schema gaps. Both must pass.
A second LLM, run independently from the extractor, scores how faithfully the extracted formula matches the published standard. Returns a 0 to 1 score plus a structured verdict. Below threshold rejects; above threshold passes to the next gate.
A deterministic check verifies the formula parses, evaluates to a real number against neutral inputs, has consistent input and output schemas, no unguarded divisions, no chained outputs. The structural gate catches what the critic can miss: a formula that reads correctly but cannot run.
The calculator becomes callable as a public API endpoint with full provenance metadata. Any drift detected later by the hourly sweep demotes it back to review and queues an autonomous re-extraction. Live means it works, today.
Thresholds are tunable per stage. Tighter thresholds mean fewer auto-promotions and more operator review. Looser thresholds mean faster coverage at the cost of more borderline cases reaching production. The two-gate design means a high critic score alone is not enough to go live; the formula must also be structurally executable.
Ask in plain English and get an answer assembled only from the graph, with the standards and sources it used and the models and graph version that produced it. The fastest way in if you want an answer before a tool.
ask.methodology.energyweb.org →Standard HTTPS endpoints, JSON in and out, free for individual use with an email-signup key. List methodologies, fetch dependency trees, call calculators, look up datasets, traverse frameworks and registries.
api.methodology.energyweb.org/v1/ →Model Context Protocol endpoint. Plug it into Claude with one click, into Cursor, into your in-house agent. Typed tools for every calculator, the graph, and the catalog. Ask in natural language, get authoritative numbers.
mcp.methodology.energyweb.org →Browse the full graph visually. Drill into any methodology to see its inputs, dependencies, versions, and primary sources. Try calculations in-place without writing code.
methodology.energyweb.org/viewer →A calculation that nobody can audit is barely a calculation. The Methodology Graph engine returns the exact formula text, the inputs used, the resolved factor values, the methodology version, and the source standard reference, on every successful call. Auditors can replay any result.
The exact expression that produced the number. No reverse engineering required.
If the engine pulled a GWP or LCA default from a dataset, it tells you which row, from which version, with the citation.
The version of the standard that ran is locked into the response, so the same call yields the same answer years later.
A citation pointing to the source document, section, and where in the published text the calculation was defined.
The next phase signs every result with a Verified Compute attestation: a cryptographic proof that the calculation ran on the published standard, executed by a named runtime, against the inputs disclosed in the receipt. Audit-grade provenance, not just metadata. Methodology Graph becomes the public, machine-readable ground truth that other Energy Web products execute against.
Free for individual use, 60 seconds to set up via email. No password, no credit card.
Ask in plain English. Every answer is built only from the graph, names its sources, and shows the models and graph version behind it. Conversational, not a chatbot guessing.
Open ask.methodology.energyweb.org →Interactive viewer with 1,130 methodologies, their versions, dependencies, and primary sources. Try a calculation in place without writing any code.
Open methodology.energyweb.org/viewer →Live REST playground with a public demo key (300 req/min, shared). Every methodology in the catalog has its own callable endpoint, prefilled and ready to run. For higher limits, get your own free key in one minute via email.
Open api.methodology.energyweb.org/explorer →API quickstart, endpoint reference, MCP guide, concepts, error codes. Everything you need to integrate, in one searchable page.
Open methodology.energyweb.org/docs/ →Enter your email. We send you a one-time confirmation link. Click it, get your key. One key per email. Manage at /account if you lose it.
| Tier | Rate limit | How to get it |
|---|---|---|
| demo | 300 req/min | Shared public key, baked into the explorer. For trying things out. |
| free | 600 req/min | Sign up above with email. One key per email. |
| enterprise | Custom | For partner integrations. Contact methodology@energyweb.org. |