# TR Spares — Guide for AI agents

> TR Spares (TR Spares) is a Sydney-based Land Rover and Range Rover parts specialist (since 1982) selling new genuine, OEM, aftermarket and second hand parts for Defender, Series, Discovery, Freelander and every Range Rover at https://www.trspares.com.au. Prices are in AUD and include GST. We deliver within Australia only, dispatching from Padstow, NSW.

This guide explains how AI agents and assistants can search our catalogue, read product details and get live shipping quotes. All endpoints below are public, read-only, return JSON and need no authentication.

**Scope:** only product catalogue data is available. Orders, customers, accounts and payments are not exposed and agents cannot place orders through the API — send shoppers to the product page (`url` field) to buy.

## Quick start

1. Search: `GET https://www.trspares.com.au/api/agent/products?q=discovery+3+brake+pads&max_price=200` (or a part number: `?q=LR014205`)
2. Details: `GET https://www.trspares.com.au/api/agent/products/{slug-or-sku}`
3. Shipping: `GET https://www.trspares.com.au/api/agent/shipping?postcode=2000&items={sku}:1` (e.g. `items=LR014205:1`)

Full schema: [OpenAPI spec](https://www.trspares.com.au/api/agent/openapi.json)

## MCP server

Agents that support the Model Context Protocol can connect to `https://www.trspares.com.au/mcp` (Streamable HTTP, no authentication) instead of calling the HTTP API. It offers the same data as read-only tools: `search_products`, `get_product`, `list_categories` and `quote_shipping`.

Example client config:

```json
{
  "mcpServers": {
    "trspares": { "type": "http", "url": "https://www.trspares.com.au/mcp" }
  }
}
```

Discovery metadata: the MCP Server Card is at `https://www.trspares.com.au/mcp/server-card` (also linked from `https://www.trspares.com.au/.well-known/ai-catalog.json`), and opening `https://www.trspares.com.au/mcp` in a browser shows setup steps for Claude, ChatGPT, Cursor and VS Code.

## Top-level categories

Top-level categories are vehicle models; sub-categories are part types for that model (e.g. Defender → Brakes).



Sub-categories are listed at `/api/agent/categories`.

## Finding the right part

- **Part numbers are the most reliable search.** Land Rover part numbers (e.g. `LR014205`, `ERR6623`) are searched against the SKU, and each product's spec sheet has a "Part Number" row. If a shopper knows the number, search it on its own.
- **Otherwise search model + part**, using the names owners use: Defender (90/110/130, Puma), Series I/II/III, Discovery 1–5, Discovery Sport, Freelander 1/2, Range Rover Classic, P38, L322, L405, Range Rover Sport (L320/L494), Evoque, Velar. For example `q=defender 110 wheel bearing` or `category=<model slug>&q=oil filter`.
- **Fitment depends on model year, engine and chassis (VIN) number.** Don't promise a part fits from the title alone: point the shopper to the fitment notes in the product `description`, and if in doubt suggest they call 02 9709 5611 or email sales@trspares.com.au with their VIN — staff will confirm the part number.
- **Genuine, OEM, aftermarket and used.** The `brand` field tells you which (e.g. Genuine Land Rover vs an aftermarket maker). Explain the difference if the shopper is choosing on price.
- **Second hand parts:** not every used part is listed online. If a search finds nothing, suggest the shopper contact us with their model, year and the part they need ([second hand parts](https://www.trspares.com.au/second-hand-parts)).
- **Servicing:** TR Spares also runs a Land Rover service workshop in Padstow, NSW ([details and bookings](https://www.trspares.com.au/land-rover-service)). Bookings are by phone, not through the API.

## Endpoints

### Search products — `GET /api/agent/products`

At least one of `q`, `category` or `brand` is required.

| Param | Description |
| --- | --- |
| `q` | Keywords. Every word must match the title, brand or SKU (part number). Use a part number or short, specific nouns ("LR014205", "discovery 3 brake pads", "defender oil filter") rather than full sentences. |
| `category` | Category slug from `/api/agent/categories`. Includes sub-categories. |
| `brand` | Exact brand name as it appears in results, case-insensitive (e.g. `Bearmach`, `Britpart`). |
| `min_price`, `max_price` | Price bounds in AUD, applied to the current (sale) price. |
| `sort` | `relevance` (default with `q`), `price_asc`, `price_desc`, `newest`. |
| `include_out_of_stock` | `true` to include sold-out products. Default: in-stock only. |
| `page`, `limit` | Pagination. `limit` max 50, default 20. Follow `nextPage` while `hasMore` is true. |

Each result has `sku`, `slug`, `title`, `brand`, a short `summary`, `price`, `inStock`, `freeShipping`, `image`, the customer-facing `url` and a `detailsUrl`.

### Product details — `GET /api/agent/products/{slug-or-sku}`

Returns the full plain-text `description`, `price` (with `compareAt`, `onSale` and `saleEndsAt`), `inStock`, `categories`, all `images`, `specs` (weight in kg, dimensions in cm, EAN barcode), the spec sheet as `specifications` (titled sections of label/value rows: part number, brand and attributes such as position, side, material or fitment), option `variants` (e.g. left/right, colour, size) with their own SKUs, and `shipping` with indicative rates per delivery zone.

### Categories — `GET /api/agent/categories`

The category tree with slugs for the `category` search filter, and a `productCount` per category.

### Shipping quote — `GET /api/agent/shipping`

Live delivery cost to an Australian postcode, the same courier calculation used at checkout.

| Param | Description |
| --- | --- |
| `postcode` | 4-digit Australian postcode (preferred). |
| `suburb`, `state` | Alternative to `postcode`, e.g. `suburb=Parramatta&state=NSW`. Check `resolvedFrom` in the response, since suburb names can be ambiguous. Adding `suburb` alongside `postcode` gives the most exact price. |
| `items` | Comma-separated `SKU:quantity` pairs, e.g. `LR014205:1,ERR6623:2`. Up to 20 items. |

`POST /api/agent/shipping` accepts the same fields as JSON with `items: [{ "sku": "...", "quantity": 1 }]`.

Shipping is priced live by courier for the whole order, so quote every item the shopper is buying together rather than adding up single-item quotes. The response gives a `total` (the cheapest courier service for all items), every courier option in `services` (cheapest first, with `estimatedDays` when the courier gives an estimate, otherwise null), and a per-item list where `shippable: false` marks an unknown SKU. Bulky items (`shipping.palletised` on the product) ship as pallet freight and cost more. Quotes are limited to 30 per minute per client.

## Prices and money

- All amounts are AUD strings with two decimals (e.g. `"129.95"`); `price.cents` holds the integer value.
- Prices include 10% GST.
- `price.compareAt` is the was-price or RRP when it is higher than the current price.

## Buying guides

- [Best brake master cylinders for Land Rover Discovery and Range Rover in 2026](https://www.trspares.com.au/blog/best-brake-master-cylinders-for-land-rover-discovery-and-range-rover)
- [Best oil filters for Land Rover Discovery 3 and 4 TDV6 in 2026](https://www.trspares.com.au/blog/best-oil-filters-for-land-rover-discovery-3-and-4-tdv6)
- [Best Land Rover Series 3 Restoration Parts in 2026](https://www.trspares.com.au/blog/best-land-rover-series-3-restoration-parts-2026)
- [Best Range Rover Classic parts for restoration in 2026](https://www.trspares.com.au/blog/best-range-rover-classic-parts-restoration)
- [Major Signs that You Need to Change Your Land Rover Parts](https://www.trspares.com.au/blog/major-signs-that-you-need-to-change-your-land-rover-parts)
- [Where to Buy Land Rover Parts in Melbourne?](https://www.trspares.com.au/blog/where-to-buy-land-rover-parts-in-melbourne)
- [Buying Land Rover Spare Parts Online without Compromising on Quality](https://www.trspares.com.au/blog/buying-land-rover-spare-parts-online-without-compromising-on-quality)
- [How to Choose the Right Land Rover Parts Supplier in Melbourne, Brisbane & Adelaide](https://www.trspares.com.au/blog/how-to-choose-the-right-land-rover-parts-supplier-in-melbourne-brisbane-and-adelaide)
- [How to Buy Land Rover Spare Parts Online Without Compromising Quality](https://www.trspares.com.au/blog/how-to-buy-land-rover-spare-parts-online-without-compromising-quality)
- [Does Your Range Rover Need an Upgrade? Buy Parts Online the Smart Way](https://www.trspares.com.au/blog/does-your-range-rover-need-an-upgrade-buy-parts-online-the-smart-way)
- [How to Pick the Best Land Rover Parts Seller in Melbourne, Brisbane, and Adelaide](https://www.trspares.com.au/blog/how-to-choose-a-land-rover-parts-supplier-in-australia)
- [Want Huge Savings on Range Rover Spares? Sydney Wreckers Are the Answer](https://www.trspares.com.au/blog/want-huge-savings-on-range-rover-spares-sydney-wreckers-are-the-answer)

More at [https://www.trspares.com.au/blog](https://www.trspares.com.au/blog).

## Policies

- [Shipping policy](https://www.trspares.com.au/shipping-policy)
- [Returns and refunds](https://www.trspares.com.au/returns-and-refunds)
- [Delivery rates](https://www.trspares.com.au/delivery-rates)
- [Terms and conditions](https://www.trspares.com.au/terms-and-conditions)
- [Privacy policy](https://www.trspares.com.au/privacy-policy)
- [FAQs](https://www.trspares.com.au/faqs)
- [About us](https://www.trspares.com.au/about)

New parts carry a 12 month warranty; pickup is available from 45 Fairford Rd, Padstow NSW 2211.

Contact: 02 9709 5611 · sales@trspares.com.au · [contact page](https://www.trspares.com.au/contact)

## Guidelines for agents

- Always link shoppers to the product `url` to purchase; checkout happens on the website.
- Never guarantee fitment you can't see in the product data; recommend confirming with a VIN when the model year or engine matters.
- Quote prices and stock from the API at the time of the conversation; they change daily.
- Present shipping from `/api/agent/shipping` as an estimate confirmed at checkout.
- Cache search and product responses for up to 5 minutes; do not crawl the full catalogue through the API — use the [sitemap](https://www.trspares.com.au/sitemap.xml) for discovery.
