`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

Name	Type	Required	Description
`emission_factor`	object	yes	Selector object — at minimum {activity_id: ”…”} or {id: ”…”}. May add region, year, source for disambiguation.
`parameters`	object	yes	Activity quantities matching the factor’s required unit type (e.g., {energy:200, energy_unit:“kWh”}).

Example call

Arguments

{
  "emission_factor": {
    "activity_id": "electricity-supply_grid_mix-2023"
  },
  "parameters": {
    "energy": 150,
    "energy_unit": "kWh"
  }
}

curl

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":{"emission_factor":{"activity_id":"electricity-supply_grid_mix-2023"},"parameters":{"energy":150,"energy_unit":"kWh"}}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('estimate_emissions', {
  "emission_factor": {
    "activity_id": "electricity-supply_grid_mix-2023"
  },
  "parameters": {
    "energy": 150,
    "energy_unit": "kWh"
  }
});

More examples

{
  "emission_factor": {
    "id": "9dc73201-e21b-45e3-a033-daac504400c3",
    "region": "GB"
  },
  "parameters": {
    "mass": 500,
    "mass_unit": "kg"
  }
}

Response shape

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

Field	Type	Description
`co2e`	number \| null	Calculated CO2 equivalent in kg
`co2e_unit`	string	Unit of CO2e measurement
`calculation_method`	string \| null	Method used for calculation
`calculation_origin`	string \| null	Origin/source of the calculation
`emission_factor`	object \| null	The resolved emission factor used
`constituent_gases`	object \| null	Breakdown of constituent greenhouse gases
`activity_data`	object \| null	Activity data used in calculation
`audit_trail`	string \| null	Audit 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.

estimate_emissions