Waste Tools

MCP tools for querying waste records, treatment methods, and emissions (Scope 3)

Waste Tools

Query waste records for facilities — including waste types, quantities, treatment methods, transport distances, and CO₂e emissions. This is Scope 3 Category 5 (waste generated in operations) data.

list_wastes

List waste records for a specific facility.

facility_id is required — call list_facilities first to get valid IDs.

Parameters:

Parameter	Type	Required	Default	Description
facility_id	string	Yes	—	UUID of the facility
organization_id	string	No	default org	Organization UUID
status	string	No	—	Status filter: active, deleted
start_date	string	No	—	Filter from this date (YYYY-MM-DD)
end_date	string	No	—	Filter until this date (YYYY-MM-DD)
page	integer	No	1	Page number
size	integer	No	50	Results per page

Example response:

{
  "items": [
    {
      "id": "550e8400-...",
      "identification_name": "RSU-2024-001",
      "description": "Municipal solid waste from office building",
      "status": "active",
      "start_date": "2024-01-01",
      "end_date": "2024-03-31",
      "facility_id": "660e8400-...",
      "quantity": 1500.0,
      "total_km_to_waste_center": 25.0,
      "low_code": "20 03 01",
      "rd_code": "D1",
      "co2e": 312.5,
      "co2e_biomass": 0.0,
      "unit": {
        "id": "61743a63-...",
        "name": "kilogram_(kg)",
        "type": "weight"
      },
      "created_at": "2024-11-24T10:30:00Z"
    }
  ],
  "total": 23,
  "page": 1,
  "size": 50,
  "pages": 1
}

Key response fields:

Field	Description
identification_name	Internal reference code for the waste record
quantity	Amount of waste in the unit specified by unit.name
low_code	European Waste Catalogue (EWC/LER) code classifying the waste type
rd_code	Recovery (R) or Disposal (D) operation code
total_km_to_waste_center	Distance to the waste treatment center in km
co2e	Calculated CO₂e emissions in kg
co2e_biomass	CO₂e from biomass sources in kg
unit	Measurement unit (e.g. kilogram_(kg), tonne_(t))

Example prompts:

"Show waste records for our Madrid factory"
"What waste did facility abc-123 generate in 2024?"
"List active waste records for Q1 2025"
"How much CO₂ comes from our waste in each facility?"

Workflow

1. Find facilities — list_facilities to discover facility IDs
2. List waste records — list_wastes with the facility_id
3. View emissions — get_greenhouse_gas_emissions with category=wastes for aggregated waste emission totals

Related

API: List Wastes

REST API equivalent with additional filters

Facilities

Find facility IDs to query waste records

Emissions

Aggregated Scope 3 waste emissions

CLI

Manage waste records from the command line