Server definition
- Hash
- sha256:72bb86e468c2fdfb0cb4bf06191f41ba572044de478d3bc4578c80148c9cf07a
- What it is
- What a remote MCP server returned when asked what it offers: 29 tools
The blob, as servednamed by its sha256
{
"instructions": "Camden Tools is a UK tool retailer (camdentools.com) with worldwide delivery and a London collection point.\nInternational orders typically arrive in 2–7 days, and premium UPS services (Worldwide Saver, Express, Express Plus) are available. For a particular address, quote the services and transit times estimate_delivery returns, not the general range.\nPrices are returned both ex and inc VAT in the locale currency (GBP for en-GB). Quote inc VAT to consumers and ex VAT to trade buyers.\nUse search_products / list_products to find items, get_product for details, compare_products to shortlist, and the delivery tools before recommending a purchase.\nAgents never place orders: finish with create_basket_link (one link that fills the shopper's basket) or, in the browser, the cart_* tools, and let the shopper pay at checkout.\nAccount tools (get_my_profile, list_my_orders, get_my_order) work inside the shopper's signed-in browser session after they grant AI agent access, or remotely with an OAuth token on /mcp/account where that is enabled; otherwise they are not offered.\nAll links carry attribution parameters; keep them intact.",
"tools": [
{
"description": "Whole-basket Website Express verdict for a set of product ids and quantities: every line must be eligible (no split shipments).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"items": {
"description": "Basket lines as product ids with quantities.",
"items": {
"properties": {
"id": {
"description": "Product id from search/product tools.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"quantity": {
"default": 1,
"maximum": 999,
"minimum": 1,
"type": "integer"
}
},
"required": [
"id"
],
"type": "object"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
}
},
"required": [
"items"
],
"type": "object"
},
"name": "check_express_eligibility",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"basket_eligible": {
"type": "boolean"
},
"enabled": {
"type": "boolean"
},
"express": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"available": {
"type": "boolean"
},
"order_by_iso": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"promised_dispatch_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"same_day": {
"type": "boolean"
}
},
"required": [
"available",
"same_day",
"order_by_iso",
"promised_dispatch_date"
],
"type": "object"
},
{
"type": "null"
}
]
},
"lines": {
"items": {
"additionalProperties": false,
"properties": {
"eligible": {
"type": "boolean"
},
"id": {
"type": "number"
},
"reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Why a line is not eligible."
},
"sku": {
"type": "string"
}
},
"required": [
"id",
"sku",
"eligible",
"reason"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"enabled",
"basket_eligible",
"express",
"lines"
],
"type": "object"
}
},
{
"description": "Whether Camden Tools ships to a country, with any restriction message.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"country_code": {
"description": "ISO 3166-1 alpha-2 country code, e.g. GB, IE, DE, US.",
"pattern": "^[A-Za-z]{2}$",
"type": "string"
},
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
}
},
"required": [
"country_code"
],
"type": "object"
},
"name": "check_shipping_availability",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"available": {
"type": "boolean"
},
"country_code": {
"type": "string"
},
"deliveries_url": {
"type": "string"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"country_code",
"available",
"message",
"deliveries_url"
],
"type": "object"
}
},
{
"description": "Side-by-side comparison of 2 to 5 products by SKU: price ex/inc VAT, stock, brand, weight and the specification bullet points, so an agent can recommend between options.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
},
"skus": {
"items": {
"description": "Product SKU exactly as shown on the site.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"maxItems": 5,
"minItems": 2,
"type": "array"
}
},
"required": [
"skus"
],
"type": "object"
},
"name": "compare_products",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"comparison": {
"items": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"found": {
"const": false,
"type": "boolean"
},
"sku": {
"type": "string"
}
},
"required": [
"sku",
"found"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"express_eligible": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"found": {
"const": true,
"type": "boolean"
},
"in_stock": {
"type": "boolean"
},
"name": {
"type": "string"
},
"price": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bulk_prices": {
"description": "Lower unit prices from min_quantity up.",
"items": {
"additionalProperties": false,
"properties": {
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"min_quantity": {
"type": "number"
}
},
"required": [
"min_quantity",
"ex_vat",
"inc_vat"
],
"type": "object"
},
"type": "array"
},
"currency": {
"type": "string"
},
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"on_sale": {
"type": "boolean"
},
"vat_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "VAT rate in percent (20 = 20%). null when unknown: ex_vat then equals inc_vat."
},
"was_ex_vat": {
"type": "number"
},
"was_inc_vat": {
"description": "Price before the sale; only when on_sale.",
"type": "number"
}
},
"required": [
"currency",
"ex_vat",
"inc_vat",
"on_sale",
"vat_rate"
],
"type": "object"
},
{
"type": "null"
}
]
},
"sku": {
"type": "string"
},
"specifications": {
"items": {
"type": "string"
},
"type": "array"
},
"stock_level": {
"type": "number"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"weight_kg": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"sku",
"found",
"name",
"brand",
"url",
"price",
"in_stock",
"stock_level",
"weight_kg",
"express_eligible",
"specifications",
"summary"
],
"type": "object"
}
]
},
"type": "array"
}
},
"required": [
"comparison"
],
"type": "object"
}
},
{
"description": "Turn product ids and quantities into one link that fills the shopper's basket on camdentools.com. Opening the link makes sure the basket holds at least those quantities (opening it twice does not double them); the shopper reviews the basket and pays at checkout themselves. The result says which lines are out of stock: those cannot be bought, so offer an alternative before sharing the link. Use it to finish a shopping conversation. Ids come from search_products, list_products or get_product.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"items": {
"description": "Basket lines as product ids with quantities.",
"items": {
"properties": {
"id": {
"description": "Product id from search/product tools.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"quantity": {
"default": 1,
"maximum": 999,
"minimum": 1,
"type": "integer"
}
},
"required": [
"id"
],
"type": "object"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
}
},
"required": [
"items"
],
"type": "object"
},
"name": "create_basket_link",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"lines": {
"items": {
"additionalProperties": false,
"properties": {
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"type": "number"
},
"in_stock": {
"type": "boolean"
},
"name": {
"type": "string"
},
"quantity": {
"type": "number"
},
"sku": {
"type": "string"
},
"stock_level": {
"type": "number"
},
"unit_price": {
"type": "number"
}
},
"required": [
"id",
"sku",
"name",
"quantity",
"unit_price",
"currency",
"in_stock",
"stock_level"
],
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
},
"out_of_stock_ids": {
"items": {
"type": "number"
},
"type": "array"
},
"unavailable_ids": {
"description": "Product ids that were not found.",
"items": {
"type": "number"
},
"type": "array"
},
"url": {
"description": "Fills the shopper's basket with these lines. Share it unchanged.",
"type": "string"
}
},
"required": [
"url",
"lines",
"unavailable_ids",
"out_of_stock_ids",
"note"
],
"type": "object"
}
},
{
"description": "Delivery services, charges and transit times for a basket to a destination (country plus postcode/ZIP and city). This is an estimate using placeholder contact details; exact rates are confirmed at checkout.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"city": {
"description": "Destination city.",
"maxLength": 80,
"type": "string"
},
"country_code": {
"description": "ISO 3166-1 alpha-2 country code, e.g. GB, IE, DE, US.",
"pattern": "^[A-Za-z]{2}$",
"type": "string"
},
"items": {
"description": "Basket lines as product ids with quantities.",
"items": {
"properties": {
"id": {
"description": "Product id from search/product tools.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"quantity": {
"default": 1,
"maximum": 999,
"minimum": 1,
"type": "integer"
}
},
"required": [
"id"
],
"type": "object"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
},
"postcode": {
"description": "Destination postcode / ZIP.",
"maxLength": 20,
"type": "string"
}
},
"required": [
"country_code",
"items"
],
"type": "object"
},
"name": "estimate_delivery",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"country_code": {
"type": "string"
},
"ddp_included": {
"description": "Duties and taxes are prepaid (DDP) in the charges.",
"type": "boolean"
},
"note": {
"type": "string"
},
"rates": {
"items": {
"additionalProperties": false,
"properties": {
"currency": {
"type": "string"
},
"estimated_transit_days": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"express_dispatch": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Website Express same-day dispatch applies to this rate."
},
"insured": {
"type": "boolean"
},
"service_code": {
"type": "string"
},
"service_name": {
"type": "string"
},
"total_charges": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"service_code",
"service_name",
"total_charges",
"currency",
"estimated_transit_days",
"insured",
"express_dispatch"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"country_code",
"ddp_included",
"rates",
"note"
],
"type": "object"
}
},
{
"description": "A blog post's full text (plain text) by slug.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
},
"slug": {
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"slug"
],
"type": "object"
},
"name": "get_blog_post",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"post": {
"additionalProperties": false,
"properties": {
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"content": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The post body as plain text."
},
"excerpt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"type": "number"
},
"published_at": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"title",
"slug",
"url",
"excerpt",
"published_at",
"categories",
"content"
],
"type": "object"
}
},
"required": [
"post"
],
"type": "object"
}
},
{
"description": "A brand's details, its active promotions and its products (paged) by brand slug.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
},
"page": {
"description": "Page number, starting at 1.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"per_page": {
"description": "Results per page: 15, 30, 50 or 100 (default 15).",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"slug": {
"description": "Brand slug from list_brands.",
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"slug"
],
"type": "object"
},
"name": "get_brand_products",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"brand": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"id": {
"type": "number"
},
"logo": {
"type": "string"
},
"name": {
"type": "string"
},
"product_count": {
"type": "number"
},
"slug": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"slug",
"url"
],
"type": "object"
},
{
"type": "null"
}
]
},
"pagination": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"last_page": {
"type": "number"
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"total": {
"type": "number"
}
},
"required": [
"page",
"per_page",
"total",
"last_page"
],
"type": "object"
},
{
"type": "null"
}
]
},
"products": {
"items": {
"additionalProperties": false,
"properties": {
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"brand_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"express_eligible": {
"description": "Website Express (same-working-day UK dispatch); only when the listing reports it.",
"type": "boolean"
},
"gtin": {
"type": "string"
},
"id": {
"type": "number"
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"in_stock": {
"type": "boolean"
},
"mpn": {
"type": "string"
},
"name": {
"type": "string"
},
"price": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bulk_prices": {
"description": "Lower unit prices from min_quantity up.",
"items": {
"additionalProperties": false,
"properties": {
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"min_quantity": {
"type": "number"
}
},
"required": [
"min_quantity",
"ex_vat",
"inc_vat"
],
"type": "object"
},
"type": "array"
},
"currency": {
"type": "string"
},
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"on_sale": {
"type": "boolean"
},
"vat_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "VAT rate in percent (20 = 20%). null when unknown: ex_vat then equals inc_vat."
},
"was_ex_vat": {
"type": "number"
},
"was_inc_vat": {
"description": "Price before the sale; only when on_sale.",
"type": "number"
}
},
"required": [
"currency",
"ex_vat",
"inc_vat",
"on_sale",
"vat_rate"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "null when the product has no online price."
},
"sku": {
"type": "string"
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"stock_level": {
"type": "number"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"sku",
"name",
"slug",
"url",
"brand",
"brand_slug",
"categories",
"price",
"in_stock",
"stock_level",
"image",
"summary"
],
"type": "object"
},
"type": "array"
},
"promotions": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"ends_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"name",
"description",
"type",
"ends_at"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"brand",
"promotions",
"products",
"pagination"
],
"type": "object"
}
},
{
"description": "Evaluate a prospective basket for a destination country: whether it can be fulfilled, which promotions apply (including free-delivery style offers and free gifts) and the adjusted basket value. Same check the checkout runs.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"country_code": {
"description": "Destination country (ISO alpha-2).",
"pattern": "^[A-Za-z]{2}$",
"type": "string"
},
"has_tax_id": {
"description": "Whether the buyer has a VAT/tax id (business purchase).",
"type": "boolean"
},
"items": {
"description": "Basket lines as product ids with quantities.",
"items": {
"properties": {
"id": {
"description": "Product id from search/product tools.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"quantity": {
"default": 1,
"maximum": 999,
"minimum": 1,
"type": "integer"
}
},
"required": [
"id"
],
"type": "object"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
}
},
"required": [
"country_code",
"items"
],
"type": "object"
},
"name": "get_cart_promotions",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"adjusted_value": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Basket value after promotions."
},
"basket_value": {
"type": "number"
},
"can_fulfill": {
"type": "boolean"
},
"free_gifts": {
"items": {
"additionalProperties": false,
"properties": {
"quantity": {
"type": "number"
},
"sku": {
"type": "string"
}
},
"required": [
"sku",
"quantity"
],
"type": "object"
},
"type": "array"
},
"lines": {
"items": {
"additionalProperties": false,
"properties": {
"quantity": {
"type": "number"
},
"sku": {
"type": "string"
},
"unit_price": {
"type": "number"
}
},
"required": [
"sku",
"quantity",
"unit_price"
],
"type": "object"
},
"type": "array"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"promotions": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"discount_value": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"name",
"description",
"type",
"discount_value"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"can_fulfill",
"message",
"basket_value",
"adjusted_value",
"promotions",
"free_gifts",
"lines"
],
"type": "object"
}
},
{
"description": "A category's name, description and its products (paged) by category slug.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
},
"page": {
"description": "Page number, starting at 1.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"per_page": {
"description": "Results per page: 15, 30, 50 or 100 (default 15).",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"slug": {
"description": "Category slug from list_categories.",
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"sort": {
"description": "Sort order: price_low, price_high, name_asc, name_desc or newest. Omit for the default (most popular) order.",
"maxLength": 40,
"type": "string"
}
},
"required": [
"slug"
],
"type": "object"
},
"name": "get_category",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"category": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"slug",
"url"
],
"type": "object"
},
{
"type": "null"
}
]
},
"pagination": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"last_page": {
"type": "number"
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"total": {
"type": "number"
}
},
"required": [
"page",
"per_page",
"total",
"last_page"
],
"type": "object"
},
{
"type": "null"
}
]
},
"products": {
"items": {
"additionalProperties": false,
"properties": {
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"brand_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"express_eligible": {
"description": "Website Express (same-working-day UK dispatch); only when the listing reports it.",
"type": "boolean"
},
"gtin": {
"type": "string"
},
"id": {
"type": "number"
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"in_stock": {
"type": "boolean"
},
"mpn": {
"type": "string"
},
"name": {
"type": "string"
},
"price": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bulk_prices": {
"description": "Lower unit prices from min_quantity up.",
"items": {
"additionalProperties": false,
"properties": {
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"min_quantity": {
"type": "number"
}
},
"required": [
"min_quantity",
"ex_vat",
"inc_vat"
],
"type": "object"
},
"type": "array"
},
"currency": {
"type": "string"
},
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"on_sale": {
"type": "boolean"
},
"vat_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "VAT rate in percent (20 = 20%). null when unknown: ex_vat then equals inc_vat."
},
"was_ex_vat": {
"type": "number"
},
"was_inc_vat": {
"description": "Price before the sale; only when on_sale.",
"type": "number"
}
},
"required": [
"currency",
"ex_vat",
"inc_vat",
"on_sale",
"vat_rate"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "null when the product has no online price."
},
"sku": {
"type": "string"
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"stock_level": {
"type": "number"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"sku",
"name",
"slug",
"url",
"brand",
"brand_slug",
"categories",
"price",
"in_stock",
"stock_level",
"image",
"summary"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"category",
"products",
"pagination"
],
"type": "object"
}
},
{
"description": "The London Click & Collect warehouse: address, opening hours, whether it is open right now (Europe/London, bank holidays respected) and when it next opens.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "get_collection_point_info",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address_lines": {
"items": {
"type": "string"
},
"type": "array"
},
"how_it_works": {
"type": "string"
},
"name": {
"type": "string"
},
"opening_hours": {
"items": {
"additionalProperties": false,
"properties": {
"days": {
"type": "string"
},
"hours": {
"type": "string"
}
},
"required": [
"days",
"hours"
],
"type": "object"
},
"type": "array"
},
"page_url": {
"type": "string"
},
"status": {
"additionalProperties": false,
"properties": {
"closes_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "e.g. Monday 17:00."
},
"is_bank_holiday": {
"type": "boolean"
},
"is_open": {
"type": "boolean"
},
"next_opening": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"is_open",
"is_bank_holiday",
"closes_at",
"next_opening"
],
"type": "object"
},
"timezone": {
"type": "string"
}
},
"required": [
"name",
"address_lines",
"opening_hours",
"timezone",
"status",
"how_it_works",
"page_url"
],
"type": "object"
}
},
{
"description": "Whether Website Express (free same-working-day dispatch for eligible UK orders) is available right now, the order-by cutoff and the promised dispatch date.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
}
},
"type": "object"
},
"name": "get_express_delivery_status",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"available_now": {
"type": "boolean"
},
"cutoff": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"enabled": {
"type": "boolean"
},
"express_products_url": {
"type": "string"
},
"order_by_iso": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"promised_dispatch_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"enabled",
"available_now",
"cutoff",
"order_by_iso",
"promised_dispatch_date",
"express_products_url"
],
"type": "object"
}
},
{
"description": "Full text (markdown) of a store policy: delivery, returns, payment-options, faqs or contact.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
},
"policy": {
"enum": [
"delivery",
"returns",
"payment-options",
"faqs",
"contact"
],
"type": "string"
}
},
"required": [
"policy"
],
"type": "object"
},
"name": "get_policy",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"enum": [
"delivery",
"returns",
"payment-options",
"faqs",
"contact"
],
"type": "string"
},
"markdown": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"title",
"url",
"markdown"
],
"type": "object"
}
},
{
"description": "Country-specific pricing for a set of products (the checkout applies the destination country's currency and pricing). Returns unit, sale and final prices plus the subtotal.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"items": {
"description": "Basket lines as product ids with quantities.",
"items": {
"properties": {
"id": {
"description": "Product id from search/product tools.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"quantity": {
"default": 1,
"maximum": 999,
"minimum": 1,
"type": "integer"
}
},
"required": [
"id"
],
"type": "object"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
},
"shipping_country": {
"description": "ISO 3166-1 alpha-2 country code, e.g. GB, IE, DE, US.",
"pattern": "^[A-Za-z]{2}$",
"type": "string"
}
},
"required": [
"shipping_country",
"items"
],
"type": "object"
},
"name": "get_prices_for_country",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"fallback_used": {
"description": "No prices for this country: another country's were used.",
"type": "boolean"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"final_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"id": {
"type": "number"
},
"quantity": {
"type": "number"
},
"sale_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"unit_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"quantity",
"unit_price",
"sale_price",
"final_price"
],
"type": "object"
},
"type": "array"
},
"pricing_country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shipping_country": {
"type": "string"
},
"subtotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"shipping_country",
"pricing_country",
"currency",
"fallback_used",
"items",
"subtotal"
],
"type": "object"
}
},
{
"description": "Full details for one product by slug, SKU or id: description, specifications, prices ex/inc VAT with bulk breaks, stock, variants, safety/spec documents and the canonical page URL. Provide exactly one of slug, sku or id.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"description": "Numeric product id.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
},
"sku": {
"description": "Product SKU.",
"maxLength": 64,
"type": "string"
},
"slug": {
"description": "Product slug from a product URL (…/product/<slug>).",
"maxLength": 200,
"type": "string"
}
},
"type": "object"
},
"name": "get_product",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"product": {
"additionalProperties": false,
"properties": {
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"brand_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"coshh_codes": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"description": {
"type": "string"
}
},
"required": [
"code",
"description"
],
"type": "object"
},
"type": "array"
},
"country_of_origin": {
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"documents": {
"items": {
"additionalProperties": false,
"properties": {
"type": {
"description": "safety_sheet or specification_sheet.",
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"type",
"url"
],
"type": "object"
},
"type": "array"
},
"express_eligible": {
"description": "Website Express (same-working-day UK dispatch); only when the listing reports it.",
"type": "boolean"
},
"gtin": {
"type": "string"
},
"has_related_products": {
"description": "get_related_products has variants or alternatives.",
"type": "boolean"
},
"hazardous": {
"type": "boolean"
},
"id": {
"type": "number"
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"in_stock": {
"type": "boolean"
},
"mpn": {
"type": "string"
},
"name": {
"type": "string"
},
"price": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bulk_prices": {
"description": "Lower unit prices from min_quantity up.",
"items": {
"additionalProperties": false,
"properties": {
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"min_quantity": {
"type": "number"
}
},
"required": [
"min_quantity",
"ex_vat",
"inc_vat"
],
"type": "object"
},
"type": "array"
},
"currency": {
"type": "string"
},
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"on_sale": {
"type": "boolean"
},
"vat_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "VAT rate in percent (20 = 20%). null when unknown: ex_vat then equals inc_vat."
},
"was_ex_vat": {
"type": "number"
},
"was_inc_vat": {
"description": "Price before the sale; only when on_sale.",
"type": "number"
}
},
"required": [
"currency",
"ex_vat",
"inc_vat",
"on_sale",
"vat_rate"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "null when the product has no online price."
},
"sku": {
"type": "string"
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"specifications": {
"items": {
"type": "string"
},
"type": "array"
},
"stock_level": {
"type": "number"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"variants": {
"items": {
"additionalProperties": false,
"properties": {
"in_stock": {
"type": "boolean"
},
"label": {
"type": "string"
},
"options": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"price": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bulk_prices": {
"description": "Lower unit prices from min_quantity up.",
"items": {
"additionalProperties": false,
"properties": {
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"min_quantity": {
"type": "number"
}
},
"required": [
"min_quantity",
"ex_vat",
"inc_vat"
],
"type": "object"
},
"type": "array"
},
"currency": {
"type": "string"
},
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"on_sale": {
"type": "boolean"
},
"vat_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "VAT rate in percent (20 = 20%). null when unknown: ex_vat then equals inc_vat."
},
"was_ex_vat": {
"type": "number"
},
"was_inc_vat": {
"description": "Price before the sale; only when on_sale.",
"type": "number"
}
},
"required": [
"currency",
"ex_vat",
"inc_vat",
"on_sale",
"vat_rate"
],
"type": "object"
},
{
"type": "null"
}
]
},
"sku": {
"type": "string"
},
"slug": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"sku",
"label",
"options",
"slug",
"url",
"price",
"in_stock"
],
"type": "object"
},
"type": "array"
},
"weight_kg": {
"type": "number"
}
},
"required": [
"id",
"sku",
"name",
"slug",
"url",
"brand",
"brand_slug",
"categories",
"price",
"in_stock",
"stock_level",
"image",
"summary",
"tags",
"description",
"specifications",
"hazardous",
"has_related_products"
],
"type": "object"
}
},
"required": [
"product"
],
"type": "object"
}
},
{
"description": "Safety data sheets, specification sheets and COSHH hazard codes for a product (by slug or SKU). Returns document URLs.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
},
"sku": {
"description": "Product SKU.",
"maxLength": 64,
"type": "string"
},
"slug": {
"description": "Product slug from a product URL (…/product/<slug>).",
"maxLength": 200,
"type": "string"
}
},
"type": "object"
},
"name": "get_product_documents",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"coshh_codes": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"description": {
"type": "string"
}
},
"required": [
"code",
"description"
],
"type": "object"
},
"type": "array"
},
"documents": {
"items": {
"additionalProperties": false,
"properties": {
"type": {
"description": "safety_sheet or specification_sheet.",
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"type",
"url"
],
"type": "object"
},
"type": "array"
},
"hazardous": {
"type": "boolean"
},
"product": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"sku": {
"type": "string"
}
},
"required": [
"sku",
"name"
],
"type": "object"
}
},
"required": [
"product",
"hazardous",
"documents",
"coshh_codes"
],
"type": "object"
}
},
{
"description": "Active promotions that apply to one SKU (discounts, free gifts, end dates).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
},
"sku": {
"description": "Product SKU exactly as shown on the site.",
"maxLength": 64,
"minLength": 1,
"type": "string"
}
},
"required": [
"sku"
],
"type": "object"
},
"name": "get_product_promotions",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"promotions": {
"items": {
"additionalProperties": false,
"properties": {
"brands": {
"items": {
"type": "string"
},
"type": "array"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"discount_value": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Percent or amount off, depending on type."
},
"ends_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"free_gift": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"sku": {
"type": "string"
}
},
"required": [
"sku",
"name"
],
"type": "object"
},
{
"type": "null"
}
]
},
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"scope": {
"type": "string"
},
"terms_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"type": {
"description": "percentage_discount, fixed_discount or free_gift.",
"type": "string"
}
},
"required": [
"id",
"name",
"description",
"type",
"discount_value",
"ends_at",
"scope",
"brands",
"free_gift",
"terms_url"
],
"type": "object"
},
"type": "array"
},
"sku": {
"type": "string"
}
},
"required": [
"sku",
"promotions"
],
"type": "object"
}
},
{
"description": "Look up up to 50 products at once by SKU or by numeric id. Returns compact products (name, price ex/inc VAT, stock, link).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"ids": {
"items": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
},
"skus": {
"items": {
"description": "Product SKU exactly as shown on the site.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
}
},
"type": "object"
},
"name": "get_products",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"products": {
"items": {
"additionalProperties": false,
"properties": {
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"brand_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"express_eligible": {
"description": "Website Express (same-working-day UK dispatch); only when the listing reports it.",
"type": "boolean"
},
"gtin": {
"type": "string"
},
"id": {
"type": "number"
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"in_stock": {
"type": "boolean"
},
"mpn": {
"type": "string"
},
"name": {
"type": "string"
},
"price": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bulk_prices": {
"description": "Lower unit prices from min_quantity up.",
"items": {
"additionalProperties": false,
"properties": {
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"min_quantity": {
"type": "number"
}
},
"required": [
"min_quantity",
"ex_vat",
"inc_vat"
],
"type": "object"
},
"type": "array"
},
"currency": {
"type": "string"
},
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"on_sale": {
"type": "boolean"
},
"vat_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "VAT rate in percent (20 = 20%). null when unknown: ex_vat then equals inc_vat."
},
"was_ex_vat": {
"type": "number"
},
"was_inc_vat": {
"description": "Price before the sale; only when on_sale.",
"type": "number"
}
},
"required": [
"currency",
"ex_vat",
"inc_vat",
"on_sale",
"vat_rate"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "null when the product has no online price."
},
"sku": {
"type": "string"
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"stock_level": {
"type": "number"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"sku",
"name",
"slug",
"url",
"brand",
"brand_slug",
"categories",
"price",
"in_stock",
"stock_level",
"image",
"summary"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"products"
],
"type": "object"
}
},
{
"description": "Variants, similar products, recommendations and 'you may also like' items for a product (by slug or SKU). Useful for alternatives when something is out of stock.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
},
"sku": {
"description": "Product SKU.",
"maxLength": 64,
"type": "string"
},
"slug": {
"description": "Product slug from a product URL (…/product/<slug>).",
"maxLength": 200,
"type": "string"
}
},
"type": "object"
},
"name": "get_related_products",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"may_like": {
"items": {
"additionalProperties": false,
"properties": {
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"brand_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"express_eligible": {
"description": "Website Express (same-working-day UK dispatch); only when the listing reports it.",
"type": "boolean"
},
"gtin": {
"type": "string"
},
"id": {
"type": "number"
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"in_stock": {
"type": "boolean"
},
"mpn": {
"type": "string"
},
"name": {
"type": "string"
},
"price": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bulk_prices": {
"description": "Lower unit prices from min_quantity up.",
"items": {
"additionalProperties": false,
"properties": {
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"min_quantity": {
"type": "number"
}
},
"required": [
"min_quantity",
"ex_vat",
"inc_vat"
],
"type": "object"
},
"type": "array"
},
"currency": {
"type": "string"
},
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"on_sale": {
"type": "boolean"
},
"vat_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "VAT rate in percent (20 = 20%). null when unknown: ex_vat then equals inc_vat."
},
"was_ex_vat": {
"type": "number"
},
"was_inc_vat": {
"description": "Price before the sale; only when on_sale.",
"type": "number"
}
},
"required": [
"currency",
"ex_vat",
"inc_vat",
"on_sale",
"vat_rate"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "null when the product has no online price."
},
"sku": {
"type": "string"
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"stock_level": {
"type": "number"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"sku",
"name",
"slug",
"url",
"brand",
"brand_slug",
"categories",
"price",
"in_stock",
"stock_level",
"image",
"summary"
],
"type": "object"
},
"type": "array"
},
"product": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"sku": {
"type": "string"
}
},
"required": [
"sku",
"name"
],
"type": "object"
},
"recommendations": {
"items": {
"additionalProperties": false,
"properties": {
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"brand_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"express_eligible": {
"description": "Website Express (same-working-day UK dispatch); only when the listing reports it.",
"type": "boolean"
},
"gtin": {
"type": "string"
},
"id": {
"type": "number"
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"in_stock": {
"type": "boolean"
},
"mpn": {
"type": "string"
},
"name": {
"type": "string"
},
"price": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bulk_prices": {
"description": "Lower unit prices from min_quantity up.",
"items": {
"additionalProperties": false,
"properties": {
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"min_quantity": {
"type": "number"
}
},
"required": [
"min_quantity",
"ex_vat",
"inc_vat"
],
"type": "object"
},
"type": "array"
},
"currency": {
"type": "string"
},
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"on_sale": {
"type": "boolean"
},
"vat_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "VAT rate in percent (20 = 20%). null when unknown: ex_vat then equals inc_vat."
},
"was_ex_vat": {
"type": "number"
},
"was_inc_vat": {
"description": "Price before the sale; only when on_sale.",
"type": "number"
}
},
"required": [
"currency",
"ex_vat",
"inc_vat",
"on_sale",
"vat_rate"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "null when the product has no online price."
},
"sku": {
"type": "string"
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"stock_level": {
"type": "number"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"sku",
"name",
"slug",
"url",
"brand",
"brand_slug",
"categories",
"price",
"in_stock",
"stock_level",
"image",
"summary"
],
"type": "object"
},
"type": "array"
},
"similar_products": {
"items": {
"additionalProperties": false,
"properties": {
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"brand_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"express_eligible": {
"description": "Website Express (same-working-day UK dispatch); only when the listing reports it.",
"type": "boolean"
},
"gtin": {
"type": "string"
},
"id": {
"type": "number"
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"in_stock": {
"type": "boolean"
},
"mpn": {
"type": "string"
},
"name": {
"type": "string"
},
"price": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bulk_prices": {
"description": "Lower unit prices from min_quantity up.",
"items": {
"additionalProperties": false,
"properties": {
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"min_quantity": {
"type": "number"
}
},
"required": [
"min_quantity",
"ex_vat",
"inc_vat"
],
"type": "object"
},
"type": "array"
},
"currency": {
"type": "string"
},
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"on_sale": {
"type": "boolean"
},
"vat_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "VAT rate in percent (20 = 20%). null when unknown: ex_vat then equals inc_vat."
},
"was_ex_vat": {
"type": "number"
},
"was_inc_vat": {
"description": "Price before the sale; only when on_sale.",
"type": "number"
}
},
"required": [
"currency",
"ex_vat",
"inc_vat",
"on_sale",
"vat_rate"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "null when the product has no online price."
},
"sku": {
"type": "string"
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"stock_level": {
"type": "number"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"sku",
"name",
"slug",
"url",
"brand",
"brand_slug",
"categories",
"price",
"in_stock",
"stock_level",
"image",
"summary"
],
"type": "object"
},
"type": "array"
},
"variants": {
"items": {
"additionalProperties": false,
"properties": {
"in_stock": {
"type": "boolean"
},
"label": {
"type": "string"
},
"options": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"sku": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"sku",
"label",
"options",
"in_stock",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"product",
"variants",
"similar_products",
"recommendations",
"may_like"
],
"type": "object"
}
},
{
"description": "Who Camden Tools is, how to contact them, VAT display rules, key page links, current announcements and a summary of each policy (delivery, returns, payment, FAQs). Call get_policy for the full text of a policy.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
}
},
"type": "object"
},
"name": "get_site_info",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"announcements": {
"items": {
"additionalProperties": false,
"properties": {
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"title",
"message"
],
"type": "object"
},
"type": "array"
},
"collection_point": {
"additionalProperties": false,
"properties": {
"address_lines": {
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"type": "string"
},
"opening_hours": {
"items": {
"additionalProperties": false,
"properties": {
"days": {
"type": "string"
},
"hours": {
"type": "string"
}
},
"required": [
"days",
"hours"
],
"type": "object"
},
"type": "array"
},
"timezone": {
"type": "string"
}
},
"required": [
"name",
"address_lines",
"opening_hours",
"timezone"
],
"type": "object"
},
"how_to_buy": {
"type": "string"
},
"pages": {
"additionalProperties": false,
"properties": {
"bundles": {
"type": "string"
},
"cart": {
"type": "string"
},
"collections": {
"type": "string"
},
"contact": {
"type": "string"
},
"deliveries": {
"type": "string"
},
"developers": {
"type": "string"
},
"express_delivery": {
"type": "string"
},
"faqs": {
"type": "string"
},
"offers": {
"type": "string"
},
"payment_options": {
"type": "string"
},
"returns_policy": {
"type": "string"
},
"shop": {
"type": "string"
},
"track_order": {
"type": "string"
}
},
"required": [
"shop",
"offers",
"bundles",
"express_delivery",
"deliveries",
"returns_policy",
"payment_options",
"faqs",
"contact",
"track_order",
"collections",
"cart",
"developers"
],
"type": "object"
},
"policies": {
"items": {
"additionalProperties": false,
"properties": {
"excerpt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"enum": [
"delivery",
"returns",
"payment-options",
"faqs",
"contact"
],
"type": "string"
},
"resource_uri": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"title",
"url",
"resource_uri",
"excerpt"
],
"type": "object"
},
"type": "array"
},
"store": {
"additionalProperties": false,
"properties": {
"currency_default": {
"type": "string"
},
"email": {
"type": "string"
},
"legal_name": {
"type": "string"
},
"name": {
"type": "string"
},
"phone": {
"type": "string"
},
"vat_display": {
"type": "string"
},
"vat_number": {
"type": "string"
},
"website": {
"type": "string"
}
},
"required": [
"name",
"legal_name",
"vat_number",
"email",
"phone",
"website",
"currency_default",
"vat_display"
],
"type": "object"
}
},
"required": [
"store",
"collection_point",
"how_to_buy",
"pages",
"announcements",
"policies"
],
"type": "object"
}
},
{
"description": "Live availability check for a SKU (is it available now and how many are in the London warehouse).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"sku": {
"description": "Product SKU exactly as shown on the site.",
"maxLength": 64,
"minLength": 1,
"type": "string"
}
},
"required": [
"sku"
],
"type": "object"
},
"name": "get_stock_level",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"available": {
"type": "boolean"
},
"locale": {
"type": "string"
},
"sku": {
"type": "string"
},
"warehouse_quantity": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Units in the London warehouse; null when not reported."
}
},
"required": [
"sku",
"available",
"warehouse_quantity",
"locale"
],
"type": "object"
}
},
{
"description": "Brands sold by Camden Tools (DeWalt, Makita, Milwaukee, Bosch, Stanley …). Without a query returns the popular brands; with a query searches brand names.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"description": "Page number, starting at 1.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"per_page": {
"description": "Results per page: 15, 30, 50 or 100 (default 15).",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"query": {
"description": "Brand name search text.",
"maxLength": 80,
"type": "string"
},
"sort": {
"description": "Sort order: price_low, price_high, name_asc, name_desc or newest. Omit for the default (most popular) order.",
"maxLength": 40,
"type": "string"
}
},
"type": "object"
},
"name": "list_brands",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"brands": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "number"
},
"logo": {
"type": "string"
},
"name": {
"type": "string"
},
"product_count": {
"type": "number"
},
"slug": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"slug",
"url"
],
"type": "object"
},
"type": "array"
},
"pagination": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"last_page": {
"type": "number"
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"total": {
"type": "number"
}
},
"required": [
"page",
"per_page",
"total",
"last_page"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"brands",
"pagination"
],
"type": "object"
}
},
{
"description": "Curated product bundles (kits) with their items and prices.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
}
},
"type": "object"
},
"name": "list_bundles",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"bundles_url": {
"type": "string"
},
"groups": {
"items": {
"additionalProperties": false,
"properties": {
"bundles": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"type": "number"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"product": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"brand_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"express_eligible": {
"description": "Website Express (same-working-day UK dispatch); only when the listing reports it.",
"type": "boolean"
},
"gtin": {
"type": "string"
},
"id": {
"type": "number"
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"in_stock": {
"type": "boolean"
},
"mpn": {
"type": "string"
},
"name": {
"type": "string"
},
"price": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bulk_prices": {
"description": "Lower unit prices from min_quantity up.",
"items": {
"additionalProperties": false,
"properties": {
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"min_quantity": {
"type": "number"
}
},
"required": [
"min_quantity",
"ex_vat",
"inc_vat"
],
"type": "object"
},
"type": "array"
},
"currency": {
"type": "string"
},
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"on_sale": {
"type": "boolean"
},
"vat_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "VAT rate in percent (20 = 20%). null when unknown: ex_vat then equals inc_vat."
},
"was_ex_vat": {
"type": "number"
},
"was_inc_vat": {
"description": "Price before the sale; only when on_sale.",
"type": "number"
}
},
"required": [
"currency",
"ex_vat",
"inc_vat",
"on_sale",
"vat_rate"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "null when the product has no online price."
},
"sku": {
"type": "string"
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"stock_level": {
"type": "number"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"sku",
"name",
"slug",
"url",
"brand",
"brand_slug",
"categories",
"price",
"in_stock",
"stock_level",
"image",
"summary"
],
"type": "object"
},
{
"type": "null"
}
]
},
"quantity": {
"type": "number"
}
},
"required": [
"quantity",
"product"
],
"type": "object"
},
"type": "array"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name",
"description",
"items"
],
"type": "object"
},
"type": "array"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
}
},
"required": [
"name",
"description",
"bundles"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"groups",
"bundles_url"
],
"type": "object"
}
},
{
"description": "Product categories with slugs and links. Use popular_only for the curated set shown on the site; otherwise the full list.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"description": "Maximum categories to return (default 100).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
},
"popular_only": {
"description": "Only the popular categories (default false).",
"type": "boolean"
}
},
"type": "object"
},
"name": "list_categories",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"categories": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"slug",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"categories"
],
"type": "object"
}
},
{
"description": "Current storefront promotions (percentage/fixed discounts and free gifts), optionally grouped by brand or category. Also points at the /offers page.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"group_by": {
"description": "Grouping (default all).",
"enum": [
"all",
"brand",
"category"
],
"type": "string"
},
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
}
},
"type": "object"
},
"name": "list_offers",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"groups": {
"description": "With group_by brand or category.",
"items": {
"additionalProperties": false,
"properties": {
"group": {
"type": "string"
},
"promotions": {
"items": {
"additionalProperties": false,
"properties": {
"brands": {
"items": {
"type": "string"
},
"type": "array"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"discount_value": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Percent or amount off, depending on type."
},
"ends_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"free_gift": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"sku": {
"type": "string"
}
},
"required": [
"sku",
"name"
],
"type": "object"
},
{
"type": "null"
}
]
},
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"scope": {
"type": "string"
},
"terms_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"type": {
"description": "percentage_discount, fixed_discount or free_gift.",
"type": "string"
}
},
"required": [
"id",
"name",
"description",
"type",
"discount_value",
"ends_at",
"scope",
"brands",
"free_gift",
"terms_url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"group",
"promotions"
],
"type": "object"
},
"type": "array"
},
"offers": {
"description": "With group_by all (the default).",
"items": {
"additionalProperties": false,
"properties": {
"brands": {
"items": {
"type": "string"
},
"type": "array"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"discount_value": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Percent or amount off, depending on type."
},
"ends_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"free_gift": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"sku": {
"type": "string"
}
},
"required": [
"sku",
"name"
],
"type": "object"
},
{
"type": "null"
}
]
},
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"scope": {
"type": "string"
},
"terms_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"type": {
"description": "percentage_discount, fixed_discount or free_gift.",
"type": "string"
}
},
"required": [
"id",
"name",
"description",
"type",
"discount_value",
"ends_at",
"scope",
"brands",
"free_gift",
"terms_url"
],
"type": "object"
},
"type": "array"
},
"offers_url": {
"type": "string"
}
},
"required": [
"offers_url"
],
"type": "object"
}
},
{
"description": "Browse a product collection: most popular, newest, on sale, Website Express eligible, or a category by slug (see list_categories). Supports paging, sorting and brand/price filters.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"brand": {
"description": "Brand slug to filter by.",
"maxLength": 80,
"type": "string"
},
"category_slug": {
"description": "Required when collection is 'category'.",
"maxLength": 120,
"type": "string"
},
"collection": {
"description": "Which collection to list.",
"enum": [
"popular",
"new",
"on-sale",
"express",
"category"
],
"type": "string"
},
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
},
"max_price": {
"description": "Maximum price in the locale currency.",
"minimum": 0,
"type": "number"
},
"min_discount": {
"description": "Minimum discount percentage (on-sale listings).",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"min_price": {
"description": "Minimum price in the locale currency.",
"minimum": 0,
"type": "number"
},
"page": {
"description": "Page number, starting at 1.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"per_page": {
"description": "Results per page: 15, 30, 50 or 100 (default 15).",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"sort": {
"description": "Sort order: price_low, price_high, name_asc, name_desc or newest. Omit for the default (most popular) order.",
"maxLength": 40,
"type": "string"
}
},
"required": [
"collection"
],
"type": "object"
},
"name": "list_products",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"category": {
"additionalProperties": false,
"description": "The category, when collection is category.",
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"slug",
"url"
],
"type": "object"
},
"collection": {
"enum": [
"popular",
"new",
"on-sale",
"express",
"category"
],
"type": "string"
},
"pagination": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"last_page": {
"type": "number"
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"total": {
"type": "number"
}
},
"required": [
"page",
"per_page",
"total",
"last_page"
],
"type": "object"
},
{
"type": "null"
}
]
},
"products": {
"items": {
"additionalProperties": false,
"properties": {
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"brand_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"express_eligible": {
"description": "Website Express (same-working-day UK dispatch); only when the listing reports it.",
"type": "boolean"
},
"gtin": {
"type": "string"
},
"id": {
"type": "number"
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"in_stock": {
"type": "boolean"
},
"mpn": {
"type": "string"
},
"name": {
"type": "string"
},
"price": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bulk_prices": {
"description": "Lower unit prices from min_quantity up.",
"items": {
"additionalProperties": false,
"properties": {
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"min_quantity": {
"type": "number"
}
},
"required": [
"min_quantity",
"ex_vat",
"inc_vat"
],
"type": "object"
},
"type": "array"
},
"currency": {
"type": "string"
},
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"on_sale": {
"type": "boolean"
},
"vat_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "VAT rate in percent (20 = 20%). null when unknown: ex_vat then equals inc_vat."
},
"was_ex_vat": {
"type": "number"
},
"was_inc_vat": {
"description": "Price before the sale; only when on_sale.",
"type": "number"
}
},
"required": [
"currency",
"ex_vat",
"inc_vat",
"on_sale",
"vat_rate"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "null when the product has no online price."
},
"sku": {
"type": "string"
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"stock_level": {
"type": "number"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"sku",
"name",
"slug",
"url",
"brand",
"brand_slug",
"categories",
"price",
"in_stock",
"stock_level",
"image",
"summary"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"collection",
"products",
"pagination"
],
"type": "object"
}
},
{
"description": "Addresses for a UK postcode (rate limited upstream). Returns matching addresses or suggestions when the postcode is incomplete.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"postcode": {
"description": "UK postcode, e.g. NW2 7JW.",
"maxLength": 12,
"minLength": 2,
"type": "string"
}
},
"required": [
"postcode"
],
"type": "object"
},
"name": "lookup_uk_postcode",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"addresses": {
"items": {
"additionalProperties": false,
"properties": {
"county": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"label": {
"type": "string"
},
"line_1": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"line_2": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"post_town": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"postcode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"label",
"line_1",
"line_2",
"post_town",
"county",
"postcode"
],
"type": "object"
},
"type": "array"
},
"status": {
"type": "string"
},
"suggestions": {
"description": "Possible postcodes when the one given is incomplete.",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"status",
"addresses",
"suggestions"
],
"type": "object"
}
},
{
"description": "Guides and articles from the Camden Tools blog (how-tos, buying guides, brand news).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"description": "Page number, starting at 1.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Search text; omit for the latest posts.",
"maxLength": 120,
"type": "string"
}
},
"type": "object"
},
"name": "search_blog_posts",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blog_url": {
"type": "string"
},
"pagination": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"last_page": {
"type": "number"
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"total": {
"type": "number"
}
},
"required": [
"page",
"per_page",
"total",
"last_page"
],
"type": "object"
},
{
"type": "null"
}
]
},
"posts": {
"items": {
"additionalProperties": false,
"properties": {
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"excerpt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"type": "number"
},
"published_at": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"title",
"slug",
"url",
"excerpt",
"published_at",
"categories"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"posts",
"pagination",
"blog_url"
],
"type": "object"
}
},
{
"description": "Full-text search of the Camden Tools catalogue (hand tools, power tools, accessories, safety equipment). Returns compact products with prices ex/inc VAT, stock and a link. Use page/per_page to paginate and brand/min_price/max_price to narrow down.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"brand": {
"description": "Brand slug to filter by.",
"maxLength": 80,
"type": "string"
},
"express": {
"description": "Only products eligible for Website Express same-day dispatch (UK).",
"type": "boolean"
},
"locale": {
"description": "Storefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.",
"maxLength": 5,
"minLength": 2,
"type": "string"
},
"max_price": {
"description": "Maximum price in the locale currency.",
"minimum": 0,
"type": "number"
},
"min_price": {
"description": "Minimum price in the locale currency.",
"minimum": 0,
"type": "number"
},
"page": {
"description": "Page number, starting at 1.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"per_page": {
"description": "Results per page: 15, 30, 50 or 100 (default 15).",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"query": {
"description": "What the shopper is looking for, e.g. 'cordless combi drill 18v'.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"sort": {
"description": "Sort order: price_low, price_high, name_asc, name_desc or newest. Omit for the default (most popular) order.",
"maxLength": 40,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_products",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"pagination": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"last_page": {
"type": "number"
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"total": {
"type": "number"
}
},
"required": [
"page",
"per_page",
"total",
"last_page"
],
"type": "object"
},
{
"type": "null"
}
]
},
"products": {
"items": {
"additionalProperties": false,
"properties": {
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"brand_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"express_eligible": {
"description": "Website Express (same-working-day UK dispatch); only when the listing reports it.",
"type": "boolean"
},
"gtin": {
"type": "string"
},
"id": {
"type": "number"
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"in_stock": {
"type": "boolean"
},
"mpn": {
"type": "string"
},
"name": {
"type": "string"
},
"price": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bulk_prices": {
"description": "Lower unit prices from min_quantity up.",
"items": {
"additionalProperties": false,
"properties": {
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"min_quantity": {
"type": "number"
}
},
"required": [
"min_quantity",
"ex_vat",
"inc_vat"
],
"type": "object"
},
"type": "array"
},
"currency": {
"type": "string"
},
"ex_vat": {
"type": "number"
},
"inc_vat": {
"type": "number"
},
"on_sale": {
"type": "boolean"
},
"vat_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "VAT rate in percent (20 = 20%). null when unknown: ex_vat then equals inc_vat."
},
"was_ex_vat": {
"type": "number"
},
"was_inc_vat": {
"description": "Price before the sale; only when on_sale.",
"type": "number"
}
},
"required": [
"currency",
"ex_vat",
"inc_vat",
"on_sale",
"vat_rate"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "null when the product has no online price."
},
"sku": {
"type": "string"
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"stock_level": {
"type": "number"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"sku",
"name",
"slug",
"url",
"brand",
"brand_slug",
"categories",
"price",
"in_stock",
"stock_level",
"image",
"summary"
],
"type": "object"
},
"type": "array"
},
"query": {
"type": "string"
},
"search_url": {
"description": "The same search on camdentools.com.",
"type": "string"
}
},
"required": [
"query",
"search_url",
"products",
"pagination"
],
"type": "object"
}
},
{
"description": "Order status, tracking number/URL, shipping method and line items for any order, given the order number and the delivery postcode (no sign-in needed).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"order_number": {
"description": "Order number from the confirmation email.",
"maxLength": 40,
"minLength": 3,
"type": "string"
},
"postcode": {
"description": "Delivery postcode / ZIP on the order.",
"maxLength": 20,
"minLength": 2,
"type": "string"
}
},
"required": [
"order_number",
"postcode"
],
"type": "object"
},
"name": "track_guest_order",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"order": {
"additionalProperties": false,
"properties": {
"currency": {
"type": "string"
},
"discount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"express_promised_dispatch_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"is_express": {
"type": "boolean"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"line_total": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"quantity": {
"type": "number"
},
"sku": {
"type": "string"
},
"unit_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"sku",
"name",
"quantity",
"unit_price",
"line_total"
],
"type": "object"
},
"type": "array"
},
"order_date": {
"type": "string"
},
"order_number": {
"type": "string"
},
"paid_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shipped_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shipping_company": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shipping_cost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"shipping_method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shipping_to": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"country_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"postal_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"city",
"postal_code",
"country_code"
],
"type": "object"
},
{
"type": "null"
}
]
},
"status": {
"type": "string"
},
"subtotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"tax": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"total": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"tracking_number": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"tracking_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"order_number",
"status",
"order_date",
"currency",
"total",
"subtotal",
"shipping_cost",
"tax",
"discount",
"shipping_method",
"tracking_number",
"tracking_url",
"shipping_company",
"shipped_at",
"paid_at",
"items",
"shipping_to"
],
"type": "object"
},
"track_url": {
"type": "string"
}
},
"required": [
"order",
"track_url"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:72bb86e468c2fdfb0cb4bf06191f41ba572044de478d3bc4578c80148c9cf07a | sha256sum