Reference Resources

Coming Soon - The Dcycle MCP Server is in private beta. Interested in AI integration? Contact us for early access.

Overview

The MCP server exposes reference data as resources that Claude can read to understand the context and terminology used in Dcycle. Unlike tools (which query dynamic data), resources provide static reference information. Resources are accessed via URIs like dcycle://reference/scopes.

GHG Protocol Scopes

URI: dcycle://reference/scopes The three scopes defined by the GHG Protocol for categorizing greenhouse gas emissions.

{
  "scopes": [
    {
      "scope": 1,
      "name": "Direct Emissions",
      "description": "GHG emissions from sources owned or controlled by the company",
      "examples": [
        "Company vehicles",
        "On-site fuel combustion (boilers, furnaces)",
        "Refrigerant leaks",
        "Process emissions"
      ],
      "typical_percentage": "10-30%"
    },
    {
      "scope": 2,
      "name": "Indirect Energy Emissions",
      "description": "GHG emissions from the generation of purchased energy consumed by the company",
      "examples": [
        "Purchased electricity",
        "Purchased steam",
        "District heating and cooling"
      ],
      "typical_percentage": "10-40%"
    },
    {
      "scope": 3,
      "name": "Value Chain Emissions",
      "description": "All other indirect GHG emissions in the company's value chain",
      "categories": [
        "1. Purchased goods and services",
        "2. Capital goods",
        "3. Fuel and energy-related activities",
        "4. Upstream transportation",
        "5. Waste generated in operations",
        "6. Business travel",
        "7. Employee commuting",
        "8. Upstream leased assets",
        "9. Downstream transportation",
        "10. Processing of sold products",
        "11. Use of sold products",
        "12. End-of-life treatment",
        "13. Downstream leased assets",
        "14. Franchises",
        "15. Investments"
      ],
      "typical_percentage": "50-90%"
    }
  ]
}

Emission Categories

URI: dcycle://reference/emission-categories Categories of emissions tracked in Dcycle, mapped to GHG Protocol scopes.

{
  "categories": [
    {
      "name": "Stationary Combustion",
      "scope": 1,
      "description": "Fuel burned in fixed equipment",
      "examples": ["Natural gas boilers", "Diesel generators"]
    },
    {
      "name": "Mobile Combustion",
      "scope": 1,
      "description": "Fuel burned in company vehicles",
      "examples": ["Company cars", "Trucks", "Forklifts"]
    },
    {
      "name": "Fugitive Emissions",
      "scope": 1,
      "description": "Leaks from equipment",
      "examples": ["Refrigerant leaks", "SF6 from electrical equipment"]
    },
    {
      "name": "Purchased Electricity",
      "scope": 2,
      "description": "Electricity consumed at facilities",
      "calculation_methods": ["Location-based", "Market-based"]
    },
    {
      "name": "Purchased Heating/Cooling",
      "scope": 2,
      "description": "District heating and cooling",
      "examples": ["Steam", "Hot water", "Chilled water"]
    },
    {
      "name": "Business Travel",
      "scope": 3,
      "description": "Employee travel for work purposes",
      "examples": ["Flights", "Train", "Hotels", "Car rentals"]
    },
    {
      "name": "Employee Commuting",
      "scope": 3,
      "description": "Employees traveling to/from work",
      "examples": ["Car commute", "Public transport", "Cycling"]
    },
    {
      "name": "Purchased Goods",
      "scope": 3,
      "description": "Emissions from producing purchased goods",
      "methods": ["Spend-based", "Activity-based", "Supplier-specific"]
    },
    {
      "name": "Upstream Transportation",
      "scope": 3,
      "description": "Transportation of purchased goods",
      "examples": ["Supplier deliveries", "Third-party logistics"]
    },
    {
      "name": "Waste",
      "scope": 3,
      "description": "Disposal of waste from operations",
      "examples": ["Landfill", "Incineration", "Recycling"]
    }
  ]
}

Units

URI: dcycle://reference/units Units of measurement used in emissions calculations.

{
  "emissions_units": [
    {
      "code": "tCO2e",
      "name": "Tonnes of CO2 equivalent",
      "description": "Standard unit for greenhouse gas emissions",
      "conversions": {
        "kgCO2e": 1000,
        "MtCO2e": 0.000001
      }
    },
    {
      "code": "kgCO2e",
      "name": "Kilograms of CO2 equivalent",
      "description": "Used for smaller emission values"
    }
  ],
  "energy_units": [
    {
      "code": "kWh",
      "name": "Kilowatt-hour",
      "description": "Standard unit for electricity"
    },
    {
      "code": "MWh",
      "name": "Megawatt-hour",
      "description": "1,000 kWh"
    },
    {
      "code": "GJ",
      "name": "Gigajoule",
      "description": "Common for gas consumption"
    },
    {
      "code": "therm",
      "name": "Therm",
      "description": "US unit for natural gas"
    }
  ],
  "distance_units": [
    {
      "code": "km",
      "name": "Kilometer",
      "description": "Standard distance unit"
    },
    {
      "code": "mi",
      "name": "Mile",
      "description": "US/UK distance unit"
    },
    {
      "code": "nmi",
      "name": "Nautical mile",
      "description": "Used for shipping and aviation"
    }
  ],
  "mass_units": [
    {
      "code": "kg",
      "name": "Kilogram",
      "description": "Standard mass unit"
    },
    {
      "code": "t",
      "name": "Metric tonne",
      "description": "1,000 kg"
    },
    {
      "code": "lb",
      "name": "Pound",
      "description": "US/UK mass unit"
    }
  ],
  "volume_units": [
    {
      "code": "L",
      "name": "Liter",
      "description": "Standard liquid volume"
    },
    {
      "code": "gal",
      "name": "Gallon",
      "description": "US gallon (3.785 L)"
    },
    {
      "code": "m³",
      "name": "Cubic meter",
      "description": "Used for gas volume"
    }
  ]
}

Fuel Types

URI: dcycle://reference/fuel-types Common fuel types and their emission factors.

{
  "vehicle_fuels": [
    {
      "code": "diesel",
      "name": "Diesel",
      "emission_factor_kg_per_liter": 2.68,
      "common_vehicles": ["Trucks", "Vans", "Some cars"]
    },
    {
      "code": "gasoline",
      "name": "Gasoline/Petrol",
      "emission_factor_kg_per_liter": 2.31,
      "common_vehicles": ["Cars", "Motorcycles"]
    },
    {
      "code": "lpg",
      "name": "Liquefied Petroleum Gas",
      "emission_factor_kg_per_liter": 1.51,
      "common_vehicles": ["Converted vehicles", "Forklifts"]
    },
    {
      "code": "cng",
      "name": "Compressed Natural Gas",
      "emission_factor_kg_per_kg": 2.75,
      "common_vehicles": ["Buses", "Urban trucks"]
    },
    {
      "code": "electric",
      "name": "Electric",
      "emission_factor": "Grid-dependent (Scope 2)",
      "common_vehicles": ["EVs", "Hybrid vehicles"]
    },
    {
      "code": "hydrogen",
      "name": "Hydrogen",
      "emission_factor": "Production-dependent",
      "common_vehicles": ["Fuel cell vehicles"]
    }
  ],
  "facility_fuels": [
    {
      "code": "natural_gas",
      "name": "Natural Gas",
      "emission_factor_kg_per_kwh": 0.202
    },
    {
      "code": "heating_oil",
      "name": "Heating Oil",
      "emission_factor_kg_per_liter": 2.96
    },
    {
      "code": "coal",
      "name": "Coal",
      "emission_factor_kg_per_kg": 2.42
    },
    {
      "code": "biomass",
      "name": "Biomass",
      "emission_factor": "Often considered carbon neutral"
    }
  ]
}

Emission factors are approximate and vary by region and year. Dcycle uses country-specific and year-specific factors for accurate calculations.

Vehicle Types

URI: dcycle://reference/vehicle-types Vehicle classifications used in fleet management.

{
  "vehicle_types": [
    {
      "code": "car",
      "name": "Passenger Car",
      "typical_fuel_consumption": "6-10 L/100km",
      "typical_annual_emissions": "2-5 tCO2e"
    },
    {
      "code": "van",
      "name": "Van / Light Commercial",
      "weight_class": "< 3.5 tonnes",
      "typical_fuel_consumption": "8-12 L/100km",
      "typical_annual_emissions": "5-10 tCO2e"
    },
    {
      "code": "truck_rigid",
      "name": "Rigid Truck",
      "weight_class": "3.5-12 tonnes",
      "typical_fuel_consumption": "15-25 L/100km",
      "typical_annual_emissions": "15-40 tCO2e"
    },
    {
      "code": "truck_articulated",
      "name": "Articulated Truck",
      "weight_class": "> 12 tonnes",
      "typical_fuel_consumption": "25-35 L/100km",
      "typical_annual_emissions": "40-80 tCO2e"
    },
    {
      "code": "bus",
      "name": "Bus / Coach",
      "typical_fuel_consumption": "20-40 L/100km",
      "typical_annual_emissions": "30-60 tCO2e"
    },
    {
      "code": "motorcycle",
      "name": "Motorcycle",
      "typical_fuel_consumption": "3-6 L/100km",
      "typical_annual_emissions": "0.5-2 tCO2e"
    }
  ]
}

Facility Types

URI: dcycle://reference/facility-types Types of facilities tracked in Dcycle.

{
  "facility_types": [
    {
      "code": "office",
      "name": "Office",
      "typical_energy_intensity": "100-200 kWh/m²/year",
      "primary_emissions": ["Electricity", "Heating/Cooling"]
    },
    {
      "code": "warehouse",
      "name": "Warehouse / Distribution Center",
      "typical_energy_intensity": "50-150 kWh/m²/year",
      "primary_emissions": ["Electricity", "Heating", "Forklifts"]
    },
    {
      "code": "factory",
      "name": "Factory / Manufacturing",
      "typical_energy_intensity": "200-500+ kWh/m²/year",
      "primary_emissions": ["Electricity", "Process heat", "On-site combustion"]
    },
    {
      "code": "store",
      "name": "Retail Store",
      "typical_energy_intensity": "200-400 kWh/m²/year",
      "primary_emissions": ["Electricity", "Heating/Cooling", "Refrigeration"]
    },
    {
      "code": "datacenter",
      "name": "Data Center",
      "typical_energy_intensity": "500-2000+ kWh/m²/year",
      "primary_emissions": ["Electricity", "Cooling"]
    },
    {
      "code": "laboratory",
      "name": "Laboratory",
      "typical_energy_intensity": "300-800 kWh/m²/year",
      "primary_emissions": ["Electricity", "Ventilation", "Equipment"]
    }
  ]
}

Using Reference Data

Claude can read these resources to provide context-aware responses:

User: "What's the difference between Scope 1 and Scope 2?"

Claude: [Reads dcycle://reference/scopes]

Scope 1 (Direct Emissions):
Emissions from sources your company owns or controls.
Examples: Company vehicles, on-site boilers, refrigerant leaks.

Scope 2 (Indirect Energy):
Emissions from the generation of purchased energy you consume.
Examples: Electricity, district heating, steam.

Key distinction: Scope 1 = you burn the fuel. Scope 2 = someone else burns fuel to make your energy.

Getting Started

Tools Reference

Reference Data

Overview

GHG Protocol Scopes

Emission Categories

Units

Fuel Types

Vehicle Types

Facility Types

Using Reference Data

Next Steps

Overview

API Reference

Getting Started

Tools Reference

Reference Data

​Overview

​GHG Protocol Scopes

​Emission Categories

​Units

​Fuel Types

​Vehicle Types

​Facility Types

​Using Reference Data

​Next Steps

Overview

API Reference

Overview

GHG Protocol Scopes

Emission Categories

Units

Fuel Types

Vehicle Types

Facility Types

Using Reference Data

Next Steps