> ## 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.

# Tools — Métricas personalizadas

> Definiciones y mediciones de métricas personalizadas con el MCP de Manglai

## Tools disponibles

| Tool | Tipo | Descripción |
| - | - | - |
| `list_custom_metrics` | Datos | Lista de definiciones de métricas personalizadas |
| `list_custom_metric_measurements` | Datos | Lista de mediciones (opcional `customMetricId`) |
| `upsert_custom_metric` | Acción | Crear o actualizar una métrica personalizada |
| `upsert_custom_metric_measurement` | Acción | Crear o actualizar una medición |

Las tools de acción requieren `userConfirmed: false` (preview) y luego `userConfirmed: true` tras la aprobación. Ver [intro MCP](https://developers.manglai.io/mcp/es/intro.md).

## Ejemplos de uso

```
"Lista mis métricas personalizadas"
→ list_custom_metrics()

"Muestra mediciones de la métrica X"
→ list_custom_metrics({ query: "X" })
→ list_custom_metric_measurements({ customMetricId: "..." })

"Crea una métrica llamada Uso de agua en m3 con factor 22 kg CO2e"
→ upsert_custom_metric({
     name: "Uso de agua",
     unit: "m3",
     emissionFactor: 22,
     emissionFactorYear: "2024",
     userConfirmed: false
   })
→ upsert_custom_metric({ ..., userConfirmed: true }) tras aprobación

"Añade una medición de 120 para enero"
→ upsert_custom_metric_measurement({
     customMetricId: "...",
     quantity: 120,
     startDate: "2024-01-01",
     endDate: "2024-01-31",
     userConfirmed: false
   })
→ upsert_custom_metric_measurement({ ..., userConfirmed: true }) tras aprobación
```

Resuelve ids con `list_custom_metrics` antes de crear mediciones o actualizar definiciones. Los factores de emisión se configuran con `emissionFactor` (atajo por año) o `emissionFactors` (mismo formato que la UI de ajustes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.