> ## Documentation Index
> Fetch the complete documentation index at: https://code.dcycle.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Welcome to Dcycle Developer Platform - APIs, CLI, and AI integration for operational data intelligence

# Welcome to Dcycle

Dcycle helps organizations collect, process, and analyze operational data across facilities, fleet, logistics, and supply chain — from energy consumption to waste management to transport emissions. Our developer platform provides multiple ways to integrate this data into your workflows.

## Three Ways to Integrate

<CardGroup cols={3}>
  <Card title="REST API" icon="code" href="/api-reference/introduction">
    Programmatic access for custom applications, real-time calculations, and backend integrations.
  </Card>

  <Card title="CLI" icon="terminal" href="/cli/overview">
    Command-line interface for automation, bulk uploads, scripting, and CI/CD pipelines.
  </Card>

  <Card title="MCP Server" icon="robot" href="/mcp/overview">
    AI assistant integration for natural language queries and conversational analysis.
  </Card>
</CardGroup>

## What Can You Build?

<CardGroup cols={3}>
  <Card title="Logistics Emissions" icon="truck">
    Calculate CO2e from shipments following ISO 14083 standards
  </Card>

  <Card title="Fleet Management" icon="car">
    Track vehicle consumption and calculate transport emissions
  </Card>

  <Card title="Facility Operations" icon="building">
    Monitor emissions from offices, warehouses, and production plants
  </Card>

  <Card title="Invoice Processing" icon="file-invoice">
    Upload utility bills for automated emissions calculation
  </Card>

  <Card title="Supply Chain" icon="boxes-stacked">
    Track emissions from purchases and suppliers
  </Card>

  <Card title="Custom Factors" icon="chart-line">
    Define supplier-specific emission factors for accurate tracking
  </Card>
</CardGroup>

## Choose Your Path

### I want to build a custom integration

Use the **REST API** for full programmatic control:

```python theme={"theme":{"light":"github-light","dark":"github-dark"}}
import requests

response = requests.post(
    "https://api.dcycle.io/v1/logistics/requests",
    headers={"x-api-key": api_key, "x-organization-id": org_id},
    json={"origin": "Madrid", "destination": "Barcelona", "load": 1000}
)
print(f"Emissions: {response.json()['co2e']} kg CO2e")
```

[Get Started with API →](/docs/quickstart)

### I want to automate data uploads

Use the **CLI** for bulk operations and scripting:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
# Upload monthly logistics data
dc logistics upload viajes.csv --type requests --yes

# Export fleet data as JSON
dc vehicle list --format json > vehicles.json
```

[Get Started with CLI →](/cli/overview)

### I want AI-assisted analysis

Use the **MCP Server** with Claude for natural language queries:

```
User: "What are our total emissions for 2024 by scope?"

Claude: "Your 2024 emissions total 1,234 tCO2e:
- Scope 1: 234 tCO2e (19%)
- Scope 2: 456 tCO2e (37%)
- Scope 3: 544 tCO2e (44%)"
```

[Get Started with MCP →](/mcp/overview)

## Key Features

| Feature                    | API | CLI | MCP |
| -------------------------- | --- | --- | --- |
| Real-time calculations     | ✅   | -   | ✅   |
| Bulk data upload           | ✅   | ✅   | -   |
| CI/CD integration          | ✅   | ✅   | -   |
| Natural language queries   | -   | -   | ✅   |
| Multi-organization support | ✅   | ✅   | ✅   |
| JSON/CSV export            | ✅   | ✅   | ✅   |

## Standards & Compliance

* **ISO 14083**: Transport emissions calculation
* **GHG Protocol**: Corporate carbon accounting (Scope 1, 2, 3)
* **IPCC AR6**: Global Warming Potential values
* **15,000+ emission factors** from DEFRA, ADEME, EPA, and more

## Quick Links

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/docs/quickstart">
    Get your API key and make your first call
  </Card>

  <Card title="Authentication" icon="key" href="/docs/authentication">
    Learn about API keys, CLI login, and MCP setup
  </Card>

  <Card title="Security & Compliance" icon="shield" href="/docs/security">
    Data protection, access control, and audit capabilities
  </Card>

  <Card title="Emission Guides" icon="leaf" href="/guides/emissions/overview">
    Tutorials for calculating different emission types
  </Card>
</CardGroup>

## Base URL

All API requests should be made to:

```
https://api.dcycle.io
```

## Need Help?

Check our [Support & Resources](/docs/support) page for troubleshooting, learning resources, and contact information.