# Agent instructions — Lichcards > Lichcards is an online shop for trading card games, individual cards, card storage and protection accessories, and board games. Use the public storefront to compare products and read current product details; use Shopify's advertised commerce protocol for a buyer-approved purchase. Store: https://lichcards.nl ## When to use Lichcards - Find sealed trading card products and individual cards, including their variant, language, condition, price and current availability. - Compare sleeves, albums, binders, deckboxes and other accessories using the collection filters and each product's stated dimensions, capacity and contents. Do not infer compatibility from a photo alone. - Browse board games and read their player count, age range, play time and language when those details are supplied on the product page. - Read shipping, returns, contact and card-selling information before making a recommendation. For card-selling requests, use the published selling page; the public product API does not submit a quote. Start with the [catalog](https://lichcards.nl/collections/all), [product search](https://lichcards.nl/search?type=product), [accessories](https://lichcards.nl/collections/tcg-accessoires), [board games](https://lichcards.nl/collections/bord-gezelschapsspellen), or [sell Pokémon cards](https://lichcards.nl/pages/pokemon-kaarten-verkopen). ## Documentation and discovery - [Lichcards public API guide and OpenAPI download](https://lichcards.nl/?view=agent-docs): read-only endpoints, examples, price formats and error handling. The guide links to the current theme's OpenAPI document. - [Canonical agent instructions](https://lichcards.nl/agents.md): this document. - [LLM discovery index](https://lichcards.nl/llms.txt): a concise index of useful resources. - [Sitemap](https://lichcards.nl/sitemap.xml): published storefront URLs. - [UCP merchant discovery](https://lichcards.nl/.well-known/ucp): the current platform capabilities, service endpoints and protocol schemas. ## Read-only browsing without authentication The Shopify storefront Ajax API requires no API key or access token. The documented read-only operations below do not grant access to customer records, orders, payments or store administration. No OAuth scopes are required for these public GET operations. Use locale-aware paths. In a storefront browser, `window.Shopify.routes.root` provides the active locale prefix. Keep the visitor's country, language and currency context consistent across requests rather than assuming that a translated URL selects a country. - `GET /products/{handle}.js`: product details, variants, numeric Shopify money values and current availability. This endpoint returns a JSON body; Shopify can label the response `text/javascript`. - `GET /search/suggest.json?q={query}&resources[type]=product&resources[limit]=3`: product suggestions as JSON. URL-encode the query and query parameter names. - `GET /cart.js`: only the current visitor session's cart and presentment currency. An anonymous request starts with an empty cart. Do not publish or reuse cart tokens or another visitor's cookies. - `GET /products/{handle}.json`: additional public product JSON, with a different response structure and decimal price strings from the Ajax `.js` format. - `GET /collections/{handle}/products.json?limit=1`: public collection product data. - `GET /search?q={query}&type=product`: complete product search in server-rendered HTML. - `GET /collections/{handle}` and `GET /products/{handle}`: collection and product pages in server-rendered HTML. The Ajax product price `295` represents EUR 2.95 in an EUR session. Predictive search and the `.json` product endpoint use decimal strings instead, such as `"2.95"`. Do not mix these formats. The primary store currency is EUR; check `/cart.js` for the active presentment currency. Recheck the selected product variant before purchase. Shipping costs, discounts, taxes and the final amount are established by checkout; the product price alone does not guarantee a delivered total. ## JSON errors and recovery Check the HTTP status before parsing a response. Predictive search returns structured JSON for invalid parameters, including `status`, `message` and `description`. For example, an unsupported `resources[type]` value returns HTTP 422; correct the parameter rather than retrying the same request. A missing product may return HTTP 404 with an empty body, so JSON parsing is not guaranteed on every error. Search for the correct handle or return to the [sitemap](https://lichcards.nl/sitemap.xml). For HTTP 429, respect `Retry-After` when present and retry with backoff. Do not repeatedly fetch the full catalog when a product lookup or a small search result is sufficient. ## Buyer-approved commerce through Shopify For personal shopping assistants and agents acting on behalf of a buyer, the [Shop skill](https://shop.app/SKILL.md) is Shopify's recommended route for product discovery, buyer-approved Shop Pay checkout and order tracking. Ask the buyer before installing a skill. It can reuse identity, address and payment information the buyer has already authorized without exposing card details to the agent. Shopify publishes the store's Universal Commerce Protocol metadata: - Discovery: `GET https://lichcards.nl/.well-known/ucp`. - MCP endpoint: `POST https://lichcards.nl/api/ucp/mcp` with `Content-Type: application/json`. Initialize an MCP session and use `tools/list` to discover the current tool schemas; follow the service endpoint and protocol version in the merchant discovery response. - Supported UCP versions: - 2026-08-25 (latest supported) - 2026-04-08 - 2026-01-23 The platform's advertised flow is discover, search, create a cart, create a checkout, set fulfillment details, and complete the checkout. Use the tool names and inputs returned by `tools/list`; pass the buyer's country and currency using the supported context fields. Platform commerce tools can change a cart or checkout, unlike the public GET operations above. Payment always requires explicit buyer approval at the time of purchase. If contemporaneous approval is unavailable, stop before payment and hand the buyer the checkout or use the Shop skill's approval flow. Do not access private orders or customer data without the buyer's applicable authorization. Follow the advertised authentication and agent-profile requirements; this theme does not issue API keys, define OAuth scopes or replace Shopify's MCP server. ## Published policies - [Privacy policy](https://lichcards.nl/policies/privacy-policy). - [Terms of service](https://lichcards.nl/policies/terms-of-service). - [Refund policy](https://lichcards.nl/policies/refund-policy). - [Shipping policy](https://lichcards.nl/policies/shipping-policy). Read the current policy pages instead of assuming a fixed shipping rate, delivery date or return rule for every country. Public discovery documents are broadly cached; they do not contain private merchant, customer, order or payment data. ## Platform references - [Shopify Ajax API](https://shopify.dev/docs/api/ajax): supported storefront requests and locale-aware URLs. - [Shopify agent quickstart](https://shopify.dev/docs/agents/get-started/quickstart): Shopify's agent setup and UCP tooling. - [UCP specification](https://ucp.dev): commerce protocol requirements. - [Shop skill](https://shop.app/SKILL.md): buyer-approved shopping.