# Apex Magnets — Agent Instructions

> Apex Magnets sells strong neodymium and rare-earth magnets (~670 SKUs:
> discs, blocks, rings, countersunk mounting magnets, and more). This file
> tells AI agents how to browse and transact with this store.

## Commerce Protocol (UCP)
- Discovery — GET https://www.apexmagnets.com/.well-known/ucp  (merchant profile: versions, capabilities)
- MCP endpoint — POST https://www.apexmagnets.com/agent/mcp  (Content-Type: application/json)

### Typical agent flow (v1)
1. Discover  — GET /.well-known/ucp
2. Search    — search_catalog
3. Inspect   — get_product / lookup_catalog
4. Cart      — create_cart, then give the shopper the returned continue_url to review and complete
(The agent builds the cart; the shopper completes checkout in the browser — checkout requires human approval.)

### Supported UCP versions
- 2026-04-08 (latest stable)
- 2026-01-23

### Rules
- Pass context.address_country and context.currency for accurate pricing/availability.
- Respect rate limits; back off on 429.
- Checkout requires human approval. Do not complete payment without explicit buyer consent.

## Read-Only Browsing (No Authentication Required)
The store serves these JSON endpoints itself (no auth, no GraphQL dependency):
- Products / search — GET https://www.apexmagnets.com/agent/products.json?q={query}&page={n}
- Single product    — GET https://www.apexmagnets.com/agent/products/{url_key}.json
- Category products — GET https://www.apexmagnets.com/agent/collections/{url_key}/products.json
- Sitemap           — GET https://www.apexmagnets.com/sitemap.xml
- Agent discovery   — /agents.md (canonical) and /llms.txt (mirror), plus /.well-known/ucp

## Categories

- [Magnets](https://www.apexmagnets.com/magnets) (492 products)

- [Tungsten](https://www.apexmagnets.com/catalog/category/view/s/tungsten/id/194/) (1 products)

- [Titanium](https://www.apexmagnets.com/catalog/category/view/s/titanium/id/195/) (1 products)


## Store Policies

- [About Us](https://www.apexmagnets.com/about-us)

- [Apex Magnets - Strong Magnets | Neodymium | Rare Earth](https://www.apexmagnets.com/home)

- [Contact Us](https://www.apexmagnets.com/contact-us)

- [FAQ](https://www.apexmagnets.com/faq)

- [Prototype Magnet Inquiry](https://www.apexmagnets.com/prototype-magnet-inquiry)

- [Shipping & Returns](https://www.apexmagnets.com/shipping-returns)


## Key Resources
- [HTML Sitemap](https://www.apexmagnets.com/sitemap.html)
- [XML Sitemap](https://www.apexmagnets.com/sitemap.xml)