Coming Soon - The Dcycle MCP Server is in private beta.
Interested in AI integration? Contact us for early access. Overview
Emissions tools are the core of the MCP server, allowing natural language queries about your carbon footprint. All emissions data is reported in tCO2e (tonnes of CO2 equivalent).
get_emissions
Query emissions data with flexible filters.
Parameters
| Parameter | Type | Required | Description |
|---|
organization_id | string | Yes | Organization UUID |
start_date | string | No | Start date (YYYY-MM-DD) |
end_date | string | No | End date (YYYY-MM-DD) |
scope | integer | No | Filter by GHG scope (1, 2, or 3) |
category | string | No | Filter by emission category |
facility_id | string | No | Filter by specific facility |
Example Queries
"What are our total emissions for 2024?"
"Show me Scope 1 emissions from January to June 2024"
"Get emissions for our Madrid office"
Response
{
"organization_id": "ff4adcc7-8172-45fe-9cf1-e90a6de53aa9",
"period": {
"start_date": "2024-01-01",
"end_date": "2024-12-31"
},
"filters": {
"scope": null,
"category": null,
"facility_id": null
},
"emissions": {
"total": 1234.56,
"scope_1": 234.12,
"scope_2": 456.78,
"scope_3": 543.66
},
"unit": "tCO2e"
}
Use Cases
- Get total emissions for a reporting period
- Filter by scope for regulatory reporting
- Analyze specific facilities or categories
get_emissions_by_scope
Get a detailed breakdown by GHG Protocol scopes.
Parameters
| Parameter | Type | Required | Description |
|---|
organization_id | string | Yes | Organization UUID |
year | integer | Yes | Year to analyze (e.g., 2024) |
Example Query
"Break down our 2024 emissions by scope"
Response
{
"organization_id": "ff4adcc7-8172-45fe-9cf1-e90a6de53aa9",
"year": 2024,
"total_emissions_tco2e": 1234.56,
"scopes": {
"scope_1": {
"name": "Scope 1 - Direct Emissions",
"description": "Direct GHG emissions from owned or controlled sources",
"examples": ["company vehicles", "on-site fuel combustion", "refrigerant leaks"],
"total_tco2e": 234.12
},
"scope_2": {
"name": "Scope 2 - Indirect Energy",
"description": "Indirect GHG emissions from purchased electricity, steam, heating, and cooling",
"examples": ["electricity consumption", "district heating"],
"total_tco2e": 456.78
},
"scope_3": {
"name": "Scope 3 - Value Chain",
"description": "All other indirect emissions in the value chain",
"examples": ["business travel", "employee commuting", "purchased goods", "waste"],
"total_tco2e": 543.66
}
},
"unit": "tCO2e"
}
Use Cases
- Understand emission distribution across scopes
- Identify which scope contributes most to your footprint
- GHG Protocol compliance reporting
Scope 3 typically represents 70-90% of a company’s total emissions. This tool helps identify your biggest reduction opportunities.
get_emissions_by_category
Break down emissions by category within scopes.
Parameters
| Parameter | Type | Required | Description |
|---|
organization_id | string | Yes | Organization UUID |
year | integer | Yes | Year to analyze |
scope | integer | No | Optional scope filter (1, 2, or 3) |
Example Queries
"What are our emissions by category for 2024?"
"Show me the Scope 3 category breakdown"
Response
{
"organization_id": "ff4adcc7-8172-45fe-9cf1-e90a6de53aa9",
"year": 2024,
"scope_filter": 3,
"total_emissions_tco2e": 543.66,
"categories": [
{
"category": "Purchased goods and services",
"scope": 3,
"emissions_tco2e": 245.30
},
{
"category": "Employee commuting",
"scope": 3,
"emissions_tco2e": 123.45
},
{
"category": "Business travel",
"scope": 3,
"emissions_tco2e": 98.76
},
{
"category": "Upstream transportation",
"scope": 3,
"emissions_tco2e": 76.15
}
],
"unit": "tCO2e"
}
Use Cases
- Identify your biggest emission sources
- Prioritize reduction initiatives
- Detailed reporting by emission category
compare_emissions
Compare emissions between two years for progress tracking.
Parameters
| Parameter | Type | Required | Description |
|---|
organization_id | string | Yes | Organization UUID |
year | integer | Yes | Current/target year |
compare_year | integer | Yes | Baseline or comparison year |
scope | integer | No | Optional scope filter |
Example Queries
"Compare our 2024 emissions to our 2020 baseline"
"How do our Scope 1 emissions this year compare to last year?"
Response
{
"organization_id": "ff4adcc7-8172-45fe-9cf1-e90a6de53aa9",
"current_year": {
"year": 2024,
"total_tco2e": 1234.56,
"scopes": { "..." }
},
"comparison_year": {
"year": 2020,
"total_tco2e": 1500.00,
"scopes": { "..." }
},
"change": {
"absolute_tco2e": -265.44,
"percentage": -17.70,
"direction": "decrease"
},
"unit": "tCO2e"
}
Use Cases
- Track progress against reduction targets
- Compare to baseline year for reporting
- Identify trends over time
Common Workflows
Annual Emissions Report
User: "Give me a complete emissions overview for 2024"
Claude: Let me gather the emissions data for your organization.
Total emissions for 2024: 1,234.56 tCO2e
By Scope:
• Scope 1 (Direct): 234.12 tCO2e (19%)
• Scope 2 (Energy): 456.78 tCO2e (37%)
• Scope 3 (Value Chain): 543.66 tCO2e (44%)
Top 5 Categories:
1. Purchased goods: 245.30 tCO2e
2. Electricity: 456.78 tCO2e
3. Employee commuting: 123.45 tCO2e
4. Business travel: 98.76 tCO2e
5. Company vehicles: 156.89 tCO2e
Reduction Progress Check
User: "Are we on track with our 2030 reduction targets?"
Claude: Let me compare your current emissions to your baseline.
2024 vs 2020 Baseline:
• 2020: 1,500.00 tCO2e
• 2024: 1,234.56 tCO2e
• Reduction: 265.44 tCO2e (-17.7%)
For a 50% reduction by 2030, you need to reach 750 tCO2e.
Current trajectory suggests you're ahead of schedule.
Scope 3 Deep Dive
User: "Where should we focus our Scope 3 reduction efforts?"
Claude: Here's your Scope 3 breakdown for 2024:
1. Purchased goods: 245.30 tCO2e (45%)
→ Work with key suppliers on emission factors
2. Employee commuting: 123.45 tCO2e (23%)
→ Remote work policies, EV incentives
3. Business travel: 98.76 tCO2e (18%)
→ Video conferencing, rail vs air policies
4. Upstream transport: 76.15 tCO2e (14%)
→ Optimize logistics, choose low-carbon carriers
Next Steps
