Skip to main content

​
Dcycle MCP Server

The Dcycle MCP (Model Context Protocol) Server lets AI assistants like Claude query your sustainability data directly — organizations, invoices, vehicles, employees, purchases, business travel, and logistics.

​
What is MCP?

MCP is an open standard created by Anthropic that lets AI assistants securely connect to external data sources. Think of it like connecting Google Calendar to Claude — but for your carbon footprint data.

​
Connection Modes

The Dcycle MCP server supports two modes:

Remote (Recommended)

Connect directly to https://mcp.dcycle.io — no installation needed. Authenticate with your Dcycle account via OAuth 2.0.

Local (stdio)

Run the server on your own machine with a Dcycle API key. Useful for automation or custom deployments.

​
What Can You Do?

Organizations

View organization hierarchy, metrics, and group structure

Invoices

Query electricity, gas, water, and other energy invoices with co2e data

Vehicles

Explore fleet data — vehicle types, fuel, ownership, and emissions

Employees

List employees and commuting data

Purchases

Query Scope 3 purchased goods and services

Business Travel

View travel records by transport type with emissions

Logistics

Shipping requests with routes, loads, and kgCO2e

Reference Data

GHG scopes, emission categories, sectors

​
Available Tools

ToolDescription
get_connection_statusVerify connection and show data overview
get_organization_metricsCounts of all data types
get_organization_treeParent-child org hierarchy
get_organization_canvasAll orgs with connections
list_invoicesEnergy invoices with filters
list_vehiclesFleet vehicles with fuel and co2e
list_employeesEmployees and commuting
list_purchasesPurchased goods & services
list_business_travelsTravel records with co2e
list_logistics_requestsShipping with emission calculations
list_membersOrganization users with name, email, and role
list_processing_jobsData upload/calculation status and errors
get_use_of_product_emissionsScope 3 use-of-sold-products
All tools are read-only — the MCP server never modifies your data.

​
How It Works

​
Remote mode

You: "Show me our vehicle fleet sorted by emissions"
  ↓
Claude calls list_vehicles() via MCP (HTTPS)
  ↓
mcp.dcycle.io authenticates via your Dcycle account (OAuth 2.0)
  ↓
Dcycle API returns data
  ↓
Claude presents a readable summary

​
Local mode (stdio)

You: "Show me our vehicle fleet sorted by emissions"
  ↓
Claude calls list_vehicles() via MCP (stdio)
  ↓
Dcycle MCP Server (local) authenticates via API key
  ↓
Dcycle API (api.dcycle.io) returns data
  ↓
Claude presents a readable summary

​
Security

  • Read-only — All 13 tools are annotated with readOnlyHint: true. The server never modifies data.
  • Remote mode — Authentication via OAuth 2.0 (Cognito). Your credentials never leave Dcycle’s infrastructure.
  • Local mode — Authentication via your API key, scoped to what your key can access. The server runs on your machine.

​
Compatible AI Assistants

The Dcycle MCP server works with any MCP-compatible AI assistant. Here’s how to connect the most common ones:
Requires VS Code 1.101+ with the GitHub Copilot extension. MCP tools are available in Agent mode only.Add to .vscode/mcp.json in your project (or open MCP: Open User Configuration from the command palette for a global config):
{
  "servers": {
    "dcycle": {
      "type": "http",
      "url": "https://mcp.dcycle.io/mcp"
    }
  }
}
On first use, VS Code will open a browser window to authenticate with your Dcycle account via OAuth 2.0. Tokens are managed automatically by VS Code.
Note: The root key is "servers" — not "mcpServers" (which is the Claude Desktop format).
Requires a Pro, Plus, Business, or Enterprise plan. Configuration is done entirely through the UI — no config file needed.
  1. Go to Settings → Apps → Advanced settings → Developer mode and enable it.
  2. In any chat, click ”+” and select Add connector.
  3. Enter:
    • Name: Dcycle
    • MCP Server URL: https://mcp.dcycle.io/mcp
  4. On first use ChatGPT will redirect you to log in with your Dcycle account via OAuth 2.0.
Microsoft Copilot Studio is an enterprise no-code agent builder (separate from GitHub Copilot). MCP is supported in GA and requires a Copilot Studio license with Generative Orchestration enabled on your agent.
  1. Open your agent and go to the Tools tab.
  2. Click Add a tool → New tool → Model Context Protocol.
  3. Fill in the wizard:
    • Server name: Dcycle
    • Server description: Query Dcycle sustainability data — organizations, invoices, vehicles, employees, purchases, business travel, and logistics.
    • Server URL: https://mcp.dcycle.io/mcp
  4. For Authentication, select OAuth 2.0 → Dynamic discovery. Copilot Studio auto-discovers the Dcycle authorization endpoints.
  5. Click Create. Copilot Studio will show a Redirect URL — copy it.
  6. Register that Redirect URL in your Dcycle account settings so the OAuth flow can complete.
Copilot Studio discovers all available tools automatically at runtime. No manual tool registration is needed.
Note: Only Streamable HTTP transport is supported. Localhost servers are not reachable from Copilot Studio’s cloud infrastructure.
Add to ~/.gemini/settings.json (global) or .gemini/settings.json in your project root:
{
  "mcpServers": {
    "dcycle": {
      "url": "https://mcp.dcycle.io/mcp"
    }
  }
}
On first use Gemini CLI will open a browser for OAuth authentication. You can also trigger it manually:
/mcp auth dcycle
Tokens are stored at ~/.gemini/mcp-oauth-tokens.json.
Note: Gemini in Google Workspace and Google AI Studio do not support connecting to external MCP servers. Use the Gemini CLI.

​
Getting Started

Quickstart Guide

Connect in under a minute using the remote server — no installation needed