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

​
Overview

Facilities tools allow you to query physical locations (offices, warehouses, factories) and their associated emissions. This is useful for identifying emission hotspots and understanding energy consumption patterns across your organization.

​
list_facilities

List all facilities for an organization.

​
Parameters

ParameterTypeRequiredDescription
organization_idstringYesOrganization UUID
statusstringNoFilter by status (active, inactive, archived)
facility_typestringNoFilter by type (warehouse, office, factory, store, datacenter)
pageintegerNoPage number (default: 1)
sizeintegerNoItems per page (default: 50)

​
Example Queries

"List all our facilities"

"Show me all active warehouses"

"What offices do we have in our organization?"

​
Response

{
  "facilities": [
    {
      "id": "fac-abc123",
      "name": "Madrid Headquarters",
      "type": "office",
      "address": "Calle Mayor 1, Madrid, Spain",
      "country": "ES",
      "status": "active",
      "area_m2": 2500
    },
    {
      "id": "fac-def456",
      "name": "Barcelona Warehouse",
      "type": "warehouse",
      "address": "Zona Franca, Barcelona, Spain",
      "country": "ES",
      "status": "active",
      "area_m2": 8000
    }
  ],
  "total": 2,
  "page": 1,
  "size": 50
}

​
Facility Types

TypeDescription
officeCorporate offices, administrative buildings
warehouseStorage and distribution centers
factoryManufacturing facilities
storeRetail locations
datacenterIT infrastructure facilities

​
get_facility

Get detailed information about a specific facility.

​
Parameters

ParameterTypeRequiredDescription
organization_idstringYesOrganization UUID
facility_idstringYesFacility UUID

​
Example Query

"Show me details for our Madrid office"

​
Response

{
  "id": "fac-abc123",
  "name": "Madrid Headquarters",
  "type": "office",
  "address": {
    "street": "Calle Mayor 1",
    "city": "Madrid",
    "postal_code": "28013",
    "country": "ES"
  },
  "status": "active",
  "area_m2": 2500,
  "employee_capacity": 150,
  "energy_config": {
    "electricity_provider": "Iberdrola",
    "renewable_percentage": 60
  },
  "created_at": "2022-03-15T10:00:00Z"
}

​
Use Cases

  • Verify facility details before emissions analysis
  • Check energy configuration and renewable percentages
  • Understand facility capacity and size

​
get_facility_emissions

Get emissions data for a specific facility.

​
Parameters

ParameterTypeRequiredDescription
organization_idstringYesOrganization UUID
facility_idstringYesFacility UUID
start_datestringNoStart date (YYYY-MM-DD)
end_datestringNoEnd date (YYYY-MM-DD)

​
Example Queries

"What are the emissions for our Barcelona warehouse?"

"Show me the Madrid office emissions for Q1 2024"

​
Response

{
  "facility": {
    "id": "fac-abc123",
    "name": "Madrid Headquarters",
    "type": "office"
  },
  "period": {
    "start_date": "2024-01-01",
    "end_date": "2024-03-31"
  },
  "emissions": {
    "total_tco2e": 45.67,
    "breakdown": {
      "electricity": 32.45,
      "natural_gas": 8.12,
      "district_heating": 0,
      "water": 2.10,
      "waste": 3.00
    }
  },
  "energy_consumption": {
    "electricity_kwh": 125000,
    "natural_gas_kwh": 35000
  },
  "unit": "tCO2e"
}

​
Use Cases

  • Identify high-emission facilities
  • Track facility-level reduction progress
  • Compare energy efficiency across facilities

​
Common Workflows

​
Facility Emissions Ranking

User: "Which of our facilities has the highest emissions?"

Claude: Let me analyze all your facilities.

Facility Emissions Ranking (2024):

1. Valencia Factory: 456.78 tCO2e
   Type: Factory | Area: 15,000 m² | Intensity: 30.5 kgCO2e/m²

2. Barcelona Warehouse: 123.45 tCO2e
   Type: Warehouse | Area: 8,000 m² | Intensity: 15.4 kgCO2e/m²

3. Madrid Headquarters: 89.12 tCO2e
   Type: Office | Area: 2,500 m² | Intensity: 35.6 kgCO2e/m²

Your factory accounts for 68% of total facility emissions.

​
Energy Efficiency Analysis

User: "How efficient is our Madrid office compared to industry benchmarks?"

Claude: Here's the analysis for Madrid Headquarters:

Emissions intensity: 35.6 kgCO2e/m²/year

Comparison:
• Your office: 35.6 kgCO2e/m²
• Typical office (Spain): 45-55 kgCO2e/m²
• Best practice: 20-30 kgCO2e/m²

Your Madrid office performs 25% better than the typical Spanish office,
but there's still room to reach best practice levels through:
- Increased renewable electricity (currently 60%)
- LED lighting upgrades
- HVAC optimization

​
Quarterly Facility Review

User: "Give me a quarterly breakdown for our Barcelona warehouse"

Claude: Barcelona Warehouse - 2024 Quarterly Emissions:

Q1 (Jan-Mar): 28.45 tCO2e
Q2 (Apr-Jun): 31.23 tCO2e (+10%)
Q3 (Jul-Sep): 35.67 tCO2e (+14%)
Q4 (Oct-Dec): 27.89 tCO2e (-22%)

Analysis:
- Q3 peak likely due to cooling requirements
- Q4 reduction suggests successful efficiency measures

Annual total: 123.24 tCO2e
Primary source: Electricity (78%)

​
Tips for Facility Analysis

Normalize by Area

Compare facilities using emissions per m² to account for size differences.

Consider Facility Type

Factories typically have higher absolute emissions than offices - compare like with like.

Seasonal Patterns

Heating/cooling needs vary by season - look at full-year data for accurate comparisons.

Renewable Energy

Check each facility’s renewable energy percentage - this significantly impacts Scope 2.

​
Next Steps

Vehicles Tools

Analyze fleet emissions

Operations Tools

Monitor data health and jobs