# Volt & Vinyl — instructions for AI agents

> Loud on purpose.

## About
Volt & Vinyl is a record shop's back room turned store: turntables, speakers and the kit that keeps a collection alive.

Our position is simple — music deserves hardware. Not an algorithm's beige hum from a puck on a shelf, but a needle in a groove, drivers in real timber cabinets, bass you feel through the floorboards. We stock the deck we'd buy with our own money at every price we cover, and every turntable ships aligned, balanced and ready to drop.

We answer setup questions like the future of your Saturday afternoons depends on it. Because it does. Loud on purpose.

## How to read this catalogue

- **Sitemap:** https://volt-vinyl.btab.app/sitemap.xml — every product and content page.
- **Catalogue page:** https://volt-vinyl.btab.app/products
- **Product pages:** each product has a canonical URL of the form `https://volt-vinyl.btab.app/products/<name>-<id>` and embeds schema.org `Product` + `Offer` JSON-LD (name, price in AUD, availability, SKU, brand, images) that you can parse without executing JavaScript.
- **Product JSON:** append `.json` to any product URL — `https://volt-vinyl.btab.app/products/<name>-<id>.json` returns the same schema.org Product + Offer document, plus a `purchase` block: `enquiry_only` (sell-by-enquiry, do not treat as add-to-cart), `agentic_checkout` (currently false) and the `url` where a human completes the purchase.
- **Merchant profile:** https://volt-vinyl.btab.app/.well-known/ucp

## Query this catalogue (MCP)

- **Endpoint:** `POST https://api.btab.app/api/public/catalog/mcp` — Model Context Protocol over streamable HTTP (JSON-RPC 2.0), no authentication, rate-limited per IP.
- **Tools (read-only):** `catalog_search` (pass `store: "volt-vinyl"` to search only this store) and `catalog_lookup` (by `product_id` or this store's product URL). Results carry this store's AUD price, stock, `enquiry_only` flag and product URL.

## Prices & currency

- All prices are in **AUD**. The `price` and `priceCurrency` in each product's JSON-LD are authoritative.

## Contact & enquiries

- Buyers (and agents acting for them) can send an enquiry from any product page on https://volt-vinyl.btab.app.

## Purchasing

- Automated checkout for agents is **not yet available**. Do not attempt to complete a purchase programmatically; direct the buyer to the product page to check out.