{
  "version": "1.0",
  "generated_at": "2026-08-14",
  "components": {
    "org_profile": {
      "domain": "agentlibrary.ori.lat",
      "legal_name": "Agent Library Livraria Digital LTDA",
      "display_name": "Agent Library",
      "url": "https://agentlibrary.ori.lat",
      "description": "Livraria brasileira com catálogo, preços, prazos de entrega e políticas legíveis por máquina. Todo o fluxo de compra, do catálogo ao recibo, está disponível por API documentada e por navegação comum.",
      "vertical": "ecommerce",
      "archetype": "b2c",
      "country": "BR",
      "languages": [
        "pt-BR"
      ],
      "currencies": [
        "BRL"
      ],
      "contact": {
        "support": "contato@agentlibrary.ori.lat",
        "security": "security@agentlibrary.ori.lat"
      }
    },
    "capability_endpoint": {
      "base_url": "https://agentlibrary.ori.lat/api/v1",
      "openapi": "https://agentlibrary.ori.lat/openapi.json",
      "capabilities": [
        {
          "id": "catalog.search",
          "name": "Buscar livros no catálogo",
          "method": "GET",
          "path": "/api/v1/books",
          "auth": "none",
          "description": "Busca por título, autor, editora, ISBN ou tema."
        },
        {
          "id": "catalog.read_item",
          "name": "Ler um livro",
          "method": "GET",
          "path": "/api/v1/books/{sku}",
          "auth": "none",
          "description": "Identidade, preço, disponibilidade e estoque de um título."
        },
        {
          "id": "shipping.quote",
          "name": "Cotar frete",
          "method": "GET",
          "path": "/api/v1/shipping/quote",
          "auth": "none",
          "description": "Devolve as quatro modalidades com preço, prazo em dias úteis e total já somado."
        },
        {
          "id": "cart.create",
          "name": "Criar carrinho",
          "method": "POST",
          "path": "/api/v1/carts",
          "auth": "oauth2",
          "scopes": [
            "cart:write"
          ],
          "description": "Cria um carrinho com itens e modalidade de entrega."
        },
        {
          "id": "mandate.create",
          "name": "Criar mandato de pagamento",
          "method": "POST",
          "path": "/api/v1/mandates",
          "auth": "oauth2",
          "scopes": [
            "mandate:create"
          ],
          "description": "Cria a autorização de gasto, com escopo, limite, validade e caminho de revogação."
        },
        {
          "id": "mandate.revoke",
          "name": "Revogar mandato",
          "method": "DELETE",
          "path": "/api/v1/mandates/{id}",
          "auth": "oauth2",
          "scopes": [
            "mandate:create"
          ],
          "description": "Revoga imediatamente a autorização de gasto."
        },
        {
          "id": "order.place",
          "name": "Executar a compra",
          "method": "POST",
          "path": "/api/v1/orders",
          "auth": "oauth2",
          "scopes": [
            "order:write",
            "payment:execute"
          ],
          "description": "Cria o pedido e executa a cobrança dentro do limite do mandato informado."
        },
        {
          "id": "order.read",
          "name": "Ler pedido",
          "method": "GET",
          "path": "/api/v1/orders/{id}",
          "auth": "oauth2",
          "scopes": [
            "receipt:read"
          ],
          "description": "Estado, itens e totais do pedido."
        },
        {
          "id": "order.receipt",
          "name": "Obter recibo",
          "method": "GET",
          "path": "/api/v1/orders/{id}/receipt",
          "auth": "oauth2",
          "scopes": [
            "receipt:read"
          ],
          "description": "Recibo estruturado do pedido pago."
        },
        {
          "id": "order.tracking",
          "name": "Rastrear pedido",
          "method": "GET",
          "path": "/api/v1/orders/{id}/tracking",
          "auth": "oauth2",
          "scopes": [
            "receipt:read"
          ],
          "description": "Código de rastreio e eventos logísticos."
        },
        {
          "id": "order.cancel",
          "name": "Cancelar pedido",
          "method": "POST",
          "path": "/api/v1/orders/{id}/cancel",
          "auth": "oauth2",
          "scopes": [
            "order:write"
          ],
          "description": "Cancela o pedido e estorna o valor ao mandato."
        }
      ]
    },
    "auth_profile": {
      "type": "oauth2",
      "issuer": "https://agentlibrary.ori.lat",
      "metadata": "https://agentlibrary.ori.lat/.well-known/oauth-authorization-server",
      "documentation": "https://agentlibrary.ori.lat/auth.md",
      "scopes": [
        {
          "name": "catalog:read",
          "description": "Ler catálogo, preços, estoque e prazos de entrega."
        },
        {
          "name": "cart:write",
          "description": "Criar e alterar carrinhos."
        },
        {
          "name": "order:write",
          "description": "Criar pedidos a partir de um carrinho."
        },
        {
          "name": "mandate:create",
          "description": "Criar mandatos de pagamento com limite de valor e prazo de validade."
        },
        {
          "name": "payment:execute",
          "description": "Executar cobrança dentro do limite de um mandato válido."
        },
        {
          "name": "receipt:read",
          "description": "Ler recibos, rastreio e histórico de pedidos."
        }
      ],
      "pkce_required": true
    },
    "payment_profile": {
      "mandate_required": true,
      "mandate_endpoint": "https://agentlibrary.ori.lat/api/v1/mandates",
      "mandate_fields": [
        "scope",
        "limit",
        "duration",
        "revocation"
      ],
      "currencies": [
        "BRL"
      ],
      "environment": "sandbox",
      "note": "Processador interno de teste. Nenhum cartão real é processado e nenhum valor é movimentado."
    },
    "protocol_metadata": {
      "mcp": {
        "endpoint": "https://agentlibrary.ori.lat/.well-known/mcp",
        "protocol_version": "2024-11-05"
      },
      "openapi": {
        "url": "https://agentlibrary.ori.lat/openapi.json",
        "version": "3.1.0"
      },
      "llms_txt": "https://agentlibrary.ori.lat/llms.txt"
    },
    "validation_endpoints": {
      "health": "https://agentlibrary.ori.lat/api/v1/health",
      "evidence": "https://agentlibrary.ori.lat/api/v1/evidence/runs/{orderId}",
      "agent_traffic": "https://agentlibrary.ori.lat/api/v1/observability/agent-traffic"
    },
    "policies": {
      "shipping": "https://agentlibrary.ori.lat/politicas/entrega",
      "returns": "https://agentlibrary.ori.lat/politicas/devolucao",
      "privacy": "https://agentlibrary.ori.lat/politicas/privacidade",
      "terms": "https://agentlibrary.ori.lat/politicas/termos"
    }
  }
}