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

# Manglai MCP Server

> Connect AI assistants to your Manglai environmental data

Connect **Claude, Cursor, ChatGPT or Gemini** to your Manglai platform and query carbon, water and waste data in natural language.

## What Can You Do?

<CardGroup cols={2}>
  <Card title="Companies" icon="building">
    Query company hierarchy, buildings, departments and annual configuration
  </Card>

  <Card title="Consumptions" icon="bolt">
    List and filter energy consumption records. Get dashboards by category, building and period
  </Card>

  <Card title="Emissions" icon="leaf">
    Calculated emissions by scope, category, building and month. Aggregated CO₂e dashboard
  </Card>

  <Card title="Invoices" icon="file-invoice">
    Electricity, gas, fuel, water and waste invoices with CO₂e data
  </Card>

  <Card title="Vehicles" icon="car">
    Vehicle fleet with engine type, fuel and associated emissions
  </Card>

  <Card title="Employees" icon="users">
    Employee list and commuting data
  </Card>

  <Card title="Business Travel" icon="plane">
    Travel records with transport type and emissions per trip
  </Card>

  <Card title="GLEC Logistics" icon="truck">
    Logistics service footprint aligned with the GLEC standard
  </Card>

  <Card title="Goals" icon="bullseye">
    Reduction targets, tracking tasks and projection scenarios
  </Card>

  <Card title="Reference Data" icon="database">
    GHG Protocol categories, emission factors, recommended inputs by country
  </Card>
</CardGroup>

## Available Tools

| Tool                                   | Description                                                      |
| -------------------------------------- | ---------------------------------------------------------------- |
| `get_companies`                        | List of companies in the organization                            |
| `get_company_buildings`                | Buildings for a company                                          |
| `get_company_departments`              | Departments for a company                                        |
| `get_company_year_configuration`       | Active year configuration                                        |
| `get_consumptions`                     | Consumption records with filters by company, category and period |
| `get_consumption`                      | Single consumption record by ID                                  |
| `get_consumptions_dashboard`           | Aggregated consumption summary                                   |
| `get_emissions`                        | List of calculated emissions                                     |
| `get_emissions_dashboard`              | Dashboard by scope, category and building                        |
| `get_invoices`                         | Invoices with filters by company, type and period                |
| `get_invoice`                          | Single invoice by ID                                             |
| `get_invoices_dashboard`               | Invoice summary                                                  |
| `get_vehicles`                         | Fleet vehicles                                                   |
| `get_vehicle`                          | Single vehicle by ID                                             |
| `get_vehicles_dashboard`               | Fleet summary                                                    |
| `get_employees`                        | Employee list                                                    |
| `get_employee`                         | Single employee by ID                                            |
| `get_business_travels`                 | Business travel records with emissions                           |
| `get_business_travels_dashboard`       | Business travel dashboard                                        |
| `get_service_footprint_glec`           | GLEC logistics footprint                                         |
| `get_service_footprint_glec_dashboard` | GLEC dashboard                                                   |
| `get_goals`                            | Reduction goals                                                  |
| `get_tasks`                            | Tasks linked to goals                                            |
| `get_scenarios`                        | Projection scenarios                                             |
| `get_categories`                       | GHG Protocol categories (scope, category, subcategory)           |
| `get_emission_factors`                 | Custom emission factors                                          |
| `get_recommended_inputs`               | Recommended inputs by country                                    |
| `get_suppliers`                        | Suppliers and clients                                            |
| `get_users`                            | Organization users                                               |

## How It Works

```
You: "What are my company's emissions in 2024 by scope?"
  ↓
The assistant calls get_emissions_dashboard() via MCP
  ↓
Manglai MCP Server queries the API with your Bearer token
  ↓
The assistant receives the data and presents a readable summary
```

## Security

* **Read-only** — MCP tools only read data, never modify it
* **Token-scoped access** — Access is limited to what your token can see
* **No data storage** — Data flows through directly, nothing is cached

## Architecture

```
Claude Desktop / Cursor / ChatGPT
  ↕ MCP Protocol (SSE or stdio)
mcp-remote (local proxy, if needed)
  ↕ HTTPS + Bearer token
Manglai MCP Server (mcp.manglai.io)
  ↕ Internal API
Manglai Platform
```

## Getting Started

<Card title="Quickstart" icon="rocket" href="/mcp/en/quickstart">
  Set up the Manglai MCP in 5 minutes
</Card>