Carbonara MCP server

This URL is a Model Context Protocol server for AI assistants. It calculates freight transport greenhouse gas emissions (kg CO2e, well-to-wheel with tank-to-wheel and well-to-tank) following the GLEC Framework v3.2 and ISO 14083:2023, with real routing for road, rail, inland waterway and sea, and shows every step of each calculation with its sources.

Opening it in a browser shows this page; assistants talk to it with POST requests carrying JSON-RPC (Streamable HTTP transport, JSON answers, no event stream).

Connect

Server URL: https://carbonara-co2.org/mcp

Without an API key: up to 100 shipments per call and 2000 a day per connection. With a free account's key (sign in at https://carbonara-co2.org): 100000 shipments a day.

Tools

calculate_shipment: Calculate a shipment's emissions
Calculates one shipment's greenhouse gas emissions (kg CO2e: well-to-wheel, tank-to-wheel, well-to-tank) following the GLEC Framework v3.2 and ISO 14083. Routes each leg's distance from its coordinates or codes. Returns the result per leg (distance and how it was found, method, data type, emission factor and its source, distance adjustment, notes on legs Carbonara added) and a step-by-step calculation sheet with the arithmetic and the GLEC page and ISO 14083 clause behind each step.
calculate_shipments: Calculate many shipments
Calculates several shipments at once, each like calculate_shipment. A failing shipment doesn't stop the others; each failure says why and whether sending it again can help. Set explain to add calculation sheets (first 25 shipments).
emissions_report: Emissions report over many shipments
Calculates shipments and returns a report with the basic content ISO 14083 asks for at the level of transport services (GLEC v3.2 Section 2 Ch.1): coverage and failures, totals split into TTW and WTT, intensity, per mode and hub type, energy carriers, data quality (primary/modelled/default shares, sources, models), distance adjustments, and notes. Returned as Markdown and as structured data.
find_places: Find places
Finds cities, sea and inland ports, rail and road terminals, inland depots, border crossings and airports by name, UN/LOCODE or IATA code, with coordinates, from an embedded list (GeoNames, UN/LOCODE, OurAirports). Use it to fill a leg's from and to.
list_vehicle_types: List vehicle types and emission factors
Lists the vehicle types (and their short aliases) with their emission factors: g CO2e per tonne-km tank-to-wheel and well-to-tank, the distance type they are per, source and year, and for trucks the load model's payload (what load_factor 1 means). Optionally the fuels for the fuel method.
get_methodology: How Carbonara calculates
Explains the whole method: scope (WTW, TTW, WTT), inputs, the four calculation methods with formulas, how distances are routed, distance adjustment factors, added road legs, the emission factor datasets and their sources and limitations, data quality, what every result field means, errors, and how to present results.

The methodology is also a resource, carbonara://methodology. Results are calculations following GLEC and ISO 14083, not certified figures. Source code of the calculator: github.com/majidkabir/carbonara.