What it does
carboncalc is a small local bridge to the hosted GreenCalculus MCP server, which provides a sourced corpus of greenhouse-gas emission factors and deterministic calculators built on it. A factor can be looked up by its canonical key, returning the value with an audit envelope: the publisher, the source reference, the retrieval time, the licence, and whether the per-gas components add up. When the key is unknown, factors can be searched or resolved from a plain-language description. A separate tool explains why a factor is absent from the corpus, for example because no publisher issues it, it has not been sourced yet, it was declined, or it depends on another empty family.
The calculators cover activity data, whole-life embodied carbon for materials under EN 15978, PCAF Part A financed emissions for a supplied portfolio, Scope 2 electricity under location-based and market-based methods, freight under the GLEC framework, spend-based EEIO screening, and business travel by distance. The bridge keeps no factor data. It serves the upstream tool list locally and forwards each tool call upstream, returning the result unchanged. Calculations run only on inputs the caller supplies, and the tool surface contains no sending or payment tool.
It runs as a stdio MCP server, and each tool is also available as a CLI subcommand that takes one JSON argument string. The Docker container's default command starts the MCP server. The upstream endpoint defaults to the hosted GreenCalculus server and can be overridden, and an optional API key can be supplied for upstream requests. The client opens a streamable HTTP session on the first call and reuses it for the life of the process. Upstream failures are returned as error results whose text begins with a fixed prefix. The test suite runs against a stubbed upstream and makes no live network calls.
Limitations and requirements
Requires network access to the upstream GreenCalculus server, by default at mcp.greencalculus.com. An optional GreenCalculus API key can be set through GREENCALCULUS_API_KEY, in which case it is sent as a bearer token on every upstream request. Calculations depend on inputs the caller supplies, and factor availability depends on what the upstream corpus contains.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.CloudCorpRecords/carboncalc
Sourced emission factors and carbon calculations: activity, freight, spend, travel, PCAF.
v0.1.0As shown on registry.modelcontextprotocol.io when we last read it