{
  "specVersion": "1.0",
  "host": {
    "displayName": "Loyaltie",
    "documentationUrl": "https://loyaltie.com/agents.md"
  },
  "entries": [
    {
      "identifier": "urn:air:loyaltie.com:mcp:catalog",
      "displayName": "Loyaltie MCP server",
      "type": "application/mcp-server-card+json",
      "url": "https://loyaltie.com/.well-known/mcp/server-card.json",
      "description": "Search the catalog of products from small independent makers, read full product and maker cards, and build one cart across makers that the person opens and pays for on loyaltie.com, where they sign in or create an account. The cart may already include an optional paid Loyaltie+ membership, which the person can turn off before they pay, so ask them to check the total.",
      "capabilities": [
        "search_catalog",
        "lookup_catalog",
        "get_product",
        "get_maker",
        "build_cart_link",
        "create_cart",
        "get_cart"
      ],
      "representativeQueries": [
        "find a handmade gift from an independent maker",
        "search for small-batch hot sauce from a maker near a given city",
        "put a candle and a mug from two different makers in one cart"
      ]
    },
    {
      "identifier": "urn:air:loyaltie.com:ucp:profile",
      "displayName": "Loyaltie UCP profile",
      "type": "application/json",
      "url": "https://loyaltie.com/.well-known/ucp",
      "description": "The Universal Commerce Protocol merchant profile: the shopping service endpoints and the cart capability. The profile and the cart endpoint can be switched off: a 404 from the profile, or a 503 service_unavailable with Retry-After from /ucp/v1/carts, means agent carts are off for now. Build a cart link instead.",
      "representativeQueries": [
        "which UCP services and capabilities does Loyaltie support",
        "transfer a shopping cart to Loyaltie over UCP"
      ]
    },
    {
      "identifier": "urn:air:loyaltie.com:ucp:openapi",
      "displayName": "Loyaltie UCP REST API",
      "type": "application/vnd.oai.openapi+json;version=3.0",
      "url": "https://api.loyaltie.com/ucp/v1/openapi.json",
      "description": "The OpenAPI 3.0 contract of the UCP cart REST API (createCart and getCart) under /ucp/v1: operations, typed responses and errors, and rate limits.",
      "representativeQueries": [
        "create a cart with products from several makers over REST",
        "check the current prices and availability of a Loyaltie cart"
      ]
    },
    {
      "identifier": "urn:air:loyaltie.com:guide:agents",
      "displayName": "Loyaltie guide for AI agents",
      "type": "text/markdown",
      "url": "https://loyaltie.com/agents.md",
      "description": "How AI agents find products on Loyaltie, link to them and build a cart link, and the rules to follow.",
      "representativeQueries": [
        "how should an AI agent shop on Loyaltie",
        "how do I send a person to a Loyaltie cart with several products"
      ]
    },
    {
      "identifier": "urn:air:loyaltie.com:guide:llms-txt",
      "displayName": "Loyaltie llms.txt",
      "type": "text/plain",
      "url": "https://loyaltie.com/llms.txt",
      "description": "A short index of the agent files in the llms.txt format: the guide, the catalog and the policies.",
      "representativeQueries": [
        "what is Loyaltie and what does it sell",
        "where are Loyaltie's machine-readable catalog files"
      ]
    },
    {
      "identifier": "urn:air:loyaltie.com:guide:llms-full-txt",
      "displayName": "Loyaltie llms-full.txt",
      "type": "text/plain",
      "url": "https://loyaltie.com/llms-full.txt",
      "description": "The full agent guide as plain text, at the llms-full.txt location.",
      "representativeQueries": [
        "read the whole Loyaltie guide for AI agents as plain text",
        "what rules must an AI agent follow on Loyaltie"
      ]
    },
    {
      "identifier": "urn:air:loyaltie.com:catalog:manifest",
      "displayName": "Loyaltie catalog manifest",
      "type": "application/json",
      "url": "https://loyaltie.com/agents/catalog/manifest.json",
      "description": "The entry point to the published catalog files: product and maker counts, the index, makers and category files, and the product card URL templates.",
      "representativeQueries": [
        "download the catalog of products from independent makers",
        "list the product categories on Loyaltie"
      ]
    }
  ]
}
