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

# CSRD Tools

> MCP tools for querying CSRD/ESRS compliance data — double materiality, IROs, disclosures

# CSRD Tools

Query CSRD (Corporate Sustainability Reporting Directive) compliance data — double materiality assessments, IROs (Impacts, Risks and Opportunities), and their scores. These tools support ESRS reporting workflows.

<Note>
  CSRD tools cover the **governance and compliance** pillar. For environmental emissions use the [Emissions tools](/mcp/emissions), and for social workforce data use the [Workforce tools](/mcp/workforce).
</Note>

## `list_double_materiality`

List CSRD Double Materiality assessment topics with their scores. Each topic represents a sustainability matter assessed for both impact materiality and financial materiality — the core of CSRD/ESRS reporting.

**Parameters:**

| Parameter         | Type    | Required | Default     | Description                                           |
| ----------------- | ------- | -------- | ----------- | ----------------------------------------------------- |
| `organization_id` | string  | No       | default org | Organization UUID                                     |
| `year`            | integer | No       | —           | Filter by assessment year                             |
| `lang`            | string  | No       | EN          | Language for topic names (`EN` or `ES`)               |
| `material`        | boolean | No       | —           | Filter by materiality status (`true` = material only) |
| `page`            | integer | No       | 1           | Page number                                           |
| `size`            | integer | No       | 50          | Results per page (max 200)                            |

**Example response:**

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "items": [
    {
      "id": "a1b2c3d4-...",
      "csrd_sustainability_matter_id": "b2c3d4e5-...",
      "esg_category": "environmental",
      "topic": "Climate change",
      "name": "GHG emissions",
      "material": true,
      "being_measured": true,
      "impact_score": 85.0,
      "financial_score": 70.0
    }
  ],
  "total": 42,
  "page": 1,
  "size": 50
}
```

**Key response fields:**

| Field             | Description                                                    |
| ----------------- | -------------------------------------------------------------- |
| `esg_category`    | ESG pillar: `environmental`, `social`, or `governance`         |
| `topic`           | ESRS topic group (e.g. "Climate change", "Own workforce")      |
| `name`            | Specific sustainability matter name                            |
| `material`        | Whether this topic is considered material for the organization |
| `being_measured`  | Whether data collection is active for this topic               |
| `impact_score`    | Impact materiality score (0–100)                               |
| `financial_score` | Financial materiality score (0–100)                            |

**Example prompts:**

```
"Show all material sustainability topics"
"What are our double materiality scores for 2025?"
"Which environmental topics are considered material?"
"List all topics with an impact score above 70"
```

***

## `list_csrd_iros`

List IROs (Impacts, Risks and Opportunities) linked to sustainability matters from the Double Materiality assessment. Each IRO describes a specific impact, risk, or opportunity identified during the CSRD assessment process.

**Parameters:**

| Parameter         | Type    | Required | Default     | Description                |
| ----------------- | ------- | -------- | ----------- | -------------------------- |
| `year`            | integer | **Yes**  | —           | Assessment year            |
| `organization_id` | string  | No       | default org | Organization UUID          |
| `page`            | integer | No       | 1           | Page number                |
| `size`            | integer | No       | 50          | Results per page (max 200) |

**Example response:**

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "items": [
    {
      "id": "f1e2d3c4-...",
      "sustainability_matter_id": "a1b2c3d4-...",
      "description": "Physical risks from extreme weather events affecting facilities",
      "type": "risk",
      "measurement_campaign_id": "e5f6a7b8-...",
      "score": 72
    }
  ],
  "total": 15,
  "page": 1,
  "size": 50
}
```

**Key response fields:**

| Field                      | Description                                            |
| -------------------------- | ------------------------------------------------------ |
| `sustainability_matter_id` | Links to a Double Materiality topic                    |
| `description`              | Free-text description of the IRO                       |
| `type`                     | IRO classification: `impact`, `risk`, or `opportunity` |
| `measurement_campaign_id`  | Links to the measurement campaign                      |
| `score`                    | Assessment score for this IRO                          |

**Example prompts:**

```
"List all IROs for 2025"
"What risks were identified in this year's CSRD assessment?"
"Show opportunities linked to our material topics"
"What is the highest-scored impact?"
```

***

## `get_csrd_output_data`

Get all ESRS disclosure requirements with their datapoints, grouped by disclosure requirement code (e.g. E1-1, S1-6, G1-1). Each requirement includes reporting status, measurement state, and individual datapoints.

**Parameters:**

| Parameter         | Type   | Required | Default     | Description                     |
| ----------------- | ------ | -------- | ----------- | ------------------------------- |
| `organization_id` | string | No       | default org | Organization UUID               |
| `start_date`      | string | No       | —           | Filter from date (`YYYY-MM-DD`) |
| `end_date`        | string | No       | —           | Filter to date (`YYYY-MM-DD`)   |

**Example response:**

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "E1-1": {
    "disclosure_requirement_code": "E1-1",
    "dr_name": "Transition plan for climate change mitigation",
    "dr_type": "disclosure",
    "esg_category": "environmental",
    "esg_subcategory": "climate_change",
    "report": true,
    "measuring": "complete",
    "datapoints": [
      {
        "id": "a1b2c3d4-...",
        "datapoint_id": "E1-1-01",
        "name_dcycle": "GHG emission reduction targets",
        "csrd_data_type": "quantitative",
        "mandatory_by": ["ESRS E1"],
        "mdr_datapoint": false,
        "calculating": false,
        "report": true,
        "measuring": "complete"
      }
    ]
  }
}
```

**Example prompts:**

```
"Show all CSRD disclosure requirements"
"Which E1 climate disclosures are we reporting?"
"What datapoints are still not being measured?"
```

***

## `list_measurement_campaigns`

List measurement campaigns for an organization. Each campaign defines a reporting period used to collect CSRD/ESRS data — IROs, survey results, and output data are linked to a specific campaign.

**Parameters:**

| Parameter         | Type   | Required | Default     | Description       |
| ----------------- | ------ | -------- | ----------- | ----------------- |
| `organization_id` | string | No       | default org | Organization UUID |

**Example response:**

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
[
  {
    "id": "e5f6a7b8-...",
    "start_date": "2025-01-01",
    "end_date": "2025-12-31"
  },
  {
    "id": "b8a7f6e5-...",
    "start_date": "2024-01-01",
    "end_date": "2024-12-31"
  }
]
```

**Example prompts:**

```
"List all measurement campaigns"
"What reporting periods have been set up?"
"Which campaign covers 2025?"
```

***

## `list_csrd_survey_results`

List CSRD survey results — stakeholder materiality scores. Each result represents a stakeholder's assessment of a sustainability matter's impact and financial materiality, linked to a measurement campaign.

**Parameters:**

| Parameter         | Type    | Required | Default     | Description                             |
| ----------------- | ------- | -------- | ----------- | --------------------------------------- |
| `organization_id` | string  | No       | default org | Organization UUID                       |
| `year`            | integer | No       | —           | Filter by assessment year               |
| `lang`            | string  | No       | EN          | Language for topic names (`EN` or `ES`) |
| `page`            | integer | No       | 1           | Page number                             |
| `size`            | integer | No       | 50          | Results per page (max 200)              |

**Example response:**

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "items": [
    {
      "id": "d4e5f6a7-...",
      "organization_measurement_campaign_id": "e5f6a7b8-...",
      "csrd_sustainability_matter_id": "a1b2c3d4-...",
      "organization_id": "org-uuid-...",
      "impact_score": 75.0,
      "finance_score": 60.0,
      "esg_category": "environmental",
      "topic": "Climate change",
      "name": "GHG emissions"
    }
  ],
  "total": 120,
  "page": 1,
  "size": 50
}
```

**Key response fields:**

| Field                                  | Description                                            |
| -------------------------------------- | ------------------------------------------------------ |
| `organization_measurement_campaign_id` | Links to the measurement campaign                      |
| `csrd_sustainability_matter_id`        | Links to the sustainability matter                     |
| `impact_score`                         | Stakeholder's impact materiality score (0–100)         |
| `finance_score`                        | Stakeholder's financial materiality score (0–100)      |
| `esg_category`                         | ESG pillar: `environmental`, `social`, or `governance` |
| `topic`                                | ESRS topic group                                       |
| `name`                                 | Specific sustainability matter name                    |

**Example prompts:**

```
"Show all CSRD survey results for 2025"
"What are the average stakeholder scores by ESG category?"
"Which topics did stakeholders rate highest for financial materiality?"
```

## Workflow

1. **List campaigns** — `list_measurement_campaigns` to see available reporting periods
2. **Assess materiality** — `list_double_materiality` to see which topics are material
3. **Review IROs** — `list_csrd_iros` to see impacts, risks, and opportunities per topic
4. **Stakeholder input** — `list_csrd_survey_results` to see how stakeholders scored each topic
5. **Check disclosures** — `get_csrd_output_data` to see which requirements are being reported
6. **Check emissions** — Use `get_greenhouse_gas_emissions` for environmental data on material topics
7. **Track projects** — Use `list_projects` to see ESG improvement initiatives

## Related

<CardGroup cols={2}>
  <Card title="Emissions" icon="smog" href="/mcp/emissions">
    GHG emissions data for environmental materiality topics
  </Card>

  <Card title="Workforce" icon="people-group" href="/mcp/workforce">
    Own workforce data for social materiality topics
  </Card>

  <Card title="Projects" icon="clipboard-list" href="/mcp/projects">
    ESG projects linked to material topics
  </Card>

  <Card title="Organizations" icon="sitemap" href="/mcp/organizations">
    Organization hierarchy for group-level assessments
  </Card>
</CardGroup>
