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

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

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

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

<Note>
  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.
</Note>

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

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

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

<Note>
  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.
</Note>

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

<Accordion title="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              |
</Accordion>

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

<CardGroup cols={2}>
  <Card title="Emissions" icon="smog" href="/mcp/emissions">
    Organization-level GHG emissions (complementary to product-level LCA)
  </Card>

  <Card title="Projects" icon="folder-open" href="/mcp/projects">
    Projects that LCA portfolios are organized under
  </Card>

  <Card title="Facilities" icon="building" href="/mcp/facilities">
    Manufacturing sites where LCA products are produced
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/lca/overview">
    REST API endpoints for Life Cycle Assessment
  </Card>
</CardGroup>