LCA Tools

MCP tools for querying Life Cycle Assessment portfolios and environmental impact results

LCA Tools

Query Life Cycle Assessment (LCA) data — product portfolios with environmental impact results broken down by EN 15804 life cycle stages. Each LCA represents a product-level assessment covering raw materials (A1), transport (A2), manufacturing (A3), distribution (A4), and operational use (B6/B7).

list_lcas

List all LCA portfolios for the organization with pagination.

Parameters:

Parameter	Type	Required	Default	Description
organization_id	string	No	default org	Organization UUID
page	integer	No	1	Page number
size	integer	No	50	Results per page

Example response:

{
  "items": [
    {
      "id": "lca-1a2b3c4d-...",
      "organization_id": "a1b2c3d4-...",
      "name": "Ceramic Tile 60x60",
      "description": "Environmental assessment for standard ceramic floor tiles",
      "impact_categories": ["climate_change", "acidification", "ozone_depletion"],
      "unit_id": "m2",
      "value": 1.0,
      "start_date": "2024-01-01",
      "end_date": "2024-12-31",
      "status": "active",
      "created_at": "2024-03-15T10:00:00",
      "updated_at": "2025-01-20T14:30:00"
    }
  ],
  "total": 8,
  "page": 1,
  "size": 50
}

Key response fields:

Field	Description
impact_categories	Selected impact categories for this assessment (see list below)
unit_id / value	Functional unit (e.g. 1.0 m², 1.0 kg)
start_date / end_date	Assessment period
status	active, draft, or archived

get_lca_dashboard

Get calculated environmental impact results for an LCA, organized by EN 15804 life cycle stages. This is the main results view.

Parameters:

Parameter	Type	Required	Default	Description
lca_id	string	Yes	—	UUID of the LCA portfolio
organization_id	string	No	default org	Organization UUID
view	string	No	system	Allocation view: system, product_total, or product_unit
output_product_id	string	No	—	Co-product UUID (required for product_total / product_unit)

Example response:

{
  "meta": {
    "lca_id": "lca-1a2b3c4d-...",
    "product_name": "Ceramic Tile 60x60",
    "methodology_id": "meth-5e6f7a8b-...",
    "functional_unit_value": 1.0,
    "functional_unit_id": "m2",
    "view": "system",
    "selected_output_product_id": null,
    "allocation_method": null,
    "output_products": []
  },
  "stages": [
    {
      "stage": "A1",
      "phase": "Production",
      "label": "Raw material supply",
      "categories": [
        {
          "impact_category": "climate_change",
          "impact_value": 8.45,
          "impact_unit": "kg CO2-Eq",
          "top_contributors": [
            { "block_id": "blk-1a2b3c4d-...", "block_name": "Clay extraction", "impact_value": 5.2 },
            { "block_id": "blk-5e6f7a8b-...", "block_name": "Feldspar mining", "impact_value": 3.25 }
          ]
        },
        {
          "impact_category": "acidification",
          "impact_value": 0.032,
          "impact_unit": "mol H+-Eq",
          "top_contributors": []
        }
      ]
    },
    {
      "stage": "A3",
      "phase": "Production",
      "label": "Manufacturing",
      "categories": [
        {
          "impact_category": "climate_change",
          "impact_value": 12.8,
          "impact_unit": "kg CO2-Eq",
          "top_contributors": [
            { "block_id": "blk-9c0d1e2f-...", "block_name": "Kiln firing", "impact_value": 11.5 }
          ]
        }
      ]
    }
  ],
  "is_stale": false,
  "validation_errors": [],
  "calculation_warnings": []
}

Key response fields:

Field	Description
meta.view	Active view: system (whole system), product_total (allocated to one co-product), product_unit (per-unit of co-product)
meta.output_products	Available co-products with allocation factors (for multi-product LCAs)
stages[].stage	EN 15804 code: A1, A2, A3, A4, B6, B7
stages[].categories[].impact_value	Calculated impact value for the category
stages[].categories[].top_contributors	Blocks contributing most to this impact
is_stale	Whether results need recalculation due to data changes
validation_errors	Structural issues preventing calculation (missing materials, invalid conversions)
calculation_warnings	Per-category warnings when a calculation fails silently

For LCAs with co-products (multiple output products), use view=product_total or view=product_unit with output_product_id to see allocated impacts. The meta.output_products array lists available co-products and their allocation factors.

get_lca_block_impacts

Get impact values broken down by lifecycle block (process stage) for a specific impact category. Useful for identifying which manufacturing step has the highest environmental impact.

Parameters:

Parameter	Type	Required	Default	Description
lca_id	string	Yes	—	UUID of the LCA portfolio
organization_id	string	No	default org	Organization UUID
impact_category	string	No	—	Impact category filter (e.g. climate_change)

Example response:

{
  "items": [
    {
      "block_id": "blk-9c0d1e2f-...",
      "sum_total_impact": 11.5,
      "impact_general_unit_id": "climate_change",
      "impact_specific_unit": "kg CO2-Eq"
    },
    {
      "block_id": "blk-1a2b3c4d-...",
      "sum_total_impact": 5.2,
      "impact_general_unit_id": "climate_change",
      "impact_specific_unit": "kg CO2-Eq"
    }
  ]
}

get_lca_piece_impacts

Get impact values broken down by material/piece within the LCA. Useful for identifying which raw materials contribute most to environmental impact.

Parameters:

Parameter	Type	Required	Default	Description
lca_id	string	Yes	—	UUID of the LCA portfolio
organization_id	string	No	default org	Organization UUID
impact_category	string	No	—	Impact category filter

Example response:

{
  "blocks": [
    {
      "block_id": "blk-1a2b3c4d-...",
      "pieces": [
        {
          "piece_id": "pce-5e6f7a8b-...",
          "piece_name": "Red clay",
          "impact_value": 3.8,
          "impact_unit": "kg CO2-Eq"
        },
        {
          "piece_id": "pce-9c0d1e2f-...",
          "piece_name": "Feldspar",
          "impact_value": 1.4,
          "impact_unit": "kg CO2-Eq"
        }
      ]
    }
  ]
}

validate_lca

Run validation checks on an LCA portfolio. Returns whether the LCA configuration is complete.

Parameters:

Parameter	Type	Required	Default	Description
lca_id	string	Yes	—	UUID of the LCA portfolio
organization_id	string	No	default org	Organization UUID

For detailed validation information, prefer get_lca_dashboard — its validation_errors array provides structured error codes (no_materials, invalid_conversions, missing_transport_data, pending_distances) with affected pieces listed.

Life Cycle Stages (EN 15804)

Stage	Phase	Description
A1	Production	Raw material supply
A2	Production	Transport to manufacturer
A3	Production	Manufacturing
A4	Downstream	Distribution
B6	Downstream	Operational energy use
B7	Downstream	Operational water use

Impact categories (36)

Climate change indicators:

Category	Description
climate_change	Total climate change (kg CO2-Eq)
climate_change_GHG	Climate change — greenhouse gases
climate_change_fossil	Climate change — fossil sources
climate_change_biogenic	Climate change — biogenic sources
climate_change_land_use	Climate change — land use

Environmental indicators:

Category	Description
acidification	Acidification (mol H+-Eq)
ozone_depletion	Ozone layer depletion
eutrophication_freshwater	Freshwater eutrophication
eutrophication_marine	Marine eutrophication
eutrophication_terrestrial	Terrestrial eutrophication
photochemical_oxidant_formation_human	Photochemical ozone formation
particulate_matter_formation	Particulate matter
human_toxicity_carcinogenic	Human toxicity — carcinogenic
human_toxicity_non_carcinogenic	Human toxicity — non-carcinogenic
ecotoxicity_freshwater	Freshwater ecotoxicity
ionising_radiation	Ionising radiation
land_use	Land use
water_scarcity	Water scarcity

Resource use indicators:

Category	Description
fossil_fuels_depletion	Fossil fuel depletion
material_resources_depletion	Mineral and metal depletion
renewable_energy_resources	Renewable primary energy use
non_renewable_energy_resources	Non-renewable primary energy use
use_net_fresh_water	Net fresh water use
use_secondary_material	Use of secondary material
use_renewable_secondary_fuels	Use of renewable secondary fuels
use_non_renewable_secondary_fuels	Use of non-renewable secondary fuels

Waste indicators:

Category	Description
hazardous_waste	Hazardous waste disposed
non_hazardous_waste	Non-hazardous waste disposed
high_level_radioactive_waste	High-level radioactive waste
int_low_level_radioactive_waste	Intermediate/low-level radioactive waste

Output flow indicators:

Category	Description
components_re_use	Components for re-use
materials_recycling	Materials for recycling
materials_energy_recovery	Materials for energy recovery
exported_energy_electricity	Exported energy — electricity
exported_energy_heat	Exported energy — heat
recovered_energy	Recovered energy

Example prompts:

"List my LCA portfolios"
"What are the climate change impacts for my ceramic tile LCA?"
"Compare A1 vs A3 stage impacts — where does the most CO2 come from?"
"Show per-unit environmental impacts for product xyz in LCA abc-123"
"Which materials have the highest climate change impact?"
"Is my LCA complete and valid?"
"What's the total acidification impact across all stages?"

Workflow

1. Discover LCAs — list_lcas to see available portfolios and their status
2. View results — get_lca_dashboard for the full impact breakdown by EN 15804 stage
3. Drill into blocks — get_lca_block_impacts with impact_category=climate_change to see which process step dominates
4. Drill into materials — get_lca_piece_impacts to identify which raw materials drive the most impact
5. Check validity — validate_lca or check validation_errors in the dashboard response
6. Co-product analysis — For multi-product LCAs, use view=product_unit with output_product_id for per-unit impacts

Related

Emissions

Organization-level GHG emissions (complementary to product-level LCA)

Projects

Projects that LCA portfolios are organized under

Facilities

Manufacturing sites where LCA products are produced

API Reference

REST API endpoints for Life Cycle Assessment