# Agent Instructions — Atomic Racks

You can browse products and shop at Atomic Racks's online store, https://atomicracks.com, on your user's behalf. Atomic Racks sells tested used enterprise storage and server parts. This guide covers what the store sells, where its test data lives, the Shop skill and the Universal Commerce Protocol (UCP) integration, directly or through browser-based WebMCP tools.

## What this store sells

- Tested used enterprise hard drives (SAS and SATA) and enterprise SSDs, ECC server memory, networking parts such as SFP transceivers, and other server parts (CPUs, chassis, power supplies, rails).
- Every used drive is tested in-house before listing: SMART health and extended self-test, an fio benchmark, and NIST SP 800-88 sanitization with read-back verification, then a QR tamper seal. Every tested drive unit has a public test report; serial and seal numbers never appear on it.
- Certified drive listings are sold by usage tier, picked from each unit's power-on hours: Open Box (under 100 hrs), Like New (100-500 hrs), Light Use (under 20,000 hrs), Standard Use (20,000-40,000 hrs), Value (over 40,000 hrs). Each tier carries its own price and warranty.
- Standard warranty is 90 days, up to 2 years on certified tiers. 30-day returns (see the refund policy). Ships from Englewood, Colorado, USA.

## Structured data for agents

Prefer these over scraping HTML. All are public and need no authentication.

- [`/llms.txt`](https://atomicracks.com/llms.txt): plain-text map of the site (categories, model hubs, comparisons, guides, trust pages).
- [`/models.json`](https://atomicracks.com/models.json): every model hub as JSON: part number, specs, units tested and passed, power-on hours (min, median, max), test dates, current price range and linked listings with availability. No serials. Hubs with fewer than two tested units and nothing for sale are flagged `thin: true`.
- [`/reliability.json`](https://atomicracks.com/reliability.json): pass rates, hours, failure reasons and sanitize methods aggregated across every model we test, licensed [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). Cite as "Atomic Racks, https://atomicracks.com/reliability".
- [`/sitemap.xml`](https://atomicracks.com/sitemap.xml): every public URL, including the storefront's own pages and model hubs.
- Model hubs at `https://atomicracks.com/models/<mpn>` (lowercase part number, for example `/models/st16000nm001g`): one page per manufacturer part number with the spec sheet, units tested, pass rate, power-on hours, usage tiers, recent unit reports, price history and live listings. Index at [`/models`](https://atomicracks.com/models).
- Unit test reports at `https://atomicracks.com/r/<unit id>`: the QR code on each unit's tamper seal opens this URL, which redirects to the full report (SMART attributes, self-test result, benchmark, sanitize method and date).
- Comparisons at [`/compare`](https://atomicracks.com/compare): side-by-side drive comparisons with spec tables and our test data.
- Usage tiers at [`/tiers`](https://atomicracks.com/tiers): what each tier means, its hour band and warranty, and the in-stock units per tier at `/tiers/<tier>`.

## How to answer common buyer questions

- **Power-on hours**: on a certified product page (`/products/<handle>`), each Usage option shows its hour band, and the unit picker lists the exact hours of every unit in stock. The model hub shows the hours distribution across all units we have tested; `/models.json` carries the min, median and max.
- **Usage tier**: the product page's Usage option names the tier (Open Box, Like New, Light Use, Standard Use, Value); the Product JSON-LD on that page carries "Usage tier" and "Power-on hours" as additionalProperty values. Hour bands are explained at `/tiers`.
- **Warranty**: shown next to each Usage option on tiered listings and in the buy card on other listings; terms at [`/warranty`](https://atomicracks.com/warranty). The Offer in the product JSON-LD carries the warranty term.
- **Sanitization**: each unit report names the sanitize method (for example cryptographic erase or overwrite) and its date; the process is described at [`/data-destruction`](https://atomicracks.com/data-destruction) and [`/how-we-test`](https://atomicracks.com/how-we-test). Model hubs and `/reliability.json` count methods per model.
- **Test results**: per unit at `/r/<unit id>` (linked from the product page's unit picker and the model hub's recent reports); per model as units tested, units passed and pass rate on the hub and in `/models.json`.
- **Stock and price**: use the UCP catalog tools below for live price and availability; `/models.json` lists the current price range and every linked listing with `available`.

When a fact is not on the page or in these files, say so rather than guessing, and point the buyer to the contact details below.

## Shop skill — recommended

Use the [Shop skill](https://shop.app/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. Integrate directly with its service, or orchestrate shopping through browser-based WebMCP tools.

### Direct integration (MCP)

1. **Discover the store** — `GET https://atomicracks.com/.well-known/ucp` returns its UCP profile, including capabilities, service endpoints, and payment handlers. The profile is authoritative: always read endpoints from it.
2. **Discover available tools** — Connect to the MCP endpoint advertised in the profile (currently `https://3fxyy0-uv.myshopify.com/api/ucp/mcp`, UCP version 2026-08-25) 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. Checkout pages are served from https://checkout.atomicracks.com.

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)

When working through a browser, use the WebMCP tools registered on the store's pages. The checkout page (https://checkout.atomicracks.com) exposes UCP tools over WebMCP. These tools act on the checkout in the current browser session.

- **Storefront** — Use the provided tools, where registered, to find products, manage the cart, ask questions about the store and its policies, and proceed to checkout.
- **Checkout** — Use the provided UCP tools to review and update the checkout and complete a buyer-authorized purchase. Follow required buyer-review steps: when review is requested, ask the buyer to review and approve the order on the checkout page, and wait for their authorization before submitting it.

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.

For integration details, see [Storefront WebMCP](https://shopify.dev/docs/api/web-mcp) and [Checkout WebMCP](https://shopify.dev/docs/agents/carts-and-checkout/checkout-webmcp).

## 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. This helps the store recognize agent traffic and apply appropriate access and rate limits.
- **Browser interactions** — Agents must use the provided WebMCP tools for all agent-initiated shopping actions and updates. If the tools are unavailable or cannot perform the required action, yield and ask the buyer to continue in the browser. Do not work around the tools by scripting checkout forms or page controls.
- **Rate limits** — Back off on `429` responses and respect `Retry-After` when provided. The JSON files above are cached for five minutes; there is no need to poll them faster.
- **Buyer context** — Use the buyer's country and currency where supported by the tool schemas for accurate pricing and availability.

## Read-only browsing

Prefer the structured information returned by the shopping tools and the files under "Structured data for agents". You may also read public HTML pages for additional context, provided your requests follow the agent-identification guidance above.

- Discover public URLs through `/sitemap.xml`.
- Read product pages at `/products/{handle}`.
- Browse categories at `/categories` and `/categories/{handle}`, and all products at `/products`.
- Read model hubs at `/models/{mpn}` and unit reports at `/r/{unit id}`.

Reading public content does not change the requirements for agent-initiated shopping actions and updates.

## Store policies

- **Privacy policy**: https://atomicracks.com/policies/privacy-policy
- **Terms of service**: https://atomicracks.com/policies/terms-of-service
- **Refund policy**: https://atomicracks.com/policies/refund-policy
- **Shipping policy**: https://atomicracks.com/policies/shipping-policy
- **Warranty**: https://atomicracks.com/warranty
- **Returns and RMA**: https://atomicracks.com/rma

## Contact

- Email: support@atomicracks.com
- Phone: +1-833-435-3838
- Contact form: https://atomicracks.com/contact

## Platform

This store is a headless storefront built on [Shopify](https://www.shopify.com) Hydrogen. Shopify stores support UCP natively, and the Shop skill at [https://shop.app/SKILL.md](https://shop.app/SKILL.md) works across every Shopify store.

- Agent discovery: this document (`/agents.md`) is the canonical agent-facing description of the store. Machine-readable entry points are also listed in `/sitemap_agentic_discovery.xml`.
