Un agente que solo tiene https://luniumpay.com debe llegar hasta aquí por sí mismo. No puede depender de que conozca una convención nuestra.
GET https://luniumpay.com
↳ Link: </.well-known/api-catalog>; rel="api-catalog" (RFC 8288)
GET https://luniumpay.com/.well-known/api-catalog (RFC 9727)
Content-Type: application/linkset+json
↳ service-desc → OpenAPI
↳ service-doc → documentação, llms.txt
↳ service-meta → /mesh, agent-card, mcp.json, apis.json
GET https://api.luniumpay.com/mesh
↳ capacidades, intenções, execução, limites, como começar
llms.txt también lleva al mismo lugar, pero es una convención, no una norma. Por eso existe la cadena anterior: un agente que solo conoce RFC llega igualmente.Cada capacidad declara qué acepta y qué entrega. Un agente con la intención “tengo USDT y quiero reales brasileños mediante PIX” filtra por input_assets, output_currencies y payment_rails , sin tener que saber que la ruta se llama /cash-outs.
Intenciones indexadas actualmente (—):
…
| Dirección | Para qué |
|---|---|
/.well-known/api-catalog | RFC 9727: catálogo de APIs del dominio |
/.well-known/agent-card.json | A2A: capacidades y habilidades |
/.well-known/mcp.json | Descriptor del servidor MCP |
/.well-known/apis.json | APIs.json, para directorios |
/openapi.json | Contrato ejecutable |
/llms.txt | Contrato en prosa, para modelos |