Servers Playground How we check Add a server Log in

Camden Tools

Working · 1.9 s

com.camdentools/shopv1.4.0 Domain verified

UK tool shop: search, prices ex/inc VAT, stock, delivery, order tracking and basket links.

Commerce

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://camdentools.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

check_express_eligibility Read-only

Whole-basket Website Express verdict for a set of product ids and quantities: every line must be eligible (no split shipments).

itemsarray, required

Basket lines as product ids with quantities.

localestring

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.

Camden Tools MCP server | mcptry

Tools (29)

check_express_eligibility

Whole-basket Website Express verdict for a set of product ids and quantities: every line must be eligible (no split shipments).

read-only

Argument	Type	Description
items*	array	Basket lines as product ids with quantities.
locale	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "maximum": 9007199254740991,
            "description": "Product id from search/product tools.",
            "exclusiveMinimum": 0
          },
          "quantity": {
            "type": "integer",
            "default": 1,
            "maximum": 999,
            "minimum": 1
          }
        }
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Basket lines as product ids with quantities."
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    }
  }
}

check_shipping_availability

Whether Camden Tools ships to a country, with any restriction message.

read-only

Argument	Type	Description
locale	string	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.
country_code*	string	ISO 3166-1 alpha-2 country code, e.g. GB, IE, DE, US.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "country_code"
  ],
  "properties": {
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    },
    "country_code": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "ISO 3166-1 alpha-2 country code, e.g. GB, IE, DE, US."
    }
  }
}

compare_products

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.

read-only

Argument	Type	Description
skus*	array
locale	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "skus"
  ],
  "properties": {
    "skus": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64,
        "minLength": 1,
        "description": "Product SKU exactly as shown on the site."
      },
      "maxItems": 5,
      "minItems": 2
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    }
  }
}

create_basket_link

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.

read-only

Argument	Type	Description
items*	array	Basket lines as product ids with quantities.
locale	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "maximum": 9007199254740991,
            "description": "Product id from search/product tools.",
            "exclusiveMinimum": 0
          },
          "quantity": {
            "type": "integer",
            "default": 1,
            "maximum": 999,
            "minimum": 1
          }
        }
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Basket lines as product ids with quantities."
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    }
  }
}

estimate_delivery

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.

read-only

Argument	Type	Description
city	string	Destination city.
items*	array	Basket lines as product ids with quantities.
locale	string	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.
postcode	string	Destination postcode / ZIP.
country_code*	string	ISO 3166-1 alpha-2 country code, e.g. GB, IE, DE, US.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "country_code",
    "items"
  ],
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 80,
      "description": "Destination city."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "maximum": 9007199254740991,
            "description": "Product id from search/product tools.",
            "exclusiveMinimum": 0
          },
          "quantity": {
            "type": "integer",
            "default": 1,
            "maximum": 999,
            "minimum": 1
          }
        }
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Basket lines as product ids with quantities."
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    },
    "postcode": {
      "type": "string",
      "maxLength": 20,
      "description": "Destination postcode / ZIP."
    },
    "country_code": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "ISO 3166-1 alpha-2 country code, e.g. GB, IE, DE, US."
    }
  }
}

get_blog_post

A blog post's full text (plain text) by slug.

read-only

Argument	Type	Description
slug*	string
locale	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    }
  }
}

get_brand_products

A brand's details, its active promotions and its products (paged) by brand slug.

read-only

Argument	Type	Description
page	integer	Page number, starting at 1.
slug*	string	Brand slug from list_brands.
locale	string	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.
per_page	integer	Results per page: 15, 30, 50 or 100 (default 15).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "slug"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Page number, starting at 1."
    },
    "slug": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "Brand slug from list_brands."
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    },
    "per_page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Results per page: 15, 30, 50 or 100 (default 15)."
    }
  }
}

get_cart_promotions

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.

read-only

Argument	Type	Description
items*	array	Basket lines as product ids with quantities.
locale	string	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.
has_tax_id	boolean	Whether the buyer has a VAT/tax id (business purchase).
country_code*	string	Destination country (ISO alpha-2).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "country_code",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "maximum": 9007199254740991,
            "description": "Product id from search/product tools.",
            "exclusiveMinimum": 0
          },
          "quantity": {
            "type": "integer",
            "default": 1,
            "maximum": 999,
            "minimum": 1
          }
        }
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Basket lines as product ids with quantities."
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    },
    "has_tax_id": {
      "type": "boolean",
      "description": "Whether the buyer has a VAT/tax id (business purchase)."
    },
    "country_code": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Destination country (ISO alpha-2)."
    }
  }
}

get_category

A category's name, description and its products (paged) by category slug.

read-only

Argument	Type	Description
page	integer	Page number, starting at 1.
slug*	string	Category slug from list_categories.
sort	string	Sort order: price_low, price_high, name_asc, name_desc or newest. Omit for the default (most popular) order.
locale	string	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.
per_page	integer	Results per page: 15, 30, 50 or 100 (default 15).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "slug"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Page number, starting at 1."
    },
    "slug": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1,
      "description": "Category slug from list_categories."
    },
    "sort": {
      "type": "string",
      "maxLength": 40,
      "description": "Sort order: price_low, price_high, name_asc, name_desc or newest. Omit for the default (most popular) order."
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    },
    "per_page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Results per page: 15, 30, 50 or 100 (default 15)."
    }
  }
}

get_collection_point_info

The London Click & Collect warehouse: address, opening hours, whether it is open right now (Europe/London, bank holidays respected) and when it next opens.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_express_delivery_status

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.

read-only

Argument	Type	Description
locale	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    }
  }
}

get_policy

Full text (markdown) of a store policy: delivery, returns, payment-options, faqs or contact.

read-only

Argument	Type	Description
locale	string	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.
policy*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "policy"
  ],
  "properties": {
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    },
    "policy": {
      "enum": [
        "delivery",
        "returns",
        "payment-options",
        "faqs",
        "contact"
      ],
      "type": "string"
    }
  }
}

get_prices_for_country

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.

read-only

Argument	Type	Description
items*	array	Basket lines as product ids with quantities.
locale	string	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.
shipping_country*	string	ISO 3166-1 alpha-2 country code, e.g. GB, IE, DE, US.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "shipping_country",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "maximum": 9007199254740991,
            "description": "Product id from search/product tools.",
            "exclusiveMinimum": 0
          },
          "quantity": {
            "type": "integer",
            "default": 1,
            "maximum": 999,
            "minimum": 1
          }
        }
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Basket lines as product ids with quantities."
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    },
    "shipping_country": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "ISO 3166-1 alpha-2 country code, e.g. GB, IE, DE, US."
    }
  }
}

get_product

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.

read-only

Argument	Type	Description
id	integer	Numeric product id.
sku	string	Product SKU.
slug	string	Product slug from a product URL (…/product/<slug>).
locale	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Numeric product id.",
      "exclusiveMinimum": 0
    },
    "sku": {
      "type": "string",
      "maxLength": 64,
      "description": "Product SKU."
    },
    "slug": {
      "type": "string",
      "maxLength": 200,
      "description": "Product slug from a product URL (…/product/<slug>)."
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    }
  }
}

get_product_documents

Safety data sheets, specification sheets and COSHH hazard codes for a product (by slug or SKU). Returns document URLs.

read-only

Argument	Type	Description
sku	string	Product SKU.
slug	string	Product slug from a product URL (…/product/<slug>).
locale	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "sku": {
      "type": "string",
      "maxLength": 64,
      "description": "Product SKU."
    },
    "slug": {
      "type": "string",
      "maxLength": 200,
      "description": "Product slug from a product URL (…/product/<slug>)."
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    }
  }
}

get_product_promotions

Active promotions that apply to one SKU (discounts, free gifts, end dates).

read-only

Argument	Type	Description
sku*	string	Product SKU exactly as shown on the site.
locale	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "sku"
  ],
  "properties": {
    "sku": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product SKU exactly as shown on the site."
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    }
  }
}

get_products

Look up up to 50 products at once by SKU or by numeric id. Returns compact products (name, price ex/inc VAT, stock, link).

read-only

Argument	Type	Description
ids	array
skus	array
locale	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "exclusiveMinimum": 0
      },
      "maxItems": 50,
      "minItems": 1
    },
    "skus": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64,
        "minLength": 1,
        "description": "Product SKU exactly as shown on the site."
      },
      "maxItems": 50,
      "minItems": 1
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    }
  }
}

get_related_products

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.

read-only

Argument	Type	Description
sku	string	Product SKU.
slug	string	Product slug from a product URL (…/product/<slug>).
locale	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "sku": {
      "type": "string",
      "maxLength": 64,
      "description": "Product SKU."
    },
    "slug": {
      "type": "string",
      "maxLength": 200,
      "description": "Product slug from a product URL (…/product/<slug>)."
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    }
  }
}

get_site_info

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.

read-only

Argument	Type	Description
locale	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    }
  }
}

get_stock_level

Live availability check for a SKU (is it available now and how many are in the London warehouse).

read-only

Argument	Type	Description
sku*	string	Product SKU exactly as shown on the site.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "sku"
  ],
  "properties": {
    "sku": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product SKU exactly as shown on the site."
    }
  }
}

list_brands

Brands sold by Camden Tools (DeWalt, Makita, Milwaukee, Bosch, Stanley …). Without a query returns the popular brands; with a query searches brand names.

read-only

Argument	Type	Description
page	integer	Page number, starting at 1.
sort	string	Sort order: price_low, price_high, name_asc, name_desc or newest. Omit for the default (most popular) order.
query	string	Brand name search text.
per_page	integer	Results per page: 15, 30, 50 or 100 (default 15).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Page number, starting at 1."
    },
    "sort": {
      "type": "string",
      "maxLength": 40,
      "description": "Sort order: price_low, price_high, name_asc, name_desc or newest. Omit for the default (most popular) order."
    },
    "query": {
      "type": "string",
      "maxLength": 80,
      "description": "Brand name search text."
    },
    "per_page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Results per page: 15, 30, 50 or 100 (default 15)."
    }
  }
}

list_bundles

Curated product bundles (kits) with their items and prices.

read-only

Argument	Type	Description
locale	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    }
  }
}

list_categories

Product categories with slugs and links. Use popular_only for the curated set shown on the site; otherwise the full list.

read-only

Argument	Type	Description
limit	integer	Maximum categories to return (default 100).
locale	string	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.
popular_only	boolean	Only the popular categories (default false).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum categories to return (default 100)."
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    },
    "popular_only": {
      "type": "boolean",
      "description": "Only the popular categories (default false)."
    }
  }
}

list_offers

Current storefront promotions (percentage/fixed discounts and free gifts), optionally grouped by brand or category. Also points at the /offers page.

read-only

Argument	Type	Description
locale	string	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.
group_by	string	Grouping (default all).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "locale": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "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."
    },
    "group_by": {
      "enum": [
        "all",
        "brand",
        "category"
      ],
      "type": "string",
      "description": "Grouping (default all)."
    }
  }
}

list_products

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.

read-only

Argument	Type	Description
page	integer	Page number, starting at 1.
sort	string	Sort order: price_low, price_high, name_asc, name_desc or newest. Omit for the default (most popular) order.
brand	string	Brand slug to filter by.
locale	string	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.
per_page	integer	Results per page: 15, 30, 50 or 100 (default 15).
max_price	number	Maximum price in the locale currency.
min_price	number	Minimum price in the locale currency.
collection*	string	Which collection to list.
min_discount

lookup_uk_postcode

Addresses for a UK postcode (rate limited upstream). Returns matching addresses or suggestions when the postcode is incomplete.

read-only

Argument	Type	Description
postcode*	string	UK postcode, e.g. NW2 7JW.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "postcode"
  ],
  "properties": {
    "postcode": {
      "type": "string",
      "maxLength": 12,
      "minLength": 2,
      "description": "UK postcode, e.g. NW2 7JW."
    }
  }
}

search_blog_posts

Guides and articles from the Camden Tools blog (how-tos, buying guides, brand news).

read-only

Argument	Type	Description
page	integer	Page number, starting at 1.
query	string	Search text; omit for the latest posts.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Page number, starting at 1."
    },
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Search text; omit for the latest posts."
    }
  }
}

search_products

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.

read-only

Argument	Type	Description
page	integer	Page number, starting at 1.
sort	string	Sort order: price_low, price_high, name_asc, name_desc or newest. Omit for the default (most popular) order.
brand	string	Brand slug to filter by.
query*	string	What the shopper is looking for, e.g. 'cordless combi drill 18v'.
locale	string	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.
express	boolean	Only products eligible for Website Express same-day dispatch (UK).
per_page	integer	Results per page: 15, 30, 50 or 100 (default 15).
max_price	number	Maximum price in the locale currency.

track_guest_order

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).

read-only

Argument	Type	Description
postcode*	string	Delivery postcode / ZIP on the order.
order_number*	string	Order number from the confirmation email.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "order_number",
    "postcode"
  ],
  "properties": {
    "postcode": {
      "type": "string",
      "maxLength": 20,
      "minLength": 2,
      "description": "Delivery postcode / ZIP on the order."
    },
    "order_number": {
      "type": "string",
      "maxLength": 40,
      "minLength": 3,
      "description": "Order number from the confirmation email."
    }
  }
}