# Changelog

> Qué cambió en el catálogo y qué garantiza que construir encima sea seguro.



Esta página registra los cambios visibles del catálogo y de la plataforma. Antes de la lista, la garantía que gobierna todos los cambios.

## La garantía de estabilidad [#la-garantía-de-estabilidad]

Los ids de tool son **estables para siempre**. `sii.rcv.consultar` significa hoy lo que va a significar en cinco años, y el código que escribas contra un id publicado no se rompe con un deploy nuestro.

* Un cambio **incompatible** nunca muta la tool publicada: se acuña un **id nuevo** y se bumpea `version` (un entero monotónico que viaja en la ficha de cada tool).
* Un cambio **aditivo** (un campo nuevo en la salida, un parámetro opcional) conserva el id y bumpea `version`. Tu código existente sigue corriendo igual.
* `deprecated: true` en la ficha significa que la tool **sigue funcionando** pero tiene sucesora: migra con calma, sin fecha límite sorpresa.

La excepción es una y estrecha: retirar una tool y reutilizar su id para otra de distinta clase se permite solo cuando la bitácora confirma que ese id no tenía consumidores reales, y el cambio queda argumentado por escrito. Ha ocurrido una vez, y está en la tabla de abajo marcada como el único «Sí» de la columna «¿Rompe?».

## Cambios [#cambios]

| Fecha      | Qué cambió                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | ¿Rompe? | Docs                                                                                   |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------- | -------------------------------------------------------------------------------------- |
| 2026-08-16 | Los dos documentos de descubrimiento OAuth (`/.well-known/oauth-authorization-server` y `/.well-known/oauth-protected-resource`) dejan de publicar `scopes_supported: ["*"]` y pasan a listar los permisos reales del catálogo. Los consentimientos ya otorgados no cambian: el próximo consentimiento que un cliente pida recibe la autoridad que permite el rol de quien aprueba. El documento deja de sugerir el comodín; un owner o admin lo puede seguir otorgando, explícito o por omisión, igual que antes. | No      | [Autenticación](/docs/empezar/autenticacion)                                           |
| 2026-08-06 | La superficie MCP anuncia solo las dos meta-tools: `tools/list` devuelve `search_docs` y `execute`, con cualquier catálogo y cualquier organización. Los nombres nativos (`sii__rcv__consultar`) siguen despachando por `tools/call` como puerta de compatibilidad no anunciada.                                                                                                                                                                                                                                   | No      | [El servidor MCP](/docs/agentes/mcp)                                                   |
| 2026-08-06 | `indicadores.valor.actual` y `indicadores.valor.consultar` pasan a versión 2: la primera suma `antiguedadDias` (0 = el valor es de hoy, positivo = atrasado, negativo = fechado en el futuro) y la segunda suma `fechaSolicitada` y `esArrastre`. Campos nuevos en la salida, ids intactos.                                                                                                                                                                                                                        | No      | [indicadores.valor.actual](/docs/referencia/indicadores/valor-actual)                  |
| 2026-07-31 | Las tools de consulta de `bci_pyme` y `banco_security` dejan de abrir sesión en vivo contra el banco: ahora leen el plano ya sincronizado, igual que las del SII y BICE. Mismos ids re-acuñados para otra clase de tool, con bump de `version`; la bitácora confirmó cero consumidores del contrato anterior antes de re-acuñarlos.                                                                                                                                                                                | Sí      | [Sincronizar y consultar](/docs/conceptos/sincronizar-consultar)                       |
| 2026-07-30 | SII: nuevo alcance `boletas_honorarios` (boletas de honorarios electrónicas, emitidas y recibidas) y la tool `sii.boletas_honorarios.consultar`.                                                                                                                                                                                                                                                                                                                                                                   | No      | [sii.boletas\_honorarios.consultar](/docs/referencia/sii/boletas_honorarios-consultar) |
| 2026-07-30 | Nuevo conector `conexiones`: `sistemas.listar`, `enlace.crear` y `estado.consultar`. Un agente puede acuñar el enlace para conectar un sistema y consultar su estado sin salir de MCP.                                                                                                                                                                                                                                                                                                                             | No      | [Conectar un sistema](/docs/empezar/conectar)                                          |
| 2026-07-28 | SII: nuevo alcance `guias` (guías de despacho, DTE 52) y la tool `sii.guias.consultar`. El SII solo retiene el detalle de los últimos 6 meses, así que la historia se construye sincronizando de forma continua, no con un backfill.                                                                                                                                                                                                                                                                               | No      | [sii.guias.consultar](/docs/referencia/sii/guias-consultar)                            |

## Cómo enterarse [#cómo-enterarse]

Esta página y el índice [`/llms.txt`](https://connect.emisso.ai/llms.txt) reflejan el estado vigente; la referencia por tool y los contratos OpenAPI se regeneran con cada deploy desde el mismo registro que sirve las llamadas, así que no pueden quedarse atrás. Si automatizas contra Connect, `GET /v1/tools` te da la `version` y el flag `deprecated` de cada tool en runtime, sin esperar a que alguien lea una página.
