Sootcase freight CO2e

io.github.majidkabirPublished by GitHub account majidkabirv1.2.0Updated Oct 25, 2026

Freight CO2e by road, rail, sea, inland waterway and air (GLEC, ISO 14083), every step shown

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Remote MCP server that calculates freight transport greenhouse gas emissions in kg CO2e by road, rail, sea, inland waterway and air, following GLEC v3.2 and ISO

What you can do
Calculate emissions for one shipment or many, with per-leg distance, method, data type and emission factors shown, plus optional calculation sheets citing GLEC pages and ISO clauses. Produce an ISO 14083-style emissions report over many shipments, with totals split into tank-to-wheel and well-to-tank, intensity, per-mode breakdown and data quality shares. Compare scenarios such as road to rail, electric trucks, other fuels or different loads, and get the difference and affected legs. Recommend lower-emission route alternatives, including rail, waterway, short sea, other ports and fuller loads. Look up cities, ports, terminals, border crossings and airports by name, UN/LOCODE or IATA code, or
When to use it
Use it when you need to estimate or report freight transport emissions for shipments, compare transport modes or carriers, or explore what-if changes such as shifting road legs to rail. It suits logistics, sustainability and supply-chain reporting work that should follow GLEC or ISO 14083 methods.
Requirements
A remote endpoint at sootcase.org over streamable HTTP; no local runtime or package. No authentication is required for basic use. An optional Authorization header with a Bearer API key from sootcase.org raises limits above 100 shipments per call or 2,000 per day.
Before you install
Results are calculations following GLEC and ISO 14083, not certified figures; do not present them as ISO 14083 conformity. Truck load_factor is a share of an average full load (17.9 t for an articulated truck), not rated payload, so pass load_tonnes when the actual tonnage is known. The optional API key is sent as an Authorization header.

Installation

In SourceWeft

  1. Open Sootcase freight CO2e in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.majidkabir%2Fsootcase/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "sootcase-freight-co2e": {
      "type": "http",
      "url": "https://sootcase.org/mcp"
    }
  }
}

Tools

8

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 Sootcase added) and a step-by-step calculation sheet with the arithmetic and the GLEC page and ISO 14083 clause behind each step.

Parametersidteuhubslegsrequiredweight_kgadd_road_legscontainer_loadteu_net_tonnes

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).

Parametersexplainshipmentsrequiredadd_road_legs

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.

Parameterstitleperiod_toreferenceshipmentsrequireddeclare_isoperiod_fromorganisationadd_road_legs

compare_scenario

What-if: shipments now vs with changes

Calculates the shipments as they are and with changes, with the same method (GLEC v3.2, ISO 14083), and returns both totals (TTW, WTT, WTW), the difference, per change how many shipments and legs it affected and the sources of its values, and per shipment notes. Changes: road_to_rail (defaults: road legs over 300 km, 30% of the cargo, from the EU Transport White Paper 2011; rail part over 100 km in a straight line, from Directive 92/106/EEC), electrify (needs the user's kwh_per_tkm, a grid country and the source), fuel_switch (hvo, b100, biomethane, biomethane_lng, cng, lng for diesel trucks), load. Results are scenarios, not reported emissions: say so to the user.

Parametersplanrequiredshipmentsrequiredadd_road_legs

recommend_routes

Route changes that lower emissions

For each shipment, tries road legs on rail, inland waterway and short sea, air legs by sea or rail, other sea ports and (when a load is given) fuller loads; calculates each alternative with the same method as the shipment (GLEC v3.2, ISO 14083) and returns those lower than now, best first, with totals per kind and per lane, the sources of the rules and the limitations. Rules (defaults, settable): road legs over 300 km (EU Transport White Paper 2011); rail, waterway or sea part over 100 km in a straight line, road to a waterway or sea port within 150 km, nearest rail terminal (Directive 92/106/EEC). It knows nothing about transit times, costs or whether a service runs: tell the user, and that results are scenarios, not reported emissions. The website's Recommendations page (/recommend) lets the user filter and pick interactively.

Parameterssettingsshipmentsrequired

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.

Parameterskindslimitqueryrequired

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.

Parametersmodesearchinclude_fuels

get_methodology

How Sootcase 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.

Takes no parameters.

Version history

2
  1. v1.2.0LatestOct 25, 2026
  2. v1.1.0Oct 22, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.