# Valor actual del indicador

> Devuelve el ÚLTIMO valor disponible de un indicador económico chileno (UF, DÓLAR, EURO, IPC, UTM), leído del almacén de referencia global; no consulta fuentes externas en tiempo real.



{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}

|                     |                                                                    |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID**         | `indicadores.valor.actual`                                         |
| **Nombre MCP**      | `indicadores__valor__actual`                                       |
| **Conector**        | `indicadores`                                                      |
| **Plano**           | `action`                                                           |
| **Scope (permiso)** | `indicadores:read`                                                 |
| **Auth**            | `none`                                                             |
| **Versión**         | `2`                                                                |
| **Sensible**        | no                                                                 |
| **Deprecado**       | no                                                                 |
| **Comportamiento**  | readOnly=true, destructive=false, idempotent=true, openWorld=false |

## Qué hace [#qué-hace]

'último disponible' NO es lo mismo que 'el de hoy', y hay que mirar 'fecha' antes de usar el número: la UF y la UTM se publican por ADELANTADO, así que su fecha puede ser futura; y si la ingesta se atrasa, la fecha queda en el pasado. 'antiguedadDias' resuelve las dos de una vez: 0 = es el de hoy, positivo = días de atraso, negativo = está fechado en el futuro.

## Entrada [#entrada]

| Campo    | Tipo                                              | Requerido | Descripción                    |
| -------- | ------------------------------------------------- | --------- | ------------------------------ |
| `codigo` | `"UF"` · `"DOLAR"` · `"EURO"` · `"IPC"` · `"UTM"` | sí        | Código del indicador económico |

<details>
  <summary>
    JSON Schema de entrada
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "codigo": {
        "type": "string",
        "enum": [
          "UF",
          "DOLAR",
          "EURO",
          "IPC",
          "UTM"
        ],
        "description": "Código del indicador económico"
      }
    },
    "required": [
      "codigo"
    ]
  }
  ```
</details>

## Ejemplo [#ejemplo]

```bash title="curl"
curl -X POST https://connect.emisso.ai/api/v1/tools/indicadores.valor.actual/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "Content-Type: application/json" \
  -d '{"input":{"codigo":"UF"}}'
```

```ts title="SDK TypeScript"
const data = await connect.tools.indicadores.valor.actual({ codigo: "UF" });
```

```json title="MCP · meta-tool execute"
{
  "tool": "indicadores.valor.actual",
  "params": {
    "codigo": "UF"
  }
}
```

**Salida esperada (200):**

```json
{
  "data": {
    "codigo": "UF",
    "fecha": "2026-08-08",
    "valor": 39487.23,
    "unidad": "CLP",
    "antiguedadDias": -1
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "indicadores.valor.actual",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}
```

> antiguedadDias -1: la UF se publica por adelantado, el valor devuelto es el de mañana.

## Salida [#salida]

| Campo            | Tipo   | Requerido | Descripción                                                                                                                                                                                                                                                                                                            |
| ---------------- | ------ | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `codigo`         | string | sí        | Eco del código del indicador al que corresponde este valor.                                                                                                                                                                                                                                                            |
| `fecha`          | string | sí        | La fecha del valor devuelto. Puede ser futura (UF/UTM se publican por adelantado) o pasada (ingesta atrasada).                                                                                                                                                                                                         |
| `valor`          | número | sí        | El valor del indicador en esa fecha, en la unidad que dice 'unidad'.                                                                                                                                                                                                                                                   |
| `unidad`         | string | sí        | En qué unidad está expresado el valor. UF, DOLAR, EURO y UTM vienen en pesos chilenos ('CLP'); el IPC viene en 'pct', porque es la variación mensual en por ciento y no un monto. Lee este campo antes de tratar el número como plata.                                                                                 |
| `antiguedadDias` | entero | sí        | Días entre 'fecha' y hoy en America/Santiago. 0 = el valor es de hoy; POSITIVO = está atrasado ese número de días (la fuente no se actualiza); NEGATIVO = está fechado en el futuro, normal en UF y UTM que se publican por adelantado. Compáralo contra tu propia tolerancia antes de calcular plata con este número. |

<details>
  <summary>
    JSON Schema de salida
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "codigo": {
        "type": "string",
        "description": "Eco del código del indicador al que corresponde este valor."
      },
      "fecha": {
        "type": "string",
        "description": "La fecha del valor devuelto. Puede ser futura (UF/UTM se publican por adelantado) o pasada (ingesta atrasada)."
      },
      "valor": {
        "type": "number",
        "description": "El valor del indicador en esa fecha, en la unidad que dice 'unidad'."
      },
      "unidad": {
        "type": "string",
        "description": "En qué unidad está expresado el valor. UF, DOLAR, EURO y UTM vienen en pesos chilenos ('CLP'); el IPC viene en 'pct', porque es la variación mensual en por ciento y no un monto. Lee este campo antes de tratar el número como plata."
      },
      "antiguedadDias": {
        "type": "integer",
        "minimum": -9007199254740991,
        "maximum": 9007199254740991,
        "description": "Días entre 'fecha' y hoy en America/Santiago. 0 = el valor es de hoy; POSITIVO = está atrasado ese número de días (la fuente no se actualiza); NEGATIVO = está fechado en el futuro, normal en UF y UTM que se publican por adelantado. Compáralo contra tu propia tolerancia antes de calcular plata con este número."
      }
    },
    "required": [
      "codigo",
      "fecha",
      "valor",
      "unidad",
      "antiguedadDias"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Errores de esta tool [#errores-de-esta-tool]

Toda llamada puede devolver además los códigos transversales (`validation_error`, `unauthorized`, `scope_not_granted`, `rate_limited`, entre otros): el detalle vive en el [catálogo de errores](../errores).