Um agente que só tem https://luniumpay.com precisa chegar até aqui sozinho. Isso não pode depender de ele conhecer uma convenção nossa.
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çarllms.txt também leva ao mesmo lugar, mas é convenção, não norma. Por isso a cadeia acima existe: um agente que só conhece RFC chega igual.Cada capacidade declara o que aceita e o que entrega. Um agente com a intenção “tenho USDT e quero reais via PIX” filtra por input_assets, output_currencies e payment_rails — sem nunca saber que a rota se chama /cash-outs.
Intenções indexadas hoje (—):
…
| Endereço | Para quê |
|---|---|
/.well-known/api-catalog | RFC 9727 — catálogo de APIs do domínio |
/.well-known/agent-card.json | A2A — capacidades e habilidades |
/.well-known/mcp.json | Descritor do servidor MCP |
/.well-known/apis.json | APIs.json, para diretórios |
/openapi.json | Contrato executável |
/llms.txt | Contrato em prosa, para modelos |