ardregistry.net

Referencia

Preguntas sobre Agentic Resource Discovery

Las dudas que salen de verdad al publicar por primera vez, contra la v0.91.

Las tres más repetidas: ARD no sustituye a MCP, encuentra los servidores con los que luego hablas por MCP. El manifiesto se llama ard.json y ya no ai-catalog.json, desde agosto de 2026. Y un manifiesto válido puede ser invisible, porque el ranking se construye con representativeQueries y ese campo es solo un SHOULD.

Lo básico

¿Qué es Agentic Resource Discovery?

Una especificación para que una web le diga a los agentes de IA qué pueden llamar. Un fichero JSON en /.well-known/ard.json donde cada entrada describe un recurso.

¿Necesito una cuenta?

No. No hay alta ni aprobación. Quien controla el dominio publica en él.

¿ARD es un estándar?

Es una propuesta, hoy en v0.91. No es una norma aprobada. Eso no es un argumento en contra, solo significa que los detalles pueden cambiar, como pasó en agosto con el nombre del fichero.

¿Cuesta dinero?

No. La especificación está bajo Apache 2.0 y los registries públicos no cobran por indexar.

Publicar

¿Cómo publico un manifiesto?

Escribe el fichero, sírvelo en /.well-known/ard.json por HTTPS y sin auth, y envíalo a un registry. Ese último paso falta en casi todas las guías y es la razón de que luego no pase nada.

¿Cuánto tarda en aparecer?

Si lo envías, de segundos a minutos. Si esperas a que un crawler te encuentre, indefinido, y puede que nunca.

Mi manifiesto es válido pero no aparece. ¿Por qué?

Casi siempre una de dos. O faltan las representativeQueries, y entonces el registry no tiene con qué relacionar tu entrada con una consulta. O lo publicaste y nunca lo enviaste.

¿Puedo listar recursos que no alojo yo?

El identifier tiene que llevar tu dominio. Listar recursos ajenos bajo tu nombre es exactamente el caso que esa regla impide.

¿Tengo que firmar el manifiesto?

No. Existe un manifiesto de confianza opcional, pero no hay método obligatorio para verificarlo.

El formato

¿Qué es lo mínimo?

Un array entries. Por entrada: identifier, displayName, type y exactamente uno de url o data.

¿Cómo escribo buenas representativeQueries?

Escribe lo que teclea alguien que necesita tu herramienta. Frases completas, en minúsculas, de dos a cinco por entrada, cada una con otras palabras. Categorías como «búsqueda» o «integración de API» no sirven, porque nadie teclea categorías.

¿ard.json o ai-catalog.json?

ard.json desde la v0.91 del 26 de agosto de 2026. Si ya servías la ruta antigua, déjala y sirve las dos.

Comparaciones

¿ARD es lo mismo que MCP?

No. ARD encuentra herramientas, MCP las llama. Quien tiene un servidor MCP no lo sustituye, lo describe en una entrada.

¿Y llms.txt?

llms.txt propone lecturas, ARD describe cosas llamables. De llms.txt no hay hasta hoy ninguna prueba publicada de que tenga un efecto medible.

Federación y confianza

¿Mi entrada se propaga por la federación?

No, y es el malentendido más tozudo. Federación significa que un registry consulta a otros al responder. Indexado estás solo donde lo enviaste.

¿Alguien comprueba que lo que digo es cierto?

Los registries suelen comprobar si tu endpoint responde. Si la descripción es cierta no lo comprueba nadie. Una puntuación de relevancia no es una afirmación de confianza.

En la práctica

¿Cuántos publishers hay?

Ahora mismo 210 dominios sirven un manifiesto, y 85% de ellos siguen en la ruta que quedó atrás en agosto. Las cifras se vuelven a medir cada noche.

¿Puedo tener varios manifiestos?

Uno por dominio en la ruta well-known. Los subdominios cuentan como dominios propios.

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