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

# Decarbonization Plan Tools

> MCP tools for querying decarbonization plans, targets, and actions

# Decarbonization Plan Tools

Query decarbonization plans — reduction targets, planned actions, baseline emissions, and organizational scope perimeters. Plans define emission reduction strategies against a baseline year, with targets specifying scope-level reduction percentages and actions tracking the concrete initiatives to achieve them.

<Note>
  Some targets and actions include `ai_rationale` and `supporting_sources` fields — these are generated by **Leia**, Dcycle's AI assistant, when it proposes targets or actions. Manually created items will have these fields as null.
</Note>

## `list_decarb_plans`

List decarbonization plans for the organization, optionally filtered by project.

**Parameters:**

| Parameter         | Type   | Required | Default     | Description                   |
| ----------------- | ------ | -------- | ----------- | ----------------------------- |
| `organization_id` | string | No       | default org | Organization UUID             |
| `project_id`      | string | No       | —           | Filter by linked project UUID |

**Example response:**

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "plan-1a2b3c4d-...",
  "project_id": "proj-5e6f7a8b-...",
  "status": "in_progress",
  "base_year": 2023,
  "target_year": 2030,
  "included_scopes": [1, 2, 3],
  "reporting_period_start_month": 1,
  "reporting_period_end_month": 12,
  "strategic_priorities": "Focus on fleet electrification and renewable energy procurement...",
  "budget": 500000,
  "currency_unit_id": "cur-1a2b3c4d-...",
  "config_review_status": "reviewed",
  "created_by": "u-1a2b3c4d-...",
  "report_file_id": null,
  "created_at": "2025-01-10T09:00:00",
  "updated_at": "2025-06-15T11:30:00"
}
```

**Key response fields:**

| Field                       | Description                                            |
| --------------------------- | ------------------------------------------------------ |
| `status`                    | Plan lifecycle: `draft`, `in_progress`, or `completed` |
| `base_year` / `target_year` | Baseline and target years for the reduction plan       |
| `included_scopes`           | GHG Protocol scopes covered (e.g. `[1, 2, 3]`)         |
| `strategic_priorities`      | AI-generated strategic priority summary                |
| `budget`                    | Total allocated budget for the plan                    |

## `get_decarb_plan`

Get baseline emissions data for a decarbonization plan — the actual carbon footprint numbers used as the starting point for reduction calculations.

**Parameters:**

| Parameter         | Type   | Required | Default     | Description                      |
| ----------------- | ------ | -------- | ----------- | -------------------------------- |
| `plan_id`         | string | **Yes**  | —           | UUID of the decarbonization plan |
| `organization_id` | string | No       | default org | Organization UUID                |

**Example response:**

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "base_year": 2023,
  "included_scopes": [1, 2, 3],
  "approach": "operational",
  "site_tco2e": 1245.8,
  "group_tco2e": 3890.2
}
```

**Key response fields:**

| Field         | Description                                              |
| ------------- | -------------------------------------------------------- |
| `site_tco2e`  | Primary company (root org) standalone footprint in tCO2e |
| `group_tco2e` | Consolidated footprint across the entire org perimeter   |
| `approach`    | Consolidation approach (always `operational`)            |

<Note>
  `site_tco2e` and `group_tco2e` are null when the plan's baseline year or included scopes are not yet configured.
</Note>

## `list_decarb_targets`

List reduction targets defined in a decarbonization plan. Each target specifies emission scopes, a reduction percentage, and a target year.

**Parameters:**

| Parameter         | Type   | Required | Default     | Description                      |
| ----------------- | ------ | -------- | ----------- | -------------------------------- |
| `plan_id`         | string | **Yes**  | —           | UUID of the decarbonization plan |
| `organization_id` | string | No       | default org | Organization UUID                |

**Example response:**

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
[
  {
    "id": "tgt-1a2b3c4d-...",
    "decarbonization_plan_id": "plan-1a2b3c4d-...",
    "organization_id": "a1b2c3d4-...",
    "scope": [1, 2],
    "target_type": "absolute",
    "base_year": 2023,
    "target_year": 2030,
    "base_emissions": 1245.8,
    "reduction_percentage": 42.0,
    "ai_rationale": "Based on SBTi 1.5°C pathway for the transport sector...",
    "supporting_sources": [{"type": "sbti", "reference": "1.5C-transport-2030"}],
    "status": "accepted",
    "created_at": "2025-01-15T10:00:00",
    "updated_at": "2025-02-01T14:30:00"
  }
]
```

**Key response fields:**

| Field                  | Description                                                      |
| ---------------------- | ---------------------------------------------------------------- |
| `scope`                | GHG scopes this target covers (e.g. `[1, 2]`)                    |
| `target_type`          | `absolute` (total reduction) or `intensity` (per-unit reduction) |
| `base_emissions`       | Baseline emissions in tCO2e for the target scopes                |
| `reduction_percentage` | Target reduction (0–100), e.g. `42.0` = 42% reduction            |
| `status`               | `proposed` (by Leia), `accepted`, or `rejected`                  |
| `ai_rationale`         | Leia's reasoning for the proposed values (null if manual)        |

## `list_decarb_actions`

List planned decarbonization actions and their progress. Actions are concrete initiatives linked to a specific target.

**Parameters:**

| Parameter         | Type   | Required | Default     | Description                      |
| ----------------- | ------ | -------- | ----------- | -------------------------------- |
| `plan_id`         | string | **Yes**  | —           | UUID of the decarbonization plan |
| `organization_id` | string | No       | default org | Organization UUID                |

**Example response:**

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
[
  {
    "id": "act-1a2b3c4d-...",
    "decarbonization_plan_id": "plan-1a2b3c4d-...",
    "decarbonization_target_id": "tgt-1a2b3c4d-...",
    "organization_id": "a1b2c3d4-...",
    "title": "Install solar panels at Madrid warehouse",
    "description": "150kW rooftop PV installation covering 60% of facility electricity demand",
    "scope": [2],
    "estimated_co2e_reduction": 85.3,
    "estimated_cost": 120000,
    "payback_period_months": 72,
    "npv": 45000,
    "priority": "medium_term",
    "status": "in_progress",
    "approval_status": "approved",
    "initiative_type": "electricity",
    "emission_source": "electricity",
    "saved_quantity": "960 MWh/year",
    "funding_amount": 80000,
    "annual_saving": 18000,
    "launch_date": "2025-06-01",
    "source": "leia",
    "ai_rationale": "Facility has 2000m² available roof space with south exposure...",
    "created_at": "2025-01-20T09:00:00",
    "updated_at": "2025-06-10T16:00:00"
  }
]
```

**Key response fields:**

| Field                      | Description                                                                         |
| -------------------------- | ----------------------------------------------------------------------------------- |
| `estimated_co2e_reduction` | Expected tCO2e saved per year                                                       |
| `estimated_cost`           | Estimated implementation cost                                                       |
| `priority`                 | `quick_win`, `medium_term`, or `long_term`                                          |
| `status`                   | `proposed`, `accepted`, `in_progress`, `completed`, or `rejected`                   |
| `approval_status`          | Finance gate: `not_submitted`, `pending`, `approved`, or `rejected`                 |
| `initiative_type`          | Category: `heating`, `electricity`, `fleet`, `operational`, `suppliers`, or `other` |
| `source`                   | Origin: `leia` (AI-proposed), `imported`, or `manual`                               |

## `get_decarb_perimeter`

Get the organizational scope/perimeter snapshot for a decarbonization plan — which facilities, emission categories, and scopes are included.

**Parameters:**

| Parameter         | Type   | Required | Default     | Description                      |
| ----------------- | ------ | -------- | ----------- | -------------------------------- |
| `plan_id`         | string | **Yes**  | —           | UUID of the decarbonization plan |
| `organization_id` | string | No       | default org | Organization UUID                |

**Example response:**

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "plan_id": "plan-1a2b3c4d-...",
  "report_file_id": null,
  "snapshot": { ... },
  "generated_at": "2025-06-15T11:30:00",
  "status": "ready",
  "is_stale": false
}
```

**Key response fields:**

| Field            | Description                                                                               |
| ---------------- | ----------------------------------------------------------------------------------------- |
| `snapshot`       | Structured artifact snapshot defining the plan perimeter (facilities, scopes, categories) |
| `status`         | Artifact state: `draft`, `needs_input`, `ready`, or `stale`                               |
| `is_stale`       | Whether the snapshot is outdated compared to current plan data                            |
| `report_file_id` | File ID of the generated PDF report (null if not yet generated)                           |

**Example prompts:**

```
"List our decarbonization plans"
"What are the baseline emissions for our decarbonization plan?"
"What reduction targets do we have and are they on track?"
"Show all planned actions and their progress"
"Which actions have been approved by finance?"
"What's the estimated CO2 reduction from our solar panel initiative?"
"Which facilities are included in our decarbonization scope?"
```

## Workflow

1. **Discover plans** — `list_decarb_plans` to see available plans and their status
2. **Check baselines** — `get_decarb_plan` to see the actual carbon footprint baseline (site vs group)
3. **Review targets** — `list_decarb_targets` to see scope-level reduction goals and whether they're accepted
4. **Track actions** — `list_decarb_actions` to check initiative progress, costs, and approval status
5. **Understand scope** — `get_decarb_perimeter` to see which facilities and emission categories are included

## Related

<CardGroup cols={2}>
  <Card title="Emissions" icon="smog" href="/mcp/emissions">
    GHG emissions data that baselines are calculated from
  </Card>

  <Card title="Projects" icon="folder-open" href="/mcp/projects">
    Projects that decarbonization plans belong to
  </Card>

  <Card title="Facilities" icon="building" href="/mcp/facilities">
    Facilities included in the decarbonization perimeter
  </Card>
</CardGroup>