> ## 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](/mcp/es/intro).

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