MCP · ¿Me avisan si cambia?

Vigilancia de RUT

Tus listas de RUT, verificadas contra cada publicación del SII, con las novedades por API, correo o webhook. Los ejemplos de abajo son la petición y la respuesta real de cada operación, no una aproximación.

Lo que descuenta cada operación es lo mismo por REST, SOAP, GraphQL y MCP —pagas por el dato, no por el protocolo—; la tabla completa está en Empezar.

MCP `novedades_de_mi_cartera`

Las novedades de tu cartera

Lo que el SII publicó sobre los RUT que vigilas, ya entregado: se lee las veces que quieras, por cualquier mecanismo. De la más antigua a la más nueva desde el cursor, con retenidas diciendo cuántas esperan a que tu cuenta tenga consultas. Leer no descuenta: ya se descontó una consulta por novedad entregada.

Argumentos

Argumento	Tipo	Qué es
`desde`	string	Solo las entregadas desde ese día, inclusive, en hora de Chile. Por defecto todas. ISO 8601 solo fecha (`1993-01-01`), sin hora ni zona.
`lista`	string	Solo las de esa lista (su `id`). Por defecto todas las tuyas.
`limite`	integer	Novedades por página: 1 a 500. Por defecto 100.
`pagina`	string	El `pagina_siguiente` de la respuesta anterior. Lleva los filtros adentro: o no los repites, o los repites todos iguales.

Lo que devuelve

El mismo cuerpo que GET /v1/vigilancia/novedades, en structuredContent, y escrito en Markdown en el content de texto; _meta.consumo dice lo que descontó.

Campo	Tipo	Qué es
`novedades`	array	La página de novedades, de la más antigua a la más nueva. Vacía si no hay nada nuevo desde el cursor.
`hay_mas`	boolean	`true` si quedan más novedades por pedir.
`pagina_siguiente`	string	Pásalo tal cual en `pagina` para pedir la siguiente. `null` cuando no hay más. Lleva los filtros adentro: no los repitas distintos.
`retenidas`	integer	Cuántas novedades esperan a que tu cuenta tenga consultas: se entregan solas cuando alcance. `0` mientras tengas plan o saldo.
`fuente`	string	Siempre el mismo texto: de dónde salen estos datos.
`padron_publicado`	string	De cuándo son las nóminas vigentes del padrón. ISO 8601 con hora y zona (`2026-08-05T15:36:37+00:00`), siempre en UTC. Es la publicación contra la que se verifica cada RUT vigilado.
`consultado_en`	string	Cuándo se respondió esta llamada. ISO 8601 con hora y zona (`2026-08-05T15:36:37+00:00`), siempre en UTC.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "novedades_de_mi_cartera",
    "arguments": {}
  }
}

El resultado, con su consumo

result · structuredContent + _meta.consumo

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "# Las novedades de tu cartera …"
      }
    ],
    "structuredContent": {
      "novedades": [],
      "hay_mas": false,
      "pagina_siguiente": null,
      "retenidas": 0,
      "fuente": "Tus listas, cruzadas con el historial de cambios del padrón del SII",
      "padron_publicado": "2026-08-05T15:36:37+00:00",
      "consultado_en": "2026-08-29T04:12:07+00:00"
    },
    "_meta": {
      "consumo": {
        "consultas_cobradas": 0,
        "plan_restante": null,
        "saldo_restante": null
      }
    }
  }
}

El esquema de los argumentos

inputSchema

{
  "type": "object",
  "properties": {
    "desde": {
      "type": "string",
      "description": "Solo las entregadas desde ese día, inclusive, en hora de Chile. Por defecto todas. ISO 8601 solo fecha (`1993-01-01`), sin hora ni zona."
    },
    "lista": {
      "type": "string",
      "description": "Solo las de esa lista (su `id`). Por defecto todas las tuyas."
    },
    "limite": {
      "type": "integer",
      "description": "Novedades por página: 1 a 500. Por defecto 100."
    },
    "pagina": {
      "type": "string",
      "description": "El `pagina_siguiente` de la respuesta anterior. Lleva los filtros adentro: o no los repites, o los repites todos iguales."
    }
  }
}

Por MCP se leen las novedades. Las listas —crear, agregar RUT, quitar— y el webhook se administran por REST: gestionar las listas y el webhook.

Probar en la consola Este producto por REST Este producto por SOAP Este producto por GraphQL Qué es Vigilancia de RUT