Valor del indicador a una fecha

Devuelve el valor de un indicador vigente a una fecha dada (AAAA-MM-DD) CON ARRASTRE: si esa fecha no tiene dato propio (un fin de semana, un feriado, o una fuente que no se ha actualizado) devuelve el último valor anterior.


Tool ID	`indicadores.valor.consultar`
Nombre MCP	`indicadores__valor__consultar`
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

La 'fecha' de la respuesta puede ser DISTINTA de la solicitada, y 'esArrastre' lo marca: false = ese día tiene dato propio; true = el valor corresponde a la 'fecha' devuelta, que es anterior. Pedir una fecha futura devuelve el último valor conocido con 'esArrastre: true', no un error. Todo se lee del almacén de referencia global.

Entrada

Campo	Tipo	Requerido	Descripción
`codigo`	`"UF"` · `"DOLAR"` · `"EURO"` · `"IPC"` · `"UTM"`	sí	Código del indicador económico
`fecha`	string `^\d{4}-\d{2}-\d{2}$`	sí	La fecha a la que quieres el valor vigente, en formato AAAA-MM-DD. Si ese día no tiene dato propio se arrastra el último anterior, así que pedir un fin de semana o una fecha futura responde 200 con 'esArrastre' en true, nunca un error.

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"
    },
    "fecha": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "La fecha a la que quieres el valor vigente, en formato AAAA-MM-DD. Si ese día no tiene dato propio se arrastra el último anterior, así que pedir un fin de semana o una fecha futura responde 200 con 'esArrastre' en true, nunca un error."
    }
  },
  "required": [
    "codigo",
    "fecha"
  ]
}

Ejemplo

curl

curl -X POST https://connect.emisso.ai/api/v1/tools/indicadores.valor.consultar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "Content-Type: application/json" \
  -d '{"input":{"codigo":"DOLAR","fecha":"2026-08-02"}}'

SDK TypeScript

const data = await connect.tools.indicadores.valor.consultar({ codigo: "DOLAR", fecha: "2026-08-02" });

MCP · meta-tool execute

{
  "tool": "indicadores.valor.consultar",
  "params": {
    "codigo": "DOLAR",
    "fecha": "2026-08-02"
  }
}

Salida esperada (200):

{
  "data": {
    "codigo": "DOLAR",
    "fecha": "2026-07-31",
    "valor": 943.18,
    "unidad": "CLP",
    "fechaSolicitada": "2026-08-02",
    "esArrastre": true
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "indicadores.valor.consultar",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}

El 2 de agosto de 2026 es domingo: no hay dato propio y el valor viene arrastrado del viernes anterior.

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. Si 'esArrastre' es true, es anterior a 'fechaSolicitada'.
`valor`	número	sí	El valor del indicador vigente a 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.
`fechaSolicitada`	string	sí	Eco de la fecha que pediste, para poder compararla sin guardarla tú.
`esArrastre`	booleano	sí	true = la fecha pedida NO tiene dato propio y este valor viene de una fecha anterior ('fecha'). false = es el valor de esa fecha exacta. Míralo antes de usar el número: un arrastre de un día sobre un fin de semana es normal, uno de tres semanas significa que la fuente está caída.

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",
      "description": "La fecha del valor DEVUELTO. Si 'esArrastre' es true, es anterior a 'fechaSolicitada'."
    },
    "valor": {
      "type": "number",
      "description": "El valor del indicador vigente a 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."
    },
    "fechaSolicitada": {
      "type": "string",
      "description": "Eco de la fecha que pediste, para poder compararla sin guardarla tú."
    },
    "esArrastre": {
      "type": "boolean",
      "description": "true = la fecha pedida NO tiene dato propio y este valor viene de una fecha anterior ('fecha'). false = es el valor de esa fecha exacta. Míralo antes de usar el número: un arrastre de un día sobre un fin de semana es normal, uno de tres semanas significa que la fuente está caída."
    }
  },
  "required": [
    "codigo",
    "fecha",
    "valor",
    "unidad",
    "fechaSolicitada",
    "esArrastre"
  ],
  "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.