estimate_emissions

Pack: climatiq · Endpoint: https://gateway.pipeworx.io/climatiq/mcp

Calculate kgCO₂e for an activity. Pass an emission_factor with at minimum activity_id (from search_factors) or id, plus the required parameters (e.g., { energy: 200, energy_unit: "kWh" }). Returns CO₂e + breakdown.

Parameters

NameTypeRequiredDescription
emission_factorobjectyesSelector object — at minimum {activity_id: ”…”} or {id: ”…”}. May add region, year, source for disambiguation.
parametersobjectyesActivity quantities matching the factor’s required unit type (e.g., {energy:200, energy_unit:“kWh”}).

Example call

curl -X POST https://gateway.pipeworx.io/climatiq/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"estimate_emissions","arguments":{}}}'

Response shape

Always returns: co2e, co2e_unit, calculation_method, calculation_origin, emission_factor, constituent_gases, activity_data, audit_trail

FieldTypeDescription
co2enumber | nullCalculated CO2 equivalent in kg
co2e_unitstringUnit of CO2e measurement
calculation_methodstring | nullMethod used for calculation
calculation_originstring | nullOrigin/source of the calculation
emission_factorobject | nullThe resolved emission factor used
constituent_gasesobject | nullBreakdown of constituent greenhouse gases
activity_dataobject | nullActivity data used in calculation
audit_trailstring | nullAudit trail for the calculation
Full JSON Schema
{
  "type": "object",
  "properties": {
    "co2e": {
      "type": [
        "number",
        "null"
      ],
      "description": "Calculated CO2 equivalent in kg"
    },
    "co2e_unit": {
      "type": "string",
      "description": "Unit of CO2e measurement"
    },
    "calculation_method": {
      "type": [
        "string",
        "null"
      ],
      "description": "Method used for calculation"
    },
    "calculation_origin": {
      "type": [
        "string",
        "null"
      ],
      "description": "Origin/source of the calculation"
    },
    "emission_factor": {
      "type": [
        "object",
        "null"
      ],
      "description": "The resolved emission factor used"
    },
    "constituent_gases": {
      "type": [
        "object",
        "null"
      ],
      "description": "Breakdown of constituent greenhouse gases"
    },
    "activity_data": {
      "type": [
        "object",
        "null"
      ],
      "description": "Activity data used in calculation"
    },
    "audit_trail": {
      "type": [
        "string",
        "null"
      ],
      "description": "Audit trail for the calculation"
    }
  },
  "required": [
    "co2e",
    "co2e_unit",
    "calculation_method",
    "calculation_origin",
    "emission_factor",
    "constituent_gases",
    "activity_data",
    "audit_trail"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "climatiq": {
      "url": "https://gateway.pipeworx.io/climatiq/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build May 21, 2026