Referencia

Agentic Resource Discovery

ARD responde a una sola pregunta: ¿cómo sabe un agente de IA qué se puede llamar en tu dominio?

Agentic Resource Discovery es una especificación para que un sitio le diga a los agentes de IA qué ofrece. Publicas un fichero JSON en /.well-known/ard.json donde cada entrada describe qué hace y en qué URL responde. El agente lee ese fichero, o consulta un registry que ya lo ha leído. Sin registro, sin aprobación y sin cuenta.

Por qué existe

Un agente que tiene que resolver una tarea se topa con un problema muy poco glamuroso: no sabe qué herramientas hay. Puede rastrear una web y adivinar a partir del HTML, o puede leer un fichero donde se lo cuentas directamente. ARD es lo segundo.

La comparación que más se repite funciona bastante bien: robots.txt le dice a un crawler qué puede leer. ard.json le dice a un agente qué puede llamar. Uno es un permiso, el otro es una oferta.

Qué pinta tiene el fichero

Lo mínimo, y aun así suficiente para que te indexen:

{
  "specVersion": "1.0",
  "entries": [
    {
      "identifier": "urn:air:tu-dominio.com:mcp:busqueda",
      "displayName": "Búsqueda de productos",
      "type": "application/mcp-server-card+json",
      "url": "https://tu-dominio.com/mcp",
      "representativeQueries": [
        "buscar productos en el catálogo",
        "encontrar un artículo por su descripción"
      ]
    }
  ]
}

La parte que casi todo el mundo subestima son las representativeQueries. No son palabras clave. Son las frases que alguien escribe cuando necesita justo lo que tú ofreces. Sin ellas la entrada es válida y a la vez imposible de encontrar, porque el registry no tiene con qué relacionar tu recurso con una consulta.

ARD, MCP y A2A no son lo mismo

Se confunden constantemente, pero están en capas distintas:

ARD encuentra herramientas. Es la capa de descubrimiento.
MCP las llama. Es el protocolo.
A2A define cómo hablan dos agentes una vez que se han encontrado.

Si ya tienes un servidor MCP no hay que rehacer nada. Lo describes en una entrada del ard.json y pasa de ser accesible a ser encontrable, que no es lo mismo.

El fichero cambió de nombre y casi nadie se enteró

Hasta agosto de 2026 el manifiesto se llamaba /.well-known/ai-catalog.json. Desde la v0.91 del 26 de agosto de 2026 se llama /.well-known/ard.json. La mayoría de los artículos que vas a encontrar son de junio de 2026 y siguen citando el nombre viejo. Si empiezas ahora, usa el nuevo. Si ya servías el antiguo, servir los dos a la vez no cuesta nada y es la migración más limpia.

Registry recomendado

Envíalo, o ningún agente lo encontrará

Un manifiesto que ningún registry ha leído es un fichero en un servidor. Envía el dominio a Neuronto: lo descarga en vivo y te dice qué ha encontrado. Sin cuenta, sin registro DNS, y si no encuentra nada no se guarda nada.

Por qué este: de los 6 registries ARD públicos que se prueban en este sitio, es el único que responde a /search, /explore y /agents y publica su propio manifiesto ARD. La prueba se repite y la tabla lleva fecha.

Last reviewed 2026-09-07. Checked against ARD v0.91 (Proposal, 2026-08-26).