Waste Water Treatment Tools

MCP tools for querying waste water treatment records — treatment types, flow volumes, and emissions

Waste Water Treatment Tools

Query waste water treatment (WWT) records — treatment types, discharge parameters, flow volumes, and associated CO2e emissions. Covers Scope 1 emissions from wastewater processing.

Waste water treatment tools require a facility_id. Call list_facilities first to get one. Records are scoped to a single facility.

list_waste_water_treatments

List waste water treatment records for a facility with enriched data (co2e, user, linked projects). Paginated.

Parameters:

Parameter	Type	Required	Default	Description
facility_id	string	Yes	—	Facility UUID. Call list_facilities first
start_date	string	No	—	Filter from date (YYYY-MM-DD)
end_date	string	No	—	Filter to date (YYYY-MM-DD)
status	string[]	No	—	Filter by record status (e.g. ["active"])
co2e_status	string	No	—	Filter: calculated or not_calculated
project_id	string	No	—	Filter by project UUID
sort	string	No	—	Sort field, prefix - for desc (e.g. -start_date)
page	integer	No	1	Page number
size	integer	No	50	Items per page (max 200)
organization_id	string	No	default org	Organization UUID

Example response:

{
  "items": [
    {
      "id": "wwt-uuid-...",
      "facility_id": "fac-uuid-...",
      "treatment_type": "aerobic",
      "start_date": "2025-01-01",
      "end_date": "2025-03-31",
      "flow_volume_m3": 12500.0,
      "population_equivalent": 5000,
      "co2e": 3.45,
      "co2e_status": "calculated",
      "status": "active",
      "created_by": {"id": "user-uuid", "name": "Ana Garcia"}
    }
  ],
  "total": 8,
  "page": 1,
  "size": 50
}

Key response fields:

Field	Description
treatment_type	Type of wastewater treatment (e.g. aerobic, anaerobic, lagoon)
flow_volume_m3	Volume of wastewater treated in cubic meters
population_equivalent	Population equivalent served by the treatment plant
co2e	Calculated CO2-equivalent emissions in tonnes
co2e_status	Whether emissions have been calculated: calculated or not_calculated

Example prompts:

"Show waste water treatments for facility X in Q1 2025"
"Which WWT records don't have calculated emissions yet?"
"List waste water treatments sorted by most recent first"

---

get_waste_water_treatment

Get full detail for a waste water treatment record — treatment type, flow volumes, discharge parameters, co2e breakdown, user info, and linked projects.

Parameters:

Parameter	Type	Required	Default	Description
wwt_id	string	Yes	—	WWT record UUID
organization_id	string	No	default org	Organization UUID

Example response:

{
  "id": "wwt-uuid-...",
  "facility_id": "fac-uuid-...",
  "treatment_type": "aerobic",
  "start_date": "2025-01-01",
  "end_date": "2025-03-31",
  "flow_volume_m3": 12500.0,
  "population_equivalent": 5000,
  "discharge_bod": 25.0,
  "discharge_cod": 120.0,
  "sludge_quantity_tonnes": 8.5,
  "co2e": 3.45,
  "co2e_breakdown": {
    "discharge": 1.2,
    "sludge": 0.8,
    "population": 0.95,
    "water": 0.5
  },
  "created_by": {"id": "user-uuid", "name": "Ana Garcia"},
  "linked_projects": [{"id": "proj-uuid", "name": "ISO 14064 2025"}]
}

Key response fields:

Field	Description
discharge_bod	Biochemical oxygen demand of discharge (mg/L)
discharge_cod	Chemical oxygen demand of discharge (mg/L)
sludge_quantity_tonnes	Quantity of sludge produced in tonnes
co2e_breakdown	Emissions split by sub-category (discharge, sludge, population, water)
linked_projects	Projects this record is associated with

Example prompts:

"Show the details for this waste water treatment record"
"What's the emissions breakdown for this WWT record?"
"Which projects is this waste water treatment linked to?"

---

Workflow

A typical workflow for analyzing waste water treatment data:

1. list_facilities — find the facility with wastewater operations
2. list_waste_water_treatments — list WWT records for that facility, filtering by date or status
3. get_waste_water_treatment — inspect a specific record’s co2e breakdown
4. get_greenhouse_gas_emissions with category="waste_water_treatment_*" — see validated emissions across all WWT sub-categories

Waste water treatment emissions are split into four GHG categories: waste_water_treatment_discharge, waste_water_treatment_population, waste_water_treatment_sludge, and waste_water_treatment_water. Use get_greenhouse_gas_emissions with a specific category to query validated totals.

Related

Emissions Tools

Query validated GHG emissions across all categories

Facilities Tools

List and manage facilities