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

​
Overview

Once available, the Dcycle MCP Server will integrate seamlessly with Claude Desktop and Claude Code, allowing you to query your sustainability data using natural language.

​
Prerequisites

  • Dcycle API Key - Get it from Settings > API
  • Claude Desktop or Claude Code

​
Installation

The Dcycle MCP Server will be available as a simple package install: 
# Install with pip
pip install dcycle-mcp

# Or run directly with uvx (no install needed)
uvx dcycle-mcp

​
Configuration

​
Claude Desktop

Add to your Claude Desktop configuration:
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
  "mcpServers": {
    "dcycle": {
      "command": "uvx",
      "args": ["dcycle-mcp"],
      "env": {
        "DCYCLE_API_KEY": "your_api_key"
      }
    }
  }
}

​
Claude Code

Add to ~/.claude/settings.json: 
{
  "mcpServers": {
    "dcycle": {
      "command": "uvx",
      "args": ["dcycle-mcp"],
      "env": {
        "DCYCLE_API_KEY": "your_api_key"
      }
    }
  }
}
After saving, restart Claude to load the MCP server.

​
Verify the Connection

Ask Claude a simple question to verify the connection: 
"List my Dcycle organizations"
Claude should return a list of organizations you have access to.

​
Example Queries

Once connected, try these queries to explore your data:

​
Organization Overview

"Give me a summary of my organization's carbon footprint"

​
Emissions by Scope

"Break down our 2024 emissions by Scope 1, 2, and 3"

​
Year-over-Year Comparison

"How do our emissions this year compare to last year?"

​
Facility Analysis

"Which facilities have the highest energy consumption?"

​
Fleet Overview

"Show me a summary of our vehicle fleet and fuel usage"

​
Data Health Check

"Are there any data processing issues I should know about?"

​
Tips for Better Results

Instead of “our emissions”, ask “our 2024 emissions” or “Q3 2024 emissions”.
If you have access to multiple organizations, specify which one: “emissions for Acme Corp”.
Claude maintains context. After getting emissions by scope, ask “break down Scope 3 by category”.
Ask for tables, comparisons, or summaries: “show this as a table” or “summarize the key findings”.

​
Troubleshooting

​
”MCP server not found”

  • Ensure you have Python 3.10+ installed
  • Verify uvx is available (install with pip install uv)
  • Check the configuration file syntax is valid JSON

​
”Authentication failed”

  • Verify your API key is correct and hasn’t expired
  • Ensure the DCYCLE_API_KEY environment variable is set in the config
  • Generate a new API key if needed at app.dcycle.io/settings/api

​
”Organization not found”

  • Your API key may not have access to that organization
  • Try “list my organizations” to see which ones you can access

​
Next Steps

Organization Tools

Explore organization management capabilities

Emissions Tools

Deep dive into emissions queries

AI Analysis Guide

Best practices for AI-assisted analysis

Reference Data

Available reference resources