> ## Documentation Index
> Fetch the complete documentation index at: https://code.dcycle.io/llms.txt
> Use this file to discover all available pages before exploring further.

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

<Note>
  `facility_id` is required — call `list_facilities` first to get valid IDs.
</Note>

**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:**

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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

<CardGroup cols={2}>
  <Card title="API: List Wastes" icon="code" href="/api-reference/wastes/list">
    REST API equivalent with additional filters
  </Card>

  <Card title="Facilities" icon="building" href="/mcp/facilities">
    Find facility IDs to query waste records
  </Card>

  <Card title="Emissions" icon="smog" href="/mcp/emissions">
    Aggregated Scope 3 waste emissions
  </Card>

  <Card title="CLI" icon="terminal" href="/cli/assets">
    Manage waste records from the command line
  </Card>
</CardGroup>