ALLR Motorcycle Gear Prices is an MCP server published by io.github.dfedarchuk, hosted at allr.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 5 tools, including search_gear, get_product_offers, get_deals, get_size_recommendation, list_categories_and_brands.
Compare motorcycle gear prices by landed cost (price, shipping, duty, tax) for CA, US, EU and UK.
Nothing else in the archive shares these values.
Search ALLR's motorcycle-gear catalog (helmets, jackets, suits, pants, boots, gloves, protection, riding shirts, base layers, communication, luggage, accessories) by free text, and get each product's lowest landed cost for a buyer country, how many retailers carry it, and its allr.io product-page URL. The returned `id` is the product id accepted by get_product_offers, which has the per-retailer price table. The `lowest_landed_price` is the cheapest total including shipping, import duty and customs brokerage for `country` (for EU and UK this includes import VAT on cross-border offers; for CA and US no sales tax is included) — not a sticker price — and is one number out of a full table; get_product_offers has the per-retailer breakdown.
| Parameter | Type | Description |
|---|---|---|
| brand | string | Restrict to a brand. Accepts a `slug` or `name` from list_categories_and_brands. Applied as a brand-token filter on the matched products. |
| limit | integer | Maximum products to return (1-25). |
| query * |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
| string |
| Free-text search, e.g. 'agv k6', 'waterproof adventure jacket', 'alpinestars smx-6 boots'. Brand names, model names and model numbers all work. |
| cursor | string | Opaque pagination cursor from a previous call's `next_cursor`. Absent on the first page. |
| gender | string | Restrict to products cut for this rider group, using ALLR's own gender classifier. |
| country | string | Buyer country (ISO-2, plus 'EU' and 'UK' as market codes). Determines the currency and the landed cost: item price + shipping + import duty + customs brokerage fee, plus import VAT on cross-border offers for EU and UK. CA and US totals carry no sales tax. ALLR computes landed cost for these four mar… |
| category | string | Restrict to a catalog category. Accepts a `slug` from list_categories_and_brands (e.g. 'helmets', 'jackets', 'boots'). |
| max_price | number | Highest acceptable landed price in the country's currency. |
| min_price | number | Lowest acceptable landed price in the country's currency. |
| vat_country | string | Only with country='EU': the buyer's EU member state (ISO-2, e.g. 'DE', 'HU'; 'EL' also accepted for Greece). Import VAT on cross-border offers is then charged at that state's standard rate (17% to 27%); a store that prices by destination VAT is re-priced for it. Omitted or not an EU member state: 21… |
| certification | string | Restrict to products carrying this safety certification label, e.g. 'ECE 22.06', 'DOT', 'SNELL', 'CE AA'. Matched case-insensitively against the same certification labels the ALLR catalog filters on. A product whose certification ALLR cannot derive from its catalog row returns no `certifications` an… |
{
"name": "search_gear",
"title": "Search motorcycle gear",
"description": "Search ALLR's motorcycle-gear catalog (helmets, jackets, suits, pants, boots, gloves, protection, riding shirts, base layers, communication, luggage, accessories) by free text, and get each product's lowest landed cost for a buyer country, how many retailers carry it, and its allr.io product-page URL. The returned `id` is the product id accepted by get_product_offers, which has the per-retailer price table. The `lowest_landed_price` is the cheapest total including shipping, import duty and customs brokerage for `country` (for EU and UK this includes import VAT on cross-border offers; for CA and US no sales tax is included) — not a sticker price — and is one number out of a full table; get_product_offers has the per-retailer breakdown.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"brand": {
"type": "string",
"maxLength": 60,
"description": "Restrict to a brand. Accepts a `slug` or `name` from list_categories_and_brands. Applied as a brand-token filter on the matched products."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "Maximum products to return (1-25)."
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Free-text search, e.g. 'agv k6', 'waterproof adventure jacket', 'alpinestars smx-6 boots'. Brand names, model names and model numbers all work."
},
"cursor": {
"type": "string",
"maxLength": 40,
"description": "Opaque pagination cursor from a previous call's `next_cursor`. Absent on the first page."
},
"gender": {
"enum": [
"mens",
"womens",
"unisex",
"kids"
],
"type": "string",
"description": "Restrict to products cut for this rider group, using ALLR's own gender classifier."
},
"country": {
"enum": [
"CA",
"US",
"EU",
"UK"
],
"type": "string",
"default": "US",
"description": "Buyer country (ISO-2, plus 'EU' and 'UK' as market codes). Determines the currency and the landed cost: item price + shipping + import duty + customs brokerage fee, plus import VAT on cross-border offers for EU and UK. CA and US totals carry no sales tax. ALLR computes landed cost for these four markets only."
},
"category": {
"type": "string",
"maxLength": 40,
"description": "Restrict to a catalog category. Accepts a `slug` from list_categories_and_brands (e.g. 'helmets', 'jackets', 'boots')."
},
"max_price": {
"type": "number",
"minimum": 0,
"description": "Highest acceptable landed price in the country's currency."
},
"min_price": {
"type": "number",
"minimum": 0,
"description": "Lowest acceptable landed price in the country's currency."
},
"vat_country": {
"type": "string",
"maxLength": 2,
"description": "Only with country='EU': the buyer's EU member state (ISO-2, e.g. 'DE', 'HU'; 'EL' also accepted for Greece). Import VAT on cross-border offers is then charged at that state's standard rate (17% to 27%); a store that prices by destination VAT is re-priced for it. Omitted or not an EU member state: 21% reference rate."
},
"certification": {
"type": "string",
"maxLength": 40,
"description": "Restrict to products carrying this safety certification label, e.g. 'ECE 22.06', 'DOT', 'SNELL', 'CE AA'. Matched case-insensitively against the same certification labels the ALLR catalog filters on. A product whose certification ALLR cannot derive from its catalog row returns no `certifications` and is excluded by this filter — the product page is the fuller source for certification."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"query",
"country",
"currency",
"ranked_match_count",
"results_capped",
"as_of",
"results"
],
"properties": {
"as_of": {
"type": "string",
"description": "ISO-8601 timestamp at which these prices were assembled."
},
"query": {
"type": "string"
},
"country": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"currency",
"offer_count",
"url"
],
"properties": {
"id": {
"type": "string",
"description": "ALLR product id, as accepted by get_product_offers."
},
"url": {
"type": "string",
"description": "Canonical allr.io product page."
},
"name": {
"type": "string"
},
"brand": {
"type": [
"string",
"null"
]
},
"gender": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"currency": {
"type": "string"
},
"image_url": {
"type": [
"string",
"null"
]
},
"offer_count": {
"type": "integer",
"description": "New-condition retailer offers ALLR holds for this product in any market, each retailer counted once, from the twice-daily product summary. get_product_offers returns the live table, whose `offer_count` can differ slightly (it is read later and also lists non-new offers)."
},
"certifications": {
"type": "array",
"items": {
"type": "string"
},
"description": "Safety certification labels ALLR holds for this product, e.g. 'ECE 22.06': the labels resolved from its retailers' pages (the same ones the product page shows), or inferred from the name when none is resolved. An EMPTY array means none is recorded, NOT that the product is uncertified."
},
"ships_to_country": {
"type": [
"boolean",
"null"
],
"description": "True when at least one retailer ships this product to `country` (ALLR's own per-country rollup). False means no retailer currently reaches that country — which does NOT hide the product; ALLR shows every product in every region. null when the rollup is unavailable for this row: unknown, never assumed."
},
"lowest_landed_price": {
"type": [
"number",
"null"
],
"description": "Cheapest landed total (item + shipping + duty + brokerage, plus import VAT on cross-border EU and UK offers; no sales tax for CA and US) in `currency`, or null when no retailer currently prices it."
},
"in_stock_offer_count": {
"type": "integer",
"description": "The subset of `offer_count` in stock, from the same summary."
}
}
}
},
"currency": {
"type": "string"
},
"next_cursor": {
"type": [
"string",
"null"
],
"description": "Value accepted as `cursor` for the next page; null when there are no more."
},
"results_capped": {
"type": "boolean",
"description": "True when the search engine returned its maximum of 50 ranked products, i.e. `ranked_match_count` is a floor on how many products match, not the total."
},
"ranked_match_count": {
"type": "integer",
"description": "Number of RANKED RESULTS this query produced after the requested filters — the pool this call paginates over. ALLR's search engine ranks and returns at most 50 products per query, so this is NOT a catalog-wide match count: when `results_capped` is true, more products match than are rankable in one query. A narrower query (`brand`, `category` or more specific text) produces a ranked pool below the cap."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get the full per-retailer offer table for ONE ALLR product in a buyer country: landed cost broken down into item price, shipping, import duty and customs brokerage (plus `tax`; these sum to landed_total. `tax` is 0 for CA and US, and for EU and UK it is the import VAT on cross-border offers, which is included in landed_total), plus stock, condition, per-colorway size availability, whether the retailer ships to that country, and a buy link (an allr.io redirect to the retailer). search_gear only carries the single lowest number. Offers are sorted cheapest landed first and the first `limit` are returned (default 10, max 40; `offer_count` is the total available); a retailer that does not ship to the country is still listed, flagged and sorted last. Availability is truth per (retailer x colorway x size): each offer carries `availability_by_colorway`, one row per colorway with ITS OWN sizes. There is no offer-level size list, because a size in stock in one colorway says nothing about another.
| Parameter | Type | Description |
|---|---|---|
| size | string | Restrict to offers that have this size IN STOCK in at least one colorway, e.g. 'L', 'XL', '44'. The kept offers carry `matched_colorways` — exactly the colorways that have it. Combined with `colorway`, the offer must have that size IN that colorway. An offer with no per-colorway breakdown is dropped… |
| limit | integer | Maximum offers to return, cheapest landed first (1-40, default 10). `offer_count` is the total and `has_more` says whether more offers exist beyond this limit. |
| country | string | Buyer country (ISO-2, plus 'EU' and 'UK' as market codes). Determines the currency and the landed cost: item price + shipping + import duty + customs brokerage fee, plus import VAT on cross-border offers for EU and UK. CA and US totals carry no sales tax. ALLR computes landed cost for these four mar… |
| colorway | string | Restrict to offers carrying this colorway. Matched against the product's real colorway NAMES the way the product page matches them: the normalized name first ('matt black' = 'Matt Black'), and only if nothing matches exactly, any colorway whose name contains all of those words as whole words ('black… |
| product_id * | string | ALLR product id from search_gear, or a full https://allr.io/product/<id> URL, or the bare slug. A merged/renamed id is followed to its canonical product automatically. |
| vat_country | string | Only with country='EU': the buyer's EU member state (ISO-2, e.g. 'DE', 'HU'; 'EL' also accepted for Greece). Import VAT on cross-border offers is then charged at that state's standard rate (17% to 27%); a store that prices by destination VAT is re-priced for it. Omitted or not an EU member state: 21… |
| include_out_of_stock | boolean | true includes out-of-stock offers in the table (ALLR does not hide them by default); false returns only in-stock offers. |
{
"name": "get_product_offers",
"title": "Get every retailer offer for a product",
"description": "Get the full per-retailer offer table for ONE ALLR product in a buyer country: landed cost broken down into item price, shipping, import duty and customs brokerage (plus `tax`; these sum to landed_total. `tax` is 0 for CA and US, and for EU and UK it is the import VAT on cross-border offers, which is included in landed_total), plus stock, condition, per-colorway size availability, whether the retailer ships to that country, and a buy link (an allr.io redirect to the retailer). search_gear only carries the single lowest number. Offers are sorted cheapest landed first and the first `limit` are returned (default 10, max 40; `offer_count` is the total available); a retailer that does not ship to the country is still listed, flagged and sorted last. Availability is truth per (retailer x colorway x size): each offer carries `availability_by_colorway`, one row per colorway with ITS OWN sizes. There is no offer-level size list, because a size in stock in one colorway says nothing about another.",
"inputSchema": {
"type": "object",
"required": [
"product_id"
],
"properties": {
"size": {
"type": "string",
"maxLength": 20,
"description": "Restrict to offers that have this size IN STOCK in at least one colorway, e.g. 'L', 'XL', '44'. The kept offers carry `matched_colorways` — exactly the colorways that have it. Combined with `colorway`, the offer must have that size IN that colorway. An offer with no per-colorway breakdown is dropped by this filter rather than guessed at."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 40,
"minimum": 1,
"description": "Maximum offers to return, cheapest landed first (1-40, default 10). `offer_count` is the total and `has_more` says whether more offers exist beyond this limit."
},
"country": {
"enum": [
"CA",
"US",
"EU",
"UK"
],
"type": "string",
"default": "US",
"description": "Buyer country (ISO-2, plus 'EU' and 'UK' as market codes). Determines the currency and the landed cost: item price + shipping + import duty + customs brokerage fee, plus import VAT on cross-border offers for EU and UK. CA and US totals carry no sales tax. ALLR computes landed cost for these four markets only."
},
"colorway": {
"type": "string",
"maxLength": 120,
"description": "Restrict to offers carrying this colorway. Matched against the product's real colorway NAMES the way the product page matches them: the normalized name first ('matt black' = 'Matt Black'), and only if nothing matches exactly, any colorway whose name contains all of those words as whole words ('black' matches 'Matt Black' AND 'Black/Red'). A value that matches no colorway on this product comes back as an error listing the valid names. When omitted, every colorway is included."
},
"product_id": {
"type": "string",
"maxLength": 220,
"minLength": 1,
"description": "ALLR product id from search_gear, or a full https://allr.io/product/<id> URL, or the bare slug. A merged/renamed id is followed to its canonical product automatically."
},
"vat_country": {
"type": "string",
"maxLength": 2,
"description": "Only with country='EU': the buyer's EU member state (ISO-2, e.g. 'DE', 'HU'; 'EL' also accepted for Greece). Import VAT on cross-border offers is then charged at that state's standard rate (17% to 27%); a store that prices by destination VAT is re-priced for it. Omitted or not an EU member state: 21% reference rate."
},
"include_out_of_stock": {
"type": "boolean",
"default": true,
"description": "true includes out-of-stock offers in the table (ALLR does not hide them by default); false returns only in-stock offers."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"product",
"country",
"currency",
"as_of",
"offer_count",
"offers"
],
"properties": {
"as_of": {
"type": "string",
"description": "ISO-8601 timestamp at which these prices were assembled."
},
"offers": {
"type": "array",
"items": {
"type": "object",
"required": [
"retailer",
"retailer_id",
"in_stock",
"ships_to_country",
"colorways",
"availability_by_colorway"
],
"properties": {
"tax": {
"type": [
"number",
"null"
],
"description": "Import VAT. 0 for CA and US (ALLR does not include destination sales tax; the retailer shows it at checkout). For EU and UK, the import VAT on cross-border offers (UK 20%; EU: the buyer's own member state's rate, 17% to 27%, 21% when `vat_country` is not given; 0 on helmets sold by UK and EU shops into the UK), included in landed_total; 0 for domestic and same-zone offers."
},
"duty": {
"type": [
"number",
"null"
],
"description": "Import duty in `currency`."
},
"note": {
"type": [
"string",
"null"
],
"description": "Human-readable caveat, e.g. 'Does not ship to CA'."
},
"buy_url": {
"type": [
"string",
"null"
],
"description": "An allr.io redirect to the retailer's product page; it counts the click."
},
"domestic": {
"type": [
"boolean",
"null"
],
"description": "true when the retailer sells domestically in `country` (no import duty)."
},
"in_stock": {
"type": "boolean"
},
"retailer": {
"type": "string"
},
"shipping": {
"type": [
"number",
"null"
]
},
"tax_name": {
"type": [
"string",
"null"
]
},
"brokerage": {
"type": [
"number",
"null"
],
"description": "Courier / post customs-clearance fee in `currency`; 0 when the parcel needs no clearance, the retailer is domestic or same-customs-zone, or the price is delivered-duty-paid. It is charged only where a carrier advances duty or import VAT. Canada: greater of CA$12.00 or 3.7% of duty plus HST for a courier (CA$9.95 per item for Canada Post), whenever duty OR tax is collected. US: greater of US$17.50 or 2.5% of duty (DHL/FedEx US; UPS US is unpublished and priced the same). UK: 0 up to GBP 135 (VAT collected at sale), above that the greater of GBP 12.00 or 2.5% of duty plus import VAT (DHL UK default; FedEx 12.90, UPS 13.60 at 3%, Royal Mail 8). EU (non-EU sellers): the EUR 2 Union handling fee on every parcel plus the greater of EUR 15 or 2.5% of duty plus import VAT (FedEx EU default; UPS 15.70 at 3%, DHL 12.50 at 2%). No VAT is added on the fee."
},
"colorways": {
"type": "array",
"items": {
"type": "string"
},
"description": "Colorways this offer covers (display names, as the product page shows them). Narrowed to the requested colorway when `colorway` was given."
},
"condition": {
"type": [
"string",
"null"
],
"description": "null = new. Otherwise 'Open Box', 'Blemished', 'B-Stock', 'Refurbished' or 'Discontinued'. ALLR shows at most one offer per (retailer, condition)."
},
"duty_note": {
"type": [
"string",
"null"
],
"description": "Short caveat printed beside the duty on allr.io, e.g. 'Duty may be $0 if made in the EU (CETA)'. Present only on Canadian offers from EU or UK stores that pay MFN duty because the product's origin is unknown; null otherwise."
},
"duty_basis": {
"type": [
"string",
"null"
],
"description": "How `duty` was priced: 'mfn' (full most-favoured-nation rate), 'ceta' / 'cuktca' / 'cusma' (0% preference, only when ALLR has the product's country of manufacture on file and the parcel ships from that partner), or 'origin-unknown-mfn' (Canada: the full MFN rate is quoted because the product's origin is not on file)."
},
"item_price": {
"type": [
"number",
"null"
]
},
"observed_at": {
"type": [
"string",
"null"
],
"description": "When ALLR last saw this offer."
},
"retailer_id": {
"type": "string"
},
"landed_total": {
"type": [
"number",
"null"
],
"description": "Item + shipping + duty + brokerage + tax in `currency`. `tax` is 0 for CA and US and import VAT for cross-border EU and UK offers. null when the retailer cannot ship to this country."
},
"sizes_listed": {
"type": "array",
"items": {
"type": "string"
},
"description": "Every size the retailer lists for this offer, in stock or not, across all of its colorways. This is a LISTING-level array and says nothing per colorway — per-colorway stock is in availability_by_colorway."
},
"free_shipping": {
"type": [
"boolean",
"null"
]
},
"brokerage_basis": {
"type": [
"string",
"null"
],
"description": "Which brokerage rule produced `brokerage`, e.g. 'ups-ca', 'default-dhl-us', 'uk-under-135', 'default-dhl-uk', 'eu-uhf+default-fedex', 'ddp', 'same-zone'. A 'default-' prefix means the retailer's courier is not known and the destination default was used; '-unproven' means the carrier's published amount could not be found."
},
"foreign_currency": {
"type": [
"string",
"null"
]
},
"retailer_country": {
"type": [
"string",
"null"
]
},
"ships_to_country": {
"type": "boolean"
},
"availability_note": {
"type": [
"string",
"null"
],
"description": "Set only when `availability_by_colorway` is null — the reason ALLR cannot break this offer's stock down by colorway."
},
"matched_colorways": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "When `colorway` and/or `size` was requested: exactly the colorways of this offer that satisfied the request (for a size filter, the colorways that have that size). null when no such filter was applied."
},
"list_price_foreign": {
"type": [
"number",
"null"
],
"description": "The retailer's own price in its own currency, before conversion."
},
"shipping_estimated": {
"type": [
"boolean",
"null"
],
"description": "true when the shipping figure is ALLR's estimate rather than a retailer-quoted rate."
},
"availability_by_colorway": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"colorway",
"sizes_in_stock"
],
"properties": {
"colorway": {
"type": [
"string",
"null"
],
"description": "Colorway display name; null only when the retailer names no colorway."
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
},
"description": "Sizes in stock IN THIS COLORWAY at this retailer."
}
}
},
"description": "Per-colorway stock: one row per colorway, each carrying ONLY that colorway's in-stock sizes. Rows are independent: a size present in one colorway is not in stock in another. An EMPTY sizes_in_stock means that colorway has nothing in stock at this retailer. null means ALLR cannot attribute sizes to colorways for this offer; `availability_note` says why."
}
}
}
},
"country": {
"type": "string"
},
"product": {
"type": "object",
"required": [
"id",
"name",
"url"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"brand": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"colorways": {
"type": "array",
"items": {
"type": "string"
},
"description": "Colorway names ALLR recognises for this product."
},
"image_url": {
"type": [
"string",
"null"
]
},
"redirected_from": {
"type": [
"string",
"null"
],
"description": "Set when the requested id was a merged duplicate and was followed to this canonical product."
}
}
},
"currency": {
"type": "string"
},
"has_more": {
"type": "boolean",
"description": "true when more offers exist than `limit` returned; `limit` accepts up to 40."
},
"offer_count": {
"type": "integer",
"description": "Total offers for this product/country after filters (may exceed the number returned in `offers`)."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List motorcycle gear currently discounted on ALLR, with the same filters the site's Hot Deals board uses. Two boards: the default board (price below the featured store's own was-price) and mode='retailer' (only deals where the store cut its OWN advertised price, ranked by that store's percentage). Returns the discounted landed price for the buyer country, the percentage off, the retailer featuring it and the allr.io product URL.
| Parameter | Type | Description |
|---|---|---|
| mode | string | 'msrp' (default) = below the featured store's own was-price. 'retailer' = the store cut its own advertised price. |
| size | string | Normalized size label ('XL', '44') — keeps only deals whose featured offer has that size in stock. |
| limit | integer | Maximum deals to return (1-50). |
| country | string | Buyer country (ISO-2, plus 'EU' and 'UK' as market codes). Determines the currency and the landed cost: item price + shipping + import duty + customs brokerage fee, plus import VAT on cross-border offers for EU and UK. CA and US totals carry no sales tax. ALLR computes landed cost for these four mar… |
| category | string | Catalog category slug from list_categories_and_brands (e.g. 'helmets', 'jackets'). |
| retailer | string | Retailer id — keeps only deals this retailer can fill, and features ITS price. |
| subcategory | string | Helmet/riding-shirt subtype slug. Only meaningful together with `category`. |
| vat_country | string | Only with country='EU': the buyer's EU member state (ISO-2, e.g. 'DE', 'HU'; 'EL' also accepted for Greece). Import VAT on cross-border offers is then charged at that state's standard rate (17% to 27%); a store that prices by destination VAT is re-priced for it. Omitted or not an EU member state: 21… |
| min_discount_pct | integer | Minimum percentage off. |
{
"name": "get_deals",
"title": "Current motorcycle gear price drops",
"description": "List motorcycle gear currently discounted on ALLR, with the same filters the site's Hot Deals board uses. Two boards: the default board (price below the featured store's own was-price) and mode='retailer' (only deals where the store cut its OWN advertised price, ranked by that store's percentage). Returns the discounted landed price for the buyer country, the percentage off, the retailer featuring it and the allr.io product URL.",
"inputSchema": {
"type": "object",
"properties": {
"mode": {
"enum": [
"msrp",
"retailer"
],
"type": "string",
"default": "msrp",
"description": "'msrp' (default) = below the featured store's own was-price. 'retailer' = the store cut its own advertised price."
},
"size": {
"type": "string",
"maxLength": 20,
"description": "Normalized size label ('XL', '44') — keeps only deals whose featured offer has that size in stock."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Maximum deals to return (1-50)."
},
"country": {
"enum": [
"CA",
"US",
"EU",
"UK"
],
"type": "string",
"default": "US",
"description": "Buyer country (ISO-2, plus 'EU' and 'UK' as market codes). Determines the currency and the landed cost: item price + shipping + import duty + customs brokerage fee, plus import VAT on cross-border offers for EU and UK. CA and US totals carry no sales tax. ALLR computes landed cost for these four markets only."
},
"category": {
"type": "string",
"maxLength": 40,
"description": "Catalog category slug from list_categories_and_brands (e.g. 'helmets', 'jackets')."
},
"retailer": {
"type": "string",
"maxLength": 40,
"description": "Retailer id — keeps only deals this retailer can fill, and features ITS price."
},
"subcategory": {
"type": "string",
"maxLength": 40,
"description": "Helmet/riding-shirt subtype slug. Only meaningful together with `category`."
},
"vat_country": {
"type": "string",
"maxLength": 2,
"description": "Only with country='EU': the buyer's EU member state (ISO-2, e.g. 'DE', 'HU'; 'EL' also accepted for Greece). Import VAT on cross-border offers is then charged at that state's standard rate (17% to 27%); a store that prices by destination VAT is re-priced for it. Omitted or not an EU member state: 21% reference rate."
},
"min_discount_pct": {
"enum": [
10,
20,
30,
40
],
"type": "integer",
"description": "Minimum percentage off."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"country",
"currency",
"mode",
"total_matches",
"results_capped",
"as_of",
"deals"
],
"properties": {
"mode": {
"type": "string"
},
"as_of": {
"type": "string",
"description": "ISO-8601 timestamp at which these prices were assembled."
},
"deals": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"url"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"brand": {
"type": [
"string",
"null"
]
},
"price": {
"type": [
"number",
"null"
],
"description": "Discounted landed price in `currency`."
},
"category": {
"type": [
"string",
"null"
]
},
"in_stock": {
"type": [
"boolean",
"null"
]
},
"retailer": {
"type": [
"string",
"null"
]
},
"image_url": {
"type": [
"string",
"null"
]
},
"was_price": {
"type": [
"number",
"null"
]
},
"discount_pct": {
"type": [
"number",
"null"
]
}
}
}
},
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"computed_at": {
"type": [
"string",
"null"
],
"description": "When ALLR last recomputed the deals pool."
},
"total_matches": {
"type": "integer",
"description": "Deals in the current pool matching these filters. Honest for the pool as computed — but see `results_capped`."
},
"results_capped": {
"type": "boolean",
"description": "True when ALLR's deals pool was itself truncated when it was last computed, so `total_matches` is a floor rather than the complete count."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Recommend a size for a specific product (or a brand + category) from the rider's body measurements, using the manufacturer's own published size chart — the same charts and the same matcher the ALLR product page uses. Measurements are in CENTIMETRES: head circumference for helmets, chest for jackets/suits, hand circumference for gloves, foot length for boots. Returns the recommended label with its EU/US/UK equivalents, how snug it falls, and a link to the brand's official chart. When no chart exists for the brand+category, or the needed measurement is missing, it says so rather than guessing.
| Parameter | Type | Description |
|---|---|---|
| brand | string | Brand name, e.g. 'AGV', 'Alpinestars'. Required when `product_id` is omitted. |
| foot_cm | number | Foot length in cm (boots). |
| hand_cm | number | Hand circumference in cm (gloves). |
| head_cm | number | Head circumference in cm (helmets). |
| category | string | Product category, e.g. 'Full-Face Helmet', 'Leather Jacket', 'Boots', 'Gloves'. Required when `product_id` is omitted. |
| chest_cm | number | Chest circumference in cm (jackets, suits). |
| known_size | string | A size the rider already wears in this brand+category ('L', 'EU 44'), used when no measurement is given. |
| product_id | string | ALLR product id or /product/ URL. Supplies the brand, category and model so the right chart variant is picked. Either this or both `brand` and `category` is required. |
{
"name": "get_size_recommendation",
"title": "Recommend a size from body measurements",
"description": "Recommend a size for a specific product (or a brand + category) from the rider's body measurements, using the manufacturer's own published size chart — the same charts and the same matcher the ALLR product page uses. Measurements are in CENTIMETRES: head circumference for helmets, chest for jackets/suits, hand circumference for gloves, foot length for boots. Returns the recommended label with its EU/US/UK equivalents, how snug it falls, and a link to the brand's official chart. When no chart exists for the brand+category, or the needed measurement is missing, it says so rather than guessing.",
"inputSchema": {
"type": "object",
"properties": {
"brand": {
"type": "string",
"maxLength": 60,
"description": "Brand name, e.g. 'AGV', 'Alpinestars'. Required when `product_id` is omitted."
},
"foot_cm": {
"type": "number",
"maximum": 40,
"minimum": 18,
"description": "Foot length in cm (boots)."
},
"hand_cm": {
"type": "number",
"maximum": 40,
"minimum": 10,
"description": "Hand circumference in cm (gloves)."
},
"head_cm": {
"type": "number",
"maximum": 80,
"minimum": 40,
"description": "Head circumference in cm (helmets)."
},
"category": {
"type": "string",
"maxLength": 60,
"description": "Product category, e.g. 'Full-Face Helmet', 'Leather Jacket', 'Boots', 'Gloves'. Required when `product_id` is omitted."
},
"chest_cm": {
"type": "number",
"maximum": 180,
"minimum": 60,
"description": "Chest circumference in cm (jackets, suits)."
},
"known_size": {
"type": "string",
"maxLength": 12,
"description": "A size the rider already wears in this brand+category ('L', 'EU 44'), used when no measurement is given."
},
"product_id": {
"type": "string",
"maxLength": 220,
"description": "ALLR product id or /product/ URL. Supplies the brand, category and model so the right chart variant is picked. Either this or both `brand` and `category` is required."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"as_of"
],
"properties": {
"as_of": {
"type": "string",
"description": "ISO-8601 timestamp at which these prices were assembled."
},
"brand": {
"type": [
"string",
"null"
]
},
"needs": {
"type": [
"string",
"null"
],
"description": "Set when a chart exists but the required input is missing — the label of the measurement that is missing."
},
"category": {
"type": [
"string",
"null"
]
},
"product_id": {
"type": [
"string",
"null"
]
},
"recommended": {
"type": [
"object",
"null"
],
"properties": {
"eu": {
"type": [
"string",
"null"
]
},
"uk": {
"type": [
"string",
"null"
]
},
"us": {
"type": [
"string",
"null"
]
},
"fit": {
"type": [
"string",
"null"
],
"description": "How the measurement sits in the band — e.g. 'snug', 'roomy', 'from-size'."
},
"label": {
"type": [
"string",
"null"
],
"description": "The brand's own size label, e.g. 'L', 'MS'."
},
"chart_url": {
"type": [
"string",
"null"
],
"description": "The manufacturer's own published size chart."
},
"confidence": {
"type": [
"string",
"null"
]
},
"measure_used": {
"type": [
"string",
"null"
]
}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List the catalog categories and the brands ALLR tracks, with the exact slugs the `category` and `brand` filters on search_gear and get_deals expect. These are the only values the `category` and `brand` filters accept. Cheap and static — it reads bundled catalog metadata, not the live price data.
| Parameter | Type | Description |
|---|---|---|
| brand_query | string | Return only brands whose name or slug contains this text (case-insensitive). |
| include_brands | boolean | Include the brand list (a few hundred entries). false returns categories only. |
{
"name": "list_categories_and_brands",
"title": "List ALLR categories and brands",
"description": "List the catalog categories and the brands ALLR tracks, with the exact slugs the `category` and `brand` filters on search_gear and get_deals expect. These are the only values the `category` and `brand` filters accept. Cheap and static — it reads bundled catalog metadata, not the live price data.",
"inputSchema": {
"type": "object",
"properties": {
"brand_query": {
"type": "string",
"maxLength": 60,
"description": "Return only brands whose name or slug contains this text (case-insensitive)."
},
"include_brands": {
"type": "boolean",
"default": true,
"description": "Include the brand list (a few hundred entries). false returns categories only."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"categories",
"brand_count",
"countries"
],
"properties": {
"brands": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"name",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "allr.io brand page."
},
"name": {
"type": "string"
},
"slug": {
"type": "string",
"description": "Value accepted by the `brand` filter."
}
}
}
},
"countries": {
"type": "array",
"items": {
"type": "string"
},
"description": "Buyer countries ALLR computes landed cost for."
},
"categories": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"label"
],
"properties": {
"slug": {
"type": "string",
"description": "Value accepted by the `category` filter."
},
"label": {
"type": "string"
},
"includes": {
"type": "array",
"items": {
"type": "string"
},
"description": "The raw product-category values this slug covers."
}
}
}
},
"brand_count": {
"type": "integer"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}ALLR compares motorcycle gear (helmets, jackets, suits, pants, boots, gloves, protection, luggage) across the stores it tracks, for buyers in Canada, the US, the EU and the UK (four buyer markets; the live store list and count are at https://allr.io/stores). What the data means: - Prices are per buyer country. ALLR ranks by landed cost, not sticker price: item price + shipping + import duty + customs brokerage fee (`brokerage_basis` names its rule), converted to the buyer's currency. For CA and US no sales tax is included (the retailer shows it at its own checkout) and `tax` is 0. For EU and UK, `tax` is the import VAT on cross-border offers (UK 20%, EU 17-27% by `vat_country`, else 21%) and is included in the total. The cheapest retailer differs between CA, US, EU and UK, so every price tool takes a `country`. - search_gear finds products; its `lowest_landed_price` is the lowest total for one product in `country`. get_product_offers takes a product `id` and returns the per-retailer table (item_price, shipping, duty, brokerage, tax; these sum to landed_total), cheapest first, 10 offers by default (`limit` up to 40; `offer_count` is the total). - Every product carries a `url` to its allr.io product page. - Prices and stock are observations; each response carries `as_of`, the time the prices were assembled, and they can change. - Availability is per (retailer x colorway x size). An offer's `availability_by_colorway` has one row per colorway, each with its own sizes in stock. There is no offer-level size list. When `availability_by_colorway` is null, `availability_note` says why and the per-colorway breakdown is unknown. - Offers that cannot reach the country are still returned, with `ships_to_country: false`, and sorted last. - `buy_url` is a link for the offer; it counts the click. For some stores it goes straight to the store, and for others it forwards through the Awin affiliate network, and ALLR earns a small commission (see /affiliate-disclosure) when a rider buys through an affiliate link; that never changes the price. Stores are ranked by total price only. In an exact tie, a store we have an affiliate partnership with appears first. - list_categories_and_brands lists the valid `category` and `brand` filter values.
Names, descriptions and schemas were written by the server and are shown as data.