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

# Reference Resources

> Static reference data available as MCP resources for domain context

# Reference Resources

The MCP server exposes static reference data as [MCP Resources](https://modelcontextprotocol.io/docs/concepts/resources). Unlike tools (which you call with parameters), resources are pre-loaded context that helps the AI assistant understand sustainability domain concepts — GHG scopes, emission categories, industry sectors, and LCA stages.

<Note>
  Resources are automatically available to the AI assistant. You don't need to call them explicitly — they're loaded as context when the MCP connection starts.
</Note>

## `dcycle://scopes`

GHG Protocol scope definitions — the foundational framework for classifying greenhouse gas emissions.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "scope_1": {
    "name": "Scope 1 — Direct emissions",
    "description": "GHG emissions from sources owned or controlled by the organization. Examples: company vehicles, on-site fuel combustion, refrigerant leaks."
  },
  "scope_2": {
    "name": "Scope 2 — Indirect emissions (energy)",
    "description": "GHG emissions from purchased electricity, steam, heating, and cooling. Reported using market-based or location-based methods."
  },
  "scope_3": {
    "name": "Scope 3 — Other indirect emissions",
    "description": "All other indirect emissions in the value chain. Includes 15 categories: purchased goods, business travel, employee commuting, upstream/downstream transportation, waste, use of sold products, investments, etc."
  }
}
```

## `dcycle://categories`

GHG emission categories by scope — maps each emission category to its GHG Protocol scope.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
[
  { "scope": 1, "category": "Stationary combustion", "description": "Fuel burned in owned/controlled equipment" },
  { "scope": 1, "category": "Mobile combustion", "description": "Fuel burned in owned/controlled vehicles" },
  { "scope": 1, "category": "Fugitive emissions", "description": "Refrigerant leaks and other fugitive sources" },
  { "scope": 2, "category": "Purchased electricity", "description": "Electricity consumed by the organization" },
  { "scope": 3, "category": "Purchased goods and services", "description": "Upstream emissions from procurement" },
  { "scope": 3, "category": "Capital goods", "description": "Emissions from capital purchases" },
  { "scope": 3, "category": "Fuel and energy", "description": "Upstream emissions not in Scope 1/2" },
  { "scope": 3, "category": "Upstream transportation", "description": "Transport of purchased goods" },
  { "scope": 3, "category": "Waste", "description": "Disposal and treatment of waste" },
  { "scope": 3, "category": "Business travel", "description": "Employee travel for business" },
  { "scope": 3, "category": "Employee commuting", "description": "Employee travel to/from work" },
  { "scope": 3, "category": "Downstream transportation", "description": "Transport of sold products" },
  { "scope": 3, "category": "Use of sold products", "description": "Emissions from product use by customers" },
  { "scope": 3, "category": "Investments", "description": "Emissions from financial investments" }
]
```

## `dcycle://lca-stages`

EN 15804 life cycle stages used in LCA dashboards — defines the standard product lifecycle phases.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "A1": { "phase": "Production", "label": "Raw material supply" },
  "A2": { "phase": "Production", "label": "Transport to manufacturer" },
  "A3": { "phase": "Production", "label": "Manufacturing" },
  "A4": { "phase": "Downstream", "label": "Distribution" },
  "B6": { "phase": "Downstream", "label": "Operational energy use" },
  "B7": { "phase": "Downstream", "label": "Operational water use" }
}
```

## `dcycle://sectors`

Valid organization sector values in Dcycle — used when setting up organizations.

<Accordion title="All 25 sector values">
  Agriculture, Automotive, Banking & Finance, Chemicals, Construction, Consumer Goods, Education, Energy, Food & Beverage, Healthcare, Hospitality, Insurance, Logistics & Transport, Manufacturing, Mining, Pharmaceuticals, Public Sector, Real Estate, Retail, Technology, Telecommunications, Textiles, Utilities, Waste Management, Water
</Accordion>

## `dcycle://pivot-dimensions`

Available dimensions and metrics for emissions analysis. This resource is dynamic — it fetches the organization's pivot table configuration from the API, including available grouping dimensions and aggregation metrics.

<Note>
  This is the only dynamic resource. It requires an active connection with an organization configured. Returns an error object if the connection is not set up.
</Note>

## `dcycle://config`

Current MCP server connection configuration — useful for debugging connection issues.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "api_url": "https://api.dcycle.io",
  "api_key": "a1b2...wxyz",
  "org_id": "a1b2c3d4-..."
}
```

**Example prompts:**

```
"Using the GHG scope definitions, explain which of our data falls under each scope"
"What sector categories are available in Dcycle?"
"What LCA life cycle stages does Dcycle support?"
"What dimensions can I use for emissions analysis?"
```

## Related

<CardGroup cols={2}>
  <Card title="Emissions" icon="smog" href="/mcp/emissions">
    Tools that use scope/category context from these resources
  </Card>

  <Card title="LCA" icon="leaf" href="/mcp/lca">
    Tools that use EN 15804 stage definitions
  </Card>

  <Card title="Organizations" icon="building" href="/mcp/organizations">
    Organization setup where sector values are used
  </Card>
</CardGroup>