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.


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

'ú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 transcurridos desde esa fecha, negativo = está fechado en el futuro. Un positivo NO significa por sí solo que la fuente esté caída: en el IPC y la UTM, que son MENSUALES, es lo normal. Lee la descripción de 'antiguedadDias' antes de concluir nada.

Entrada

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

JSON Schema de entrada

{
  "$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"
  ]
}

Ejemplo

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"}}'

SDK TypeScript

const data = await connect.tools.indicadores.valor.actual({ codigo: "UF" });

MCP · meta-tool execute

{
  "tool": "indicadores.valor.actual",
  "params": {
    "codigo": "UF"
  }
}

Salida esperada (200):

{
  "data": {
    "codigo": "UF",
    "fecha": "2026-08-10",
    "valor": 40846.11,
    "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

Campo	Tipo	Requerido	Descripción
`codigo`	string	sí	Eco del código del indicador al que corresponde este valor.
`fecha`	string `^\d{4}-\d{2}-\d{2}$`	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; NEGATIVO = está fechado en el futuro, normal en UF y UTM que se publican por adelantado. El POSITIVO se lee según la FRECUENCIA del indicador, y confundirlas hace reportar caída una fuente sana: en los DIARIOS (UF, DOLAR, EURO) un positivo que se estira más allá de un fin de semana o un feriado sí significa que la ingesta dejó de correr; en los MENSUALES (IPC, UTM), que se fechan el día 1 del mes que miden, el número crece un día por día y eso es lo ESPERADO: la UTM llega a ~31 antes de que salga la del mes siguiente, y el IPC suma encima su rezago de publicación (el dato de un mes se publica a comienzos del siguiente), así que su normal llega a los dos meses. Medido el 2026-09-01, el IPC devolvió 62 con el dato de julio y la fuente al día. Compáralo contra tu propia tolerancia POR FRECUENCIA antes de calcular plata con este número.

JSON Schema de salida

{
  "$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",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "x-emisso-formato": "AAAA-MM-DD",
      "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; NEGATIVO = está fechado en el futuro, normal en UF y UTM que se publican por adelantado. El POSITIVO se lee según la FRECUENCIA del indicador, y confundirlas hace reportar caída una fuente sana: en los DIARIOS (UF, DOLAR, EURO) un positivo que se estira más allá de un fin de semana o un feriado sí significa que la ingesta dejó de correr; en los MENSUALES (IPC, UTM), que se fechan el día 1 del mes que miden, el número crece un día por día y eso es lo ESPERADO: la UTM llega a ~31 antes de que salga la del mes siguiente, y el IPC suma encima su rezago de publicación (el dato de un mes se publica a comienzos del siguiente), así que su normal llega a los dos meses. Medido el 2026-09-01, el IPC devolvió 62 con el dato de julio y la fuente al día. Compáralo contra tu propia tolerancia POR FRECUENCIA antes de calcular plata con este número."
    }
  },
  "required": [
    "codigo",
    "fecha",
    "valor",
    "unidad",
    "antiguedadDias"
  ],
  "additionalProperties": false
}

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.