# Agent Instructions: PQ Golf You can browse products and shop at PQ Golf's online store, https://pqgolf.se, on your user's behalf. PQ Golf (ProQuality AB) is a Swedish purchasing cooperative of independent golf pro shops, from Boden in the north to Ystad in the south. Online orders ship from the member shop that holds the item in stock, and customers can book custom club fitting with PGA professionals in the shops. ## Shop skill (recommended) Use the [Shop skill](https://shop.com/SKILL.md) to help your user shop with this store. Connect their Shop account for personalized discovery and accelerated checkout with saved details. - Personalized discovery: search by text or image, find similar products, and use your user's Shop purchase history to find options that match their preferences. - Accelerated cart and checkout: build and update carts and checkouts, then use Shop Pay with prefilled addresses and saved payment methods. - Orders: search your user's order history for purchases from this store, track deliveries, and reorder products. Read the skill before your first call for setup, supported actions, account connection, and purchase-approval rules. ## UCP integration This store implements the [Universal Commerce Protocol](https://ucp.dev) for product discovery, carts, and checkout. ### Direct integration (MCP) 1. **Discover the store**: `GET https://pqgolf.se/.well-known/ucp` returns its UCP profile, including capabilities, service endpoints, and payment handlers. 2. **Discover available tools**: connect to the MCP endpoint advertised in the profile (Shopify's endpoint for this store; `https://pqgolf.se/api/ucp/mcp` proxies the same endpoint) and use `tools/list` to retrieve available tools and their schemas. 3. **Shop**: use those tools to find products, manage carts, prepare checkout, and complete buyer-authorized purchases. Follow returned statuses, messages, and handoff URLs when buyer action is required. Use a compatible UCP version and follow the returned tool schemas. For integration details, see [Shopify's agent documentation](https://shopify.dev/docs/agents). ### Browser integration (WebMCP) The checkout (https://checkout.pqgolf.se) exposes UCP tools over WebMCP; these act on the checkout in the current browser session. Storefront pages on pqgolf.se do not register WebMCP tools, so use the MCP endpoint above for storefront actions such as search and cart. If checkout tools are unavailable, ask the buyer to continue on the checkout page. Do not fall back to scripted form fills or page controls. ## Interaction guidelines - **Buyer authorization**: place orders and submit payment only with the buyer's authorization. Follow required review and approval steps. - **Agent traffic**: agents must identify their requests as agent-initiated. Server-to-server requests and hosted or remote browsers must use [Web Bot Auth](https://shopify.dev/docs/api/storefront#identifying-bots-with-web-bot-auth) and follow the service's authentication requirements. - **Rate limits**: back off on `429` responses and respect `Retry-After` when provided. - **Buyer context**: prices are in SEK including VAT, and the store ships within Sweden. - **Prices and stock**: use the tools for live price and availability. Per-store stock on the website is indicative. Only present a discount when the page shows the lowest price of the last 30 days (EU price indication rules). ## Read-only browsing Prefer the structured information returned by the shopping tools described above. You may also read public HTML pages; every page is server-rendered and includes schema.org JSON-LD (Product with per-variant Offers, BreadcrumbList, FAQPage where available). - Discover public URLs through `https://pqgolf.se/sitemap.xml`. - Product pages: `/{category}/{handle}` (for example `/drivers/{handle}` or `/golfklubbor/{handle}`). `/produkt/{handle}` resolves to the canonical URL, and `?variant={id}` preselects a variant. - Categories and brands: `/{handle}`, brand overview at `/varumarken`. - Stores: all member shops with address and contact details at `/butiker`, each shop at `/butiker/{slug}` including the products it has in stock. - Demo and used clubs: `/begagnat`. - Club finder (4 questions): `/klubbfinder`. Golf glossary: `/sida/golftermer`. - Buying guides (custom fitting, used and demo clubs, choosing a driver): `/guider`, each guide at `/guider/{slug}`. - Product pages list similar products and, where PQ has chosen them, matching accessories. - Full reference for language models (store directory, categories, brands, policies): `/llms-full.txt`. - Custom fitting: book at `/boka-fitting`. ## Store policies - **Integritetspolicy (privacy)**: https://pqgolf.se/integritet - **Köp- och leveransvillkor (terms)**: https://pqgolf.se/kopvillkor - **Retur och ångerrätt (14 days, customer pays return shipping, custom-fitted clubs excluded)**: https://pqgolf.se/retur - **Ångra ditt köp (EU withdrawal form)**: https://checkout.pqgolf.se/pages/eu-angerformular - **Leverans (shipping 79 SEK, free from 1 000 SEK, 2 to 4 business days)**: https://pqgolf.se/leverans - **Kontakt**: https://pqgolf.se/kontakt ## Platform This store is built on [Shopify](https://www.shopify.com) with a custom storefront. Shopify stores support UCP natively. The Shop skill at [https://shop.com/SKILL.md](https://shop.com/SKILL.md) works across every Shopify store. - Agent discovery: this document (`/agents.md`) is the canonical agent-facing description of the store.