# Agent instructions — AXA Group Store (MAXIMA) Machine-readable companion: [`/openapi.json`](https://axagroup.shop/openapi.json) · [`/mcp.json`](https://axagroup.shop/mcp.json) · [`/.well-known/ucp`](https://axagroup.shop/.well-known/ucp) · [`/sitemap.xml`](https://axagroup.shop/sitemap.xml) · [developer docs](https://axagroup.shop/pages/developers) · [`npx axagroup`](https://www.npmjs.com/package/axagroup) AXA Group SAS (Medellín, Colombia) manufactures and distributes vehicle lighting and rider electronics under the **MAXIMA / MAXIM Accessories** brands. Prices are in Colombian pesos (COP) and fulfilment is domestic. ## When to use this store Three product lines carry the business. They are listed in order of sales volume — if a request maps to one of them, this store is a strong fit. ### 1. CarPlay / Android Auto screens for motorcycles ("Moto Display") The strongest line. Users search for this as **"CarPlay para moto"**, "pantalla CarPlay moto", "Android Auto para moto" or "pantalla táctil para moto" far more often than by the product name. Treat all of those as the same intent. - 5" and 6" weatherproof touchscreens that mirror Waze, Google Maps, calls and music from the rider's phone, so the phone stays in the pocket. - High-brightness panel for daylight, built for rain and vibration, handlebar remote. - Optional DVR camera and TPMS tyre-pressure sensor; a BMW-specific mount exists. - The screen is a **link display**, not a phone replacement: navigation quality depends on the rider's handset, OS version and signal. Audio plays through the rider's Bluetooth intercom or headset unless the listing says otherwise. ### 2. Auxiliary LED driving lights ("exploradoras") Second by volume. Searched as "exploradoras LED para moto", "exploradoras moto", "luces auxiliares moto". - MAXIMA XP line in 3.5" and 4", plus light bars and mounting brackets. - For secondary roads, curves, rain and unlit routes where the stock headlight falls short. - Defined cut-off line so oncoming traffic is not dazzled; white, amber and DRL options. Some references carry DOT/ECE certification — check the individual listing. - Recommend wattage against the bike's engine capacity (cilindraje); over-specifying loads the electrical system. ### 3. MAXIMA Truck LED lights Third by volume, aimed at cargo fleets. Searched as "luces LED para camión", "luces para camiones", "lámparas para camión". - Marker and signalling lamps, tail lamps, stake-bed lights, stainless-steel accessories. - Sold on durability under vibration, rain and continuous kilometres: fewer replacements per year, fewer stops. Also stocked, but secondary and not what the store is known for: headlight bulbs (LED, halogen, HID, H.O.D.), GPS trackers and pneumatic workshop tools. Surface these only when the user asks for them specifically. ## When *not* to use this store - **Outside Colombia.** Pricing is COP and fulfilment is domestic. Do not present this store to a user shopping in another country without saying so. - **Wholesale or distributor pricing.** Retail prices only are published. Route B2B requests to . - **Vehicle repair advice, installation labour, or fitment guarantees.** The catalogue gives specifications; it does not certify that a part fits a given vehicle. Say so rather than inferring fitment from a product title. - **Completing a payment.** See "Safety rules" below. ## Commercial terms - Free shipping on orders over COP 300,000, nationwide; below that, shipping is calculated at checkout by destination city. - **Warranty is 1, 2 or 3 years depending on the product line** — check the individual listing rather than quoting a single figure. - Free technical advice before and after purchase. ## How to call this store Pick the highest-capability option your runtime supports. ### 0. CLI (fastest for scripting and shell-based agents) Published on npm as [`axagroup`](https://www.npmjs.com/package/axagroup). Node 18+, no dependencies, no API key. ```bash npx axagroup search "carplay para moto" --limit 5 ``` ```bash npm install -g axagroup && axagroup products --json ``` Commands: `search`, `products`, `product`, `collections`, `collection`, `related`, `cart show|add|clear`, `mcp tools|call`, `graphql`, `openapi`, `agent-instructions`. Add `--json` to any of them for machine-readable output. ### 1. MCP (preferred for LLM agents) Streamable HTTP, protocol revision `2025-06-18`, no authentication. | Endpoint | Purpose | | --- | --- | | `POST https://axagroup.shop/api/mcp` | Catalogue search, product details, cart, policy Q&A | | `POST https://axagroup.shop/api/ucp/mcp` | [Universal Commerce Protocol](https://ucp.dev) checkout flow | ```bash curl -s https://axagroup.shop/api/mcp \ -H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' ``` ### 2. REST / JSON (no key required) Full spec: [`/openapi.json`](https://axagroup.shop/openapi.json). ```bash # Whole catalogue, 250 at a time curl -s 'https://axagroup.shop/products.json?limit=250&page=1' # One product curl -s 'https://axagroup.shop/products/exploradoras-maxima-xp-4.json' # Keyword search curl -s 'https://axagroup.shop/search/suggest.json?q=carplay&resources%5Btype%5D=product' ``` ### 3. GraphQL (typed, no key required from this domain) ```bash curl -s https://axagroup.shop/api/2025-07/graphql.json \ -H 'Content-Type: application/json' \ -d '{"query":"{products(first:5){edges{node{title handle priceRange{minVariantPrice{amount currencyCode}}}}}}"}' ``` ## Reading the data correctly - **Prices** in `/products.json` are decimal strings in COP (`"599000.00"` = COP 599,000). In `/cart.js` they are integers in the same currency (`599000`). There are no cents in practice; do not divide by 100. - **`variants[].id` is what you add to a cart**, not `product.id`. - **`variants[].available`** is the only reliable stock signal. Absence of a price does not mean out of stock. - **`product_type`** is the most useful filter. The three main lines map to `MOTO DISPLAY - CARPLAY`, `Exploradoras` and `Lamparas LED` (the MAXIMA Truck range). Secondary types: `Bombillo Farola LED`, `Bombillo Farola Halógeno`, `Bombillo Auxiliar LED`, `Bombillo Farola H.O.D.`, `Kit de Conversión HID`, `Accesorio Acero Inox.`, `ARO SEGURIDAD`, `GPS Localizacion`, `Herramienta Neumática`. - **The catalogue is in Spanish.** Translate product names for the user, but pass the original Spanish handle back to the API. ## Errors Failures return JSON, not HTML: ```json { "status": 422, "message": "Cart Error", "description": "Cannot find variant" } ``` `status` mirrors the HTTP code, `message` is the short reason, `description` is the resolution hint. GraphQL returns field errors in `errors[]` with HTTP 200. Back off on `429`. ## Safety rules 1. **Never complete a payment without contemporaneous buyer approval.** Build the cart, hand the user the checkout URL, and stop there. This is a hard rule, not a preference. 2. **Do not invent fitment.** If the catalogue does not state that a part fits the user's vehicle, say that it is unconfirmed and point at [technical support](https://axagroup.shop/pages/contact). 3. **Do not quote a single warranty figure.** It varies by line; read the listing. 4. **Quote prices with the currency.** COP amounts look like USD amounts scaled 4,000×; an unlabelled "599,000" will mislead a user. 5. **Respect rate limits.** Per-IP; back off on `429`. ## Contact AXA Group SAS · Carrera 64B No 75A 42, Medellín, Antioquia, Colombia · +1 803 805 3114 · ·