Serie histórica del indicador

Devuelve la serie de valores de un indicador entre dos fechas (AAAA-MM-DD), en orden ascendente, acotada por 'limite' (tope duro 1000), leída del almacén de referencia global.


Tool ID	`indicadores.serie.consultar`
Nombre MCP	`indicadores__serie__consultar`
Conector	`indicadores`
Plano	`action`
Scope (permiso)	`indicadores:read`
Auth	`none`
Versión	`1`
Sensible	no
Deprecado	no
Comportamiento	readOnly=true, destructive=false, idempotent=true, openWorld=false

Entrada

Campo	Tipo	Requerido	Descripción
`codigo`	`"UF"` · `"DOLAR"` · `"EURO"` · `"IPC"` · `"UTM"`	sí	Código del indicador económico
`desde`	string `^\d{4}-\d{2}-\d{2}$`	sí	Primer día del rango, inclusive, en formato AAAA-MM-DD.
`hasta`	string `^\d{4}-\d{2}-\d{2}$`	sí	Último día del rango, inclusive, en formato AAAA-MM-DD.
`limite`	entero 1-1000	no · default `1000`	Máximo de puntos a devolver (tope duro 1000)

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"
    },
    "desde": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "x-emisso-formato": "AAAA-MM-DD",
      "description": "Primer día del rango, inclusive, en formato AAAA-MM-DD."
    },
    "hasta": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "x-emisso-formato": "AAAA-MM-DD",
      "description": "Último día del rango, inclusive, en formato AAAA-MM-DD."
    },
    "limite": {
      "default": 1000,
      "description": "Máximo de puntos a devolver (tope duro 1000)",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "required": [
    "codigo",
    "desde",
    "hasta"
  ]
}

Ejemplo

curl

curl -X POST https://connect.emisso.ai/api/v1/tools/indicadores.serie.consultar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "Content-Type: application/json" \
  -d '{"input":{"codigo":"UF","desde":"2026-08-10","hasta":"2026-08-12"}}'

SDK TypeScript

const data = await connect.tools.indicadores.serie.consultar({ codigo: "UF", desde: "2026-08-10", hasta: "2026-08-12" });

MCP · meta-tool execute

{
  "tool": "indicadores.serie.consultar",
  "params": {
    "codigo": "UF",
    "desde": "2026-08-10",
    "hasta": "2026-08-12"
  }
}

Salida esperada (200):

{
  "data": {
    "codigo": "UF",
    "unidad": "CLP",
    "valores": [
      {
        "fecha": "2026-08-10",
        "valor": 40846.11
      },
      {
        "fecha": "2026-08-11",
        "valor": 40847.42
      },
      {
        "fecha": "2026-08-12",
        "valor": 40848.74
      }
    ]
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "indicadores.serie.consultar",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}

Salida

Campo	Tipo	Requerido	Descripción
`codigo`	string	sí	Eco del código del indicador al que corresponde este valor.
`unidad`	string	sí	En qué unidad está expresada la serie. 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. La unidad es del INDICADOR, no del rango: si 'valores' llega vacío este campo viene igual. Solo es la cadena vacía cuando el indicador no tiene ni un dato en todo el almacén.
`valores`	lista de objeto	sí	Los puntos de la serie dentro del rango, en orden ascendente por fecha. Solo trae los días que tienen dato propio: esta tool no arrastra, a diferencia de 'indicadores.valor.consultar', así que un rango con fines de semana devuelve menos puntos que días pedidos. Puede venir recortada por 'limite'.
`valores[].fecha`	string	sí	El día de este punto, en formato AAAA-MM-DD.
`valores[].valor`	número	sí	El valor de ese día, en la unidad que dice 'unidad'.

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."
    },
    "unidad": {
      "type": "string",
      "description": "En qué unidad está expresada la serie. 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. La unidad es del INDICADOR, no del rango: si 'valores' llega vacío este campo viene igual. Solo es la cadena vacía cuando el indicador no tiene ni un dato en todo el almacén."
    },
    "valores": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "fecha": {
            "type": "string",
            "description": "El día de este punto, en formato AAAA-MM-DD."
          },
          "valor": {
            "type": "number",
            "description": "El valor de ese día, en la unidad que dice 'unidad'."
          }
        },
        "required": [
          "fecha",
          "valor"
        ],
        "additionalProperties": false
      },
      "description": "Los puntos de la serie dentro del rango, en orden ascendente por fecha. Solo trae los días que tienen dato propio: esta tool no arrastra, a diferencia de 'indicadores.valor.consultar', así que un rango con fines de semana devuelve menos puntos que días pedidos. Puede venir recortada por 'limite'."
    }
  },
  "required": [
    "codigo",
    "unidad",
    "valores"
  ],
  "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.

Serie histórica del indicador

Entrada

Ejemplo

Salida

Errores de esta tool

En esta página