LCA Tools

MCP tools for querying Life Cycle Assessment portfolios and impact results, and for building an LCA from your own data

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.

Building an LCA from your data

Your AI assistant can create an LCA for you from a bill of materials, a data-gathering spreadsheet or data you give it in the chat. It covers your product from its raw materials to your factory door: raw materials (A1), transport from your suppliers (A2, optional) and manufacturing (A3). Distribution, use and end of life are added in the Dcycle app.

How it works:

1. The assistant reads your file (or asks you for the data, bit by bit) and shows you what it understood.
2. You agree the plan together: how materials are grouped, which materials already exist in your catalog and which are new, whether Leia maps the new ones to emission factors, what the factory consumes and whether to include transport.
3. You approve the plan once, and the assistant creates the materials and the LCA.
4. You review the result in the Dcycle app: Leia’s matches, the transport estimate and any change you want.

The assistant follows the method returned by get_lca_build_guide (also available as the build_lca_from_file prompt). Write tools create real records in your organization and act with your user’s permissions.

Tool	What it does	Key parameters
get_lca_build_guide	The method: how to read the data, what to agree with you, the creation order	—
list_lca_materials	Your LCA resources with their ecoinvent activity, location, unit conversions and Leia status	search, material_type
search_ecoinvent_activities	Search ecoinvent 3.11 activities by name	search
get_ecoinvent_activity_locations	Locations of an activity, and the one suggested for a country	activity, country
create_lca_material	Create a resource with an explicit factor, or let Leia map it in the background	name, supplier, supplier_country, material_type, ecoinvent_activity + ecoinvent_location or leia_match_mode (full_auto, auto, manual)
link_lca_material	Give an existing resource an ecoinvent factor	material_id, activity, location
update_lca_material_location	Set a supplier address (used to estimate transport distances)	material_id, address, postal_code
add_lca_material_unit	Add a unit conversion (e.g. 1 kWh = 3.6 MJ), keeping the existing ones	material_id, unit_id, value
create_lca	Create an empty LCA; returns lca_id and process_block_id	name, start_date, end_date (YYYY-MM-DD), functional_unit_id
add_lca_material_block	Add a group of materials feeding the manufacturing process	lca_id, process_block_id, block_name, materials
set_lca_process_inputs	Set what the factory consumes per unit (energy, water, consumables, waste)	lca_id, process_block_id, inputs, country, address
add_lca_transport_block	Add transport from suppliers; distances are estimated in the background	lca_id, process_block_id, origin_block_ids
get_lca_transport	Per material: transport legs, the Dcycle estimate and your changes	lca_id, transport_block_id
set_lca_transport_legs	Set known transport modes and distances for a material	material_id, legs (toc, distance_km), scope
get_lca_calculation_errors	What does not compute yet (missing factor, unit conversion, transport pending)	lca_id
delete_lca	Delete an LCA; your catalog resources are kept	lca_id

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