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.

​
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

​
How It Works

You: "Show me our vehicle fleet sorted by emissions"
  ↓
Claude calls list_vehicles() via MCP
  ↓
Dcycle MCP Server queries the API with x-api-key auth
  ↓
Claude receives the data and presents it as a readable summary

​
Security

  • Read-only — The MCP server only reads data, never modifies it
  • API key scoped — Access is limited to what your API key can see
  • Local execution — The server runs on your machine (stdio transport)
  • No data storage — Data flows through, nothing is cached

​
Architecture

The MCP server is built on the new hex-arch API (x-api-key + x-organization-id authentication). It’s a standalone Python package independent of the Dcycle CLI. 
Claude Desktop / Claude Code
  ↕ MCP Protocol (stdio)
Dcycle MCP Server (local)
  ↕ HTTPS
Dcycle API (api.dcycle.io)

​
Getting Started

Quickstart Guide

Install and configure the MCP server in 5 minutes