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

​
Overview

Vehicles tools allow you to query your organization’s fleet, including vehicle details and associated emissions. This is particularly useful for understanding Scope 1 emissions from company-owned vehicles and optimizing your fleet composition.

​
list_vehicles

List vehicles in an organization’s fleet.

​
Parameters

ParameterTypeRequiredDescription
organization_idstringYesOrganization UUID
statusstringNoFilter by status (active, inactive, sold)
vehicle_typestringNoFilter by vehicle type
pageintegerNoPage number (default: 1)
sizeintegerNoItems per page (default: 50)

​
Example Queries

"List all our vehicles"

"Show me the active trucks in our fleet"

"What electric vehicles do we have?"

​
Response

{
  "vehicles": [
    {
      "id": "veh-abc123",
      "plate": "1234 ABC",
      "type": "truck",
      "fuel_type": "diesel",
      "brand": "Mercedes",
      "model": "Actros",
      "year": 2021,
      "status": "active"
    },
    {
      "id": "veh-def456",
      "plate": "5678 DEF",
      "type": "van",
      "fuel_type": "electric",
      "brand": "Ford",
      "model": "E-Transit",
      "year": 2023,
      "status": "active"
    }
  ],
  "total": 2,
  "page": 1,
  "size": 50
}

​
Vehicle Types

TypeDescription
carPassenger vehicles
vanLight commercial vehicles
truckHeavy goods vehicles
motorcycleTwo-wheeled vehicles
busPassenger transport

​
Fuel Types

FuelScope 1 Category
dieselMobile combustion
gasolineMobile combustion
lpgMobile combustion
cngMobile combustion
electricScope 2 (if company electricity)
hybridPartial mobile combustion

​
get_vehicle

Get detailed information about a specific vehicle.

​
Parameters

ParameterTypeRequiredDescription
organization_idstringYesOrganization UUID
vehicle_idstringYesVehicle UUID

​
Example Query

"Show me details for vehicle 1234 ABC"

​
Response

{
  "id": "veh-abc123",
  "plate": "1234 ABC",
  "type": "truck",
  "fuel_type": "diesel",
  "brand": "Mercedes",
  "model": "Actros 1845",
  "year": 2021,
  "status": "active",
  "specs": {
    "engine_capacity_cc": 12800,
    "power_kw": 330,
    "euro_class": "Euro 6",
    "gross_weight_kg": 18000
  },
  "emissions_2024": {
    "total_tco2e": 45.67,
    "distance_km": 85000,
    "fuel_consumed_liters": 17000,
    "efficiency_l_per_100km": 20.0
  }
}

​
Use Cases

  • Check vehicle specifications and emissions class
  • Review individual vehicle performance
  • Verify fuel consumption data

​
get_vehicle_fleet_summary

Get a summary of the organization’s entire vehicle fleet.

​
Parameters

ParameterTypeRequiredDescription
organization_idstringYesOrganization UUID

​
Example Query

"Give me a summary of our vehicle fleet"

​
Response

{
  "organization_id": "ff4adcc7-8172-45fe-9cf1-e90a6de53aa9",
  "total_vehicles": 25,
  "by_type": {
    "truck": 10,
    "van": 12,
    "car": 3
  },
  "by_fuel": {
    "diesel": 18,
    "electric": 5,
    "gasoline": 2
  },
  "by_status": {
    "active": 22,
    "inactive": 2,
    "sold": 1
  },
  "fleet_emissions_tco2e": 234.56,
  "average_age_years": 3.5,
  "electrification_rate": 20.0
}

​
Use Cases

  • Quick overview of fleet composition
  • Track electrification progress
  • Understand fleet age and replacement planning

​
Common Workflows

​
Fleet Decarbonization Planning

User: "What's our fleet's emissions profile and electrification opportunity?"

Claude: Here's your fleet analysis:

Current Fleet Composition (25 vehicles):
• Diesel: 18 vehicles (72%) - 198.45 tCO2e
• Electric: 5 vehicles (20%) - 0 tCO2e (direct)
• Gasoline: 2 vehicles (8%) - 36.11 tCO2e

Total Fleet Emissions: 234.56 tCO2e

Electrification Opportunity:
If you replaced all 18 diesel vehicles with electric:
• Potential reduction: ~198 tCO2e (84% of fleet emissions)
• Break-even typically within 3-4 years

Recommended priority:
1. Replace high-mileage vans (best ROI)
2. Phase out older diesel trucks
3. Consider hybrid for long-haul routes

​
Identifying High Emitters

User: "Which vehicles are our biggest emitters?"

Claude: Top 5 Highest-Emitting Vehicles (2024):

1. 1234 ABC (Mercedes Actros) - 45.67 tCO2e
   85,000 km | 20.0 L/100km | Heavy goods transport

2. 2345 BCD (Scania R450) - 42.12 tCO2e
   78,000 km | 19.5 L/100km | Long-haul routes

3. 3456 CDE (MAN TGX) - 38.90 tCO2e
   72,000 km | 19.8 L/100km | Regional delivery

4. 4567 DEF (Iveco Daily) - 28.45 tCO2e
   45,000 km | 12.3 L/100km | Urban delivery

5. 5678 EFG (Ford Transit) - 24.30 tCO2e
   52,000 km | 9.8 L/100km | Last-mile delivery

These 5 vehicles account for 76% of your fleet emissions.

​
Fleet Efficiency Comparison

User: "How does our fleet efficiency compare to our goals?"

Claude: Fleet Efficiency Analysis:

By Vehicle Type (L/100km):
                    Actual    Target    Status
Trucks (heavy):     20.0      22.0      ✓ Better than target
Trucks (rigid):     14.5      15.0      ✓ On target
Vans:               9.8       9.0       ✗ Above target
Cars:               6.2       6.0       ✗ Slightly above

Overall fleet: 85% meeting efficiency targets

Improvement Actions:
1. Van driver training (eco-driving)
2. Route optimization for urban delivery
3. Consider downsizing company cars

​
Tips for Fleet Analysis

Track Distance

Ensure odometer readings are captured for accurate efficiency calculations.

Fuel vs Electric

Electric vehicles have zero Scope 1 emissions, but Scope 2 from charging should be considered.

Euro Class Matters

Euro 6 vehicles have lower emissions factors than older Euro classes.

Seasonal Variation

Fuel efficiency varies by season - cold weather typically increases consumption by 10-15%.

​
Next Steps

Operations Tools

Monitor data processing and health

Reference Resources

View reference data for fuel types and units