DOCSEARCHbyAlgolia
Submit Docs

Me.LOL Agent Instructions

website·Indexed 33 days ago

https://me.lol/products/put-it-on-a-free-shirt?domain=pei.lol&sig=42aea962e4090a0ab2bce4801e0bbe1b537c5b24e9c3f98d3e8250ed1c1da259

Guidelines for AI agents and personal shopping assistants interacting with the Me.LOL online store, including implementation of the Universal Commerce Protocol (UCP).

Tokens
639
Snippets
3
Records
5
Agent score
19%

What's inside Me.LOL

  1. Execute a standard UCP commerce flow

    The typical sequence for an agent to complete a purchase using the UCP MCP endpoint is as follows:

    1. Discover: Call GET /.well-known/ucp to confirm capabilities.
    2. Search: Use the search_catalog tool to find products.
    3. Cart: Use create_cart to add items.
    4. Checkout: Use create_checkout to initiate the purchase.
    5. Fulfill: Use update_checkout to specify shipping address and method.
    6. Complete: Use complete_checkout to finalize the order (requires buyer approval).

  2. Use the Shop skill for personal shopping agents

    For agents acting as personal assistants or shopping agents, the Shop skill is the recommended method for transacting across Shopify stores (including me.lol). It provides a more reliable alternative to screen-scraping or scripting by handling cross-store catalog search, buyer-approved checkout via Shop Pay (removing the need for the agent to handle credit cards), order tracking, and reuse of authorized identity and payment methods.
    https://shop.app/SKILL.md

  3. Configure UCP requests for Me.LOL

    When interacting with the Me.LOL UCP endpoints, adhere to the following constraints:

    • Versions: Supported versions include 2026-08-25 (latest stable), 2026-04-08, and 2026-01-23.
    • Context: Pass context.address_country and context.currency to ensure accurate pricing and product availability.
    • Rate Limiting: The MCP endpoint is rate-limited per IP. Implement a back-off strategy upon receiving 429 responses.

  4. Perform read-only browsing of the Me.LOL store

    Agents can access store data without authentication using the following endpoints:
    # Product Data
GET /collections/all                      # Browse all products
GET /products/{handle}                      # Product page
GET /products/{handle}.json                 # Product JSON
GET /collections/{handle}                   # Collection page
GET /collections/{handle}/products.json    # Collection JSON
GET /search?q={query}&type=product          # Search products

# Store Metadata
GET /sitemap.xml                            # Sitemap
GET /agents.md                              # Canonical agent description

  5. Interact with Me.LOL using the Universal Commerce Protocol (UCP)

    Me.LOL implements the Universal Commerce Protocol (UCP) for agent-driven commerce. Agents can discover store capabilities and execute commerce tasks via two primary endpoints. All checkouts require explicit human approval; agents must not complete payments without buyer consent.
    # Discovery: Returns merchant profile, supported versions, and capabilities
GET https://me.lol/.well-known/ucp

# MCP Endpoint: Used to discover and execute tools
POST https://me.lol/api/ucp/mcp
Content-Type: application/json