Guías de TRON

llms.txt, .well-known y Agent Skills: cómo TronSave se presenta ante los agentes de IA

Por TronSave Publicado 11 min de lectura
En esta página

Actualizado: 7 de noviembre de 2026. Detalles de MCP y OAuth verificados con el servidor en vivo, versión 1.5.1.

Un agente de IA que llega a un sitio web tiene el mismo problema que un desarrollador nuevo: ¿qué es esto, qué puedo llamar y cómo me autentico? En 2026 existe un pequeño conjunto de archivos convencionales que responden exactamente eso: llms.txt, un puñado de descriptores en /.well-known/ y un manifiesto de agent skills. TronSave los publica todos. Este es un recorrido por lo que contiene cada uno, por qué está ahí y la única regla que ninguno de estos archivos puede hacer cumplir.

llms.txt: el resumen para leer

llms.txt vive en la raíz de un sitio y hace por los modelos de lenguaje lo que un buen README hace por un desarrollador: un párrafo sobre qué es esto y luego enlaces seleccionados con una frase de contexto cada uno. Es Markdown, no un esquema, y esa es la idea: está pensado para leerse, no para parsearse.

El de TronSave tiene cuatro secciones. Un resumen del producto en una línea. Páginas clave —inicio, mercado, herramientas, FAQ—, cada una con una descripción de lo que realmente hay ahí. Un bloque Desarrolladores y agentes de IA con enlaces a la referencia de la API, el catálogo de APIs, la server card de MCP, el índice de agent skills y el documento de autenticación. Y Legal: términos, privacidad y aviso de riesgos.

La disciplina útil aquí es la curaduría. Un sitemap lista todas las URL; llms.txt lista las diez que importan y explica por qué. Si tu archivo necesita barra de desplazamiento, ya dejó de cumplir su función.

El directorio .well-known

Si llms.txt es prosa, /.well-known/ es legible por máquinas. Cinco archivos, cada uno responde a una pregunta distinta:

Archivo Estándar Responde
api-catalog RFC 9727 ¿Qué APIs hay aquí y dónde están sus descripciones?
oauth-protected-resource RFC 9728 ¿Cuál es el recurso protegido y cómo se envían las credenciales?
mcp/server-card.json MCP ¿Dónde está el servidor MCP, qué transporte y qué autenticación usa?
agent-skills/index.json agentskills.io ¿Qué skills empaquetadas puede cargar un agente?
security.txt RFC 9116 ¿A quién contacto si encuentro una vulnerabilidad?

api-catalog: la separación entre máquina y persona

RFC 9727 define un linkset: cada API recibe un ancla y luego enlaces que la describen. TronSave publica dos anclas —la API REST v2 y el endpoint MCP— y cada una lleva tanto un service-desc como un service-doc:

{
  "linkset": [
    {
      "anchor": "https://api.tronsave.io/v2",
      "service-desc": [ { "href": ".../api-reference.md",  "type": "text/markdown" } ],
      "service-doc":  [ { "href": ".../api-reference",     "type": "text/html"     } ]
    },
    {
      "anchor": "https://mcp.tronsave.io/mcp",
      "service-desc": [ { "href": ".../mcp/server-card.json", "type": "application/json" } ],
      "service-doc":  [ { "href": ".../api-reference/mcp",    "type": "text/html"        } ]
    }
  ]
}

Lo valioso es esa distinción. service-doc es la página HTML que lee una persona. service-desc es la descripción legible por máquinas: aquí, Markdown para la referencia REST y JSON para la card de MCP. Un agente sigue service-desc y se salta por completo el envoltorio de marketing.

oauth-protected-resource: primero API keys, OAuth para MCP

Los metadatos RFC 9728 suelen acompañar a un despliegue OAuth. La API REST de TronSave en sí no tiene flujo OAuth —sus credenciales principales son una API key o una firma de billetera—, pero tronsave.io publica el descriptor de todos modos: nombra el recurso, su servidor de autorización y sus scopes, apunta a la documentación e indica que las credenciales bearer van en un encabezado, junto con los metadatos oauth-authorization-server correspondientes. Un cliente que busca estos archivos encuentra una respuesta en lugar de un 404. El servidor MCP va más allá: desde el 7 de noviembre de 2026, mcp.tronsave.io ofrece un inicio de sesión OAuth real para su endpoint https://mcp.tronsave.io/oauth/mcp, con sus propios metadatos de recurso protegido y un servidor de autorización (authorization code con PKCE, refresh tokens y un endpoint de registro de clientes). Así se conectan apps como Claude y Cursor: el usuario inicia sesión en una página de TronSave con una API key o una firma de billetera, y desde ese momento la app queda autenticada.

auth.md: la respuesta honesta para servicios sin OAuth

Como la API REST no tiene un flujo OAuth que descubrir, la autenticación real se explica en un auth.md autocontenido. Es concreto justo en lo que le ahorra tiempo a quien integra:

  • La API REST recibe tu clave en un encabezado apikey en minúsculas.
  • El servidor MCP la recibe en un encabezado authorization con el esquema ApiKey.
  • Una firma de billetera TRON es la tercera vía, y el documento deja claro que nunca envías una clave privada, solo la firma.

Las dos primeras son una trampa real: la misma credencial, dos encabezados distintos y dos formas de escribirlos, según la interfaz que llames. Dejarlo por escrito marca la diferencia entre una integración de cinco minutos y una tarde entera de errores 401.

El archivo también admite lo que no existe. No hay un endpoint OAuth de registro dinámico para obtener una API key de forma programática (el inicio de sesión OAuth del servidor MCP, que es aparte, tiene su propio endpoint de registro para apps cliente), así que explica cómo la obtiene una persona: conectando una billetera en el sitio o usando el bot de Telegram. Después, un bloque agent_auth resume esos mismos datos de forma estructurada: tipo de identidad anónima, tipo de credencial api_key y un enlace a la documentación de registro.

La server card de MCP

Un descriptor compacto del servidor MCP de TronSave: nombre y versión, transporte (http-streamable) con su endpoint y métodos, un bloque de capacidades que declara tools, resources y prompts (cada uno con listChanged), los dos esquemas de autenticación admitidos con el formato exacto del encabezado y enlaces a una guía rápida y a la documentación.

Declarar las capacidades que no tienes no es relleno. Un agente que sabe que no hay resources ni prompts deja de buscarlos.

El manifiesto de agent skills

La capa más reciente. agent-skills/index.json sigue el esquema de descubrimiento de agentskills.io y anuncia una skill, tronsave-api, de tipo skill-md: un documento Markdown que un agente puede cargar como instrucciones de trabajo:

{
  "$schema": "https://schemas.agentskills.io/discovery/0.2.0/schema.json",
  "skills": [
    {
      "name": "tronsave-api",
      "type": "skill-md",
      "url": "https://tronsave.io/.well-known/agent-skills/tronsave-api/SKILL.md",
      "digest": "sha256:bc8a8647...9141b"
    }
  ]
}

Fíjate en el digest. El manifiesto incluye un SHA-256 del archivo de la skill, así que un cliente puede verificar que descargó lo que el sitio quería publicar. Las skills son instrucciones sobre las que un agente va a actuar, y eso hace que valga la pena comprobar su integridad, algo que una página de marketing nunca necesita.

La regla que ningún manifiesto puede imponer

Todos los archivos anteriores son una instantánea. El servicio sigue cambiando.

Un ejemplo concreto de este mismo stack. Cuando se escribió este artículo por primera vez, en agosto de 2026, el manifiesto de skills describía el servidor MCP con 27 herramientas tipadas, mientras que el tools/list en vivo devolvía 29, y la server card incluía GET entre sus métodos de transporte aunque GET estaba desactivado. Para el 28 de octubre de 2026, el servidor (versión 1.2.0) devolvía 53 herramientas y la server card ya se había corregido a POST y DELETE, pero la guía rápida en mcp.tronsave.io/quickstart todavía decía 25 herramientas. El 7 de noviembre de 2026, el servidor en vivo reportaba la versión 1.5.1, aún con 53 herramientas, mientras la server card seguía diciendo 1.2.0.

Nada de eso es un error en el camino del agente: es la deriva normal entre un documento publicado y un servicio en funcionamiento. La lección vale para cualquier integración de este tipo: usa los manifiestos para descubrir y el servidor como fuente de verdad. Enumera las capacidades en tiempo de ejecución con tools/list en lugar de fijar en el código un número que leíste en un archivo, y deja que el handshake negocie la versión del protocolo en vez de imponer una.

Qué debe hacer un agente con las credenciales

El descubrimiento termina en la autenticación, y el modelo de sesiones merece un párrafo porque es la parte con consecuencias reales. Los datos de mercado y las cotizaciones no requieren iniciar sesión: en el servidor en vivo (versión 1.5.1, verificado el 7 de noviembre de 2026), 18 de las 53 herramientas son públicas, y cada herramienta declara su nivel de acceso en _meta["io.tronsave/auth"]. Para todo lo demás, iniciar sesión crea uno de dos tipos de sesión con alcances distintos: una sesión ApiKey se limita a operaciones de la cuenta interna, mientras que una sesión con firma está ligada a la billetera y es necesaria para las herramientas de identidad del usuario y la mayoría de los cambios en la plataforma. Una API key no te dará en silencio acceso de nivel firma; simplemente falla en esas herramientas.

El inicio de sesión está ligado a la conexión MCP, y el id de sesión viaja en el encabezado del transporte, nunca en los argumentos de las herramientas. Trátalo como un secreto. Un id de sesión filtrado permite a otra persona actuar con los permisos de esa sesión hasta que expire, y justamente por eso la sesión ApiKey, más limitada, es la opción predeterminada correcta para el trabajo autónomo.

Si lo vas a implementar en tu propio sitio

El stack es lo bastante pequeño como para lanzarlo en una tarde:

  1. /llms.txt: un párrafo de resumen y enlaces seleccionados con contexto. Mantenlo breve.
  2. /.well-known/api-catalog: un ancla por API, cada una con una descripción para máquinas y una documentación para personas.
  3. /.well-known/oauth-protected-resource: publícalo tanto si tu API principal usa OAuth como si no.
  4. Un documento de autenticación: nombres exactos de los encabezados y cómo se escriben, y cómo obtiene una persona una credencial.
  5. Una server card de MCP si tienes un servidor, declarando tanto las capacidades que te faltan como las que tienes.
  6. Un manifiesto de agent skills con digest, si publicas skills.
  7. /.well-known/security.txt: con una fecha de expiración que de verdad vayas a renovar.

Luego integra una cosa en tu proceso de lanzamiento: regenera los manifiestos cada vez que cambie el servicio. Los archivos cuestan poco publicarlos y es fácil olvidarlos.

FAQ

¿llms.txt es un estándar?

Es una convención ampliamente adoptada más que un estándar del IETF. Los archivos de /.well-known/ que lo acompañan —api-catalog, metadatos de recurso protegido, security.txt— sí son RFC reales.

¿Publicar estos archivos ayuda al SEO?

No directamente. Ayudan a los agentes y asistentes a usar tu servicio correctamente una vez que llegan. Trátalos como documentación de integración en una dirección convencional, no como un factor de posicionamiento.

¿Debo publicar un api-catalog si solo tengo una API?

Sí: el valor está en la ubicación predecible, no en la cantidad de entradas. Un ancla con una descripción legible por máquinas es suficiente.

¿Por qué publicar metadatos de recurso protegido sin OAuth?

Porque los clientes los buscan de todos modos. Responder con el identificador del recurso y cómo se envían las credenciales es más útil que un 404, incluso cuando la respuesta para tu API principal es «usamos API keys, no OAuth». TronSave hace ambas cosas: metadatos de API key en tronsave.io y un inicio de sesión OAuth completo para su endpoint MCP.

¿Cómo obtengo una API key de TronSave?

Conecta una billetera TRON en el sitio e inicia sesión, o usa la sección de información de usuario del bot de Telegram. No hay un endpoint de registro programático para API keys, y el documento de autenticación lo dice claramente en lugar de dejar que lo descubras tú. Las apps MCP que se conectan mediante el inicio de sesión OAuth se saltan este paso: la página de inicio de sesión te pide tu clave o una firma de billetera.

¿Por dónde empiezo si solo quiero usar la API?

Los SDK oficiales la envuelven en cinco lenguajes, y la guía de automatización con la API cubre los endpoints directos. Los archivos de descubrimiento son para agentes que tienen que encontrar el camino por sí solos.

Conclusión

Hacer que un servicio sea legible para un agente de IA no es tanto una disciplina nueva como una antigua con un público nuevo: di qué eres, enumera lo que expones, sé exacto con las credenciales y admite lo que no soportas. Los archivos son convencionales y el esfuerzo es pequeño. Lo que exige verdadera disciplina es mantenerlos al día, porque un agente creerá tu manifiesto justo hasta el momento en que el servidor lo contradiga.

TronSave publica este blog y los archivos de descubrimiento descritos aquí. El contenido de los archivos, el número de herramientas y las versiones del protocolo reflejan lo que estaba publicado y lo que devolvía el servidor en vivo en el momento de escribir, y cambiarán: enuméralos en tiempo de ejecución en lugar de fiarte de las cifras citadas arriba. Esto no es asesoramiento financiero.

TronSave
TronSave

El equipo de TronSave desarrolla el mercado de energía y ancho de banda de TRON en tronsave.io y escribe estas guías a partir de pruebas reales en la red principal de TRON.

Artículos relacionados

Usamos Google Analytics para saber qué guías ayudan a los lectores. Solo instala cookies si permites la analítica. El blog no muestra anuncios. Privacidad