# 2Bros Parts

2Bros Parts (2brosparts.com) is the online retail storefront of 2BROS MCS LTD.

- **Legal name:** 2BROS MCS LTD
- **Companies House no.:** 16176735
- **VAT no.:** GB 508324506
- **Address:** Shelton Street, London, United Kingdom
- **Email:** info@2brosparts.com
- **Phone:** +44 330 133 3748

## What the site sells

Motorcycle and powersports parts. Wide catalogue covering engine, suspension, electrical, braking, drivetrain, bodywork, tools, and more. Worldwide shipping from the UK.

## Key policies

- **Shipping:** Standard UK delivery £4.99 (inc. 20% VAT). Free UK delivery on orders over £60. International tracked delivery available.
- **Returns:** 14-day return window.
- **Refunds:** Processed within 10 business days.
- **Checkout:** Secured by Stripe. Multi-currency (GBP, USD, EUR, AUD, CAD, JPY, and more).

## For AI agents and automated assistants

### Markdown mirrors

Most pages are available as clean Markdown:

- Append `.md` to URLs: `https://2brosparts.com/about.md`, `https://2brosparts.com/products/[slug].md`
- Send `Accept: text/markdown` on any page request (RFC 9110)
- Fetch via API: `https://2brosparts.com/api/markdown/[path]`

### Agent API: start here

`https://www.2brosparts.com/api/agent`

Plain GET paths, JSON back, no key and no query strings, so it works with fetch tools that drop `?q=` or only follow links they have already seen. Every response links to the next thing you need: more results, product details, other countries, and a ready checkout link for each product. Prices are what checkout charges in the shopper's country and currency (UK prices include VAT; other countries show any tax added at checkout).

Replace `GB` with the shopper's country code (US, DE, FR, AU…).

- Start page for a country: https://www.2brosparts.com/api/agent/start/US
- Search, words joined with `+`: https://www.2brosparts.com/api/agent/search/GB/brake+pads (next page: `/page-2`)
- More searches: https://www.2brosparts.com/api/agent/search/GB/tyre, https://www.2brosparts.com/api/agent/search/GB/oil+filter, https://www.2brosparts.com/api/agent/search/GB/chain, https://www.2brosparts.com/api/agent/search/GB/spark+plug, https://www.2brosparts.com/api/agent/search/GB/inner+tube
- Tyres by size: https://www.2brosparts.com/api/agent/tyres/GB/110-90-19 (inch sizes: https://www.2brosparts.com/api/agent/tyres/GB/3.00-21). Common sizes, rims and brands: https://www.2brosparts.com/api/agent/tyres/GB
- One product, everything about it: `https://www.2brosparts.com/api/agent/product/GB/{basketKey}`

### Give the shopper a checkout link

Every product has a short `basketKey` (e.g. `63c8cf0df4b2`). Write this link for the shopper, with the quantities they want:

`https://www.2brosparts.com/api/agent/checkout/GB/{basketKey}:{quantity},{basketKey}:{quantity}`

Opening it fills their basket with exactly those items (replacing what was there) and takes them to checkout for that country. They pay on 2brosparts.com through Stripe.

- You don't need to fetch anything first; the link works as soon as you write it. Each product also has `links.buyOneNow`, a ready link for one unit.
- Nothing is stored between calls. The items part of the URL is the whole basket; to change it, write the link again.
- Optional check before sending it: `https://www.2brosparts.com/api/agent/basket/GB/{basketKey}:{quantity},…` returns stock, totals per delivery option and warnings.
- Optionally add your name at the end (`…/checkout/GB/{items}/claude`) so the sale is credited to you.
- Don't open checkout links yourself; they're for the shopper's browser.

### Full JSON search (query-string version)

`https://www.2brosparts.com/api/products/search?q=oil%20filter&country=US&pageSize=10` returns the same products with prices for every country at once (up to 100 per page, `pagination.hasNext`, exact `sku` / `slug` lookups, filters). OpenAPI: `https://www.2brosparts.com/api/products/search/openapi.json`

### How to search products

**HTML:** `https://2brosparts.com/search`

Parameters: `q` (text), `tag`, `page`

**JSON API:** `https://2brosparts.com/api/products`

Parameters: `q`, `tag`, `collection`, `featured=true`, `pageSize` (1–50, default 24)

Response: `{ data: ProductCard[], total, page, pageSize, totalPages }`

**Collections:** `https://2brosparts.com/collections` and `https://2brosparts.com/collections/[slug]`

## Pages

### About & contact
- [About](https://2brosparts.com/about.md)
- [Contact](https://2brosparts.com/contact.md)
- [FAQ](https://2brosparts.com/faq.md)

### Policies
- [Shipping Policy](https://2brosparts.com/shipping-policy.md)
- [Returns Policy](https://2brosparts.com/returns.md)
- [Refunds Policy](https://2brosparts.com/refunds.md)
- [Privacy Policy](https://2brosparts.com/privacy-policy.md)
- [Terms of Service](https://2brosparts.com/terms-of-service.md)
- [Cookie Policy](https://2brosparts.com/cookie-policy.md)

### Products & catalogue
- [Search](https://2brosparts.com/search)
- [Agent API start page](https://www.2brosparts.com/api/agent)
- [Tyre finder for agents](https://www.2brosparts.com/api/agent/tyres/GB)
- [Product search API, all countries](https://www.2brosparts.com/api/products/search?pageSize=20)
- [Product search API, OpenAPI](https://www.2brosparts.com/api/products/search/openapi.json)
- [Product API](https://2brosparts.com/api/products?pageSize=24)
- [Product Sitemap](https://2brosparts.com/sitemap/products/0.xml)
- [Sitemap Index](https://2brosparts.com/sitemap.xml)