Search the whole catalogue, open full product details and compare up to five products side by side.
Prices ex and inc VAT with bulk breaks and sale prices, in your currency.
Warehouse availability checked live, so nothing is recommended that cannot ship.
Shipping to your country, delivery estimates and whether same-day dispatch is still open.
Current promotions, free gifts and curated kits, plus which offers apply to a basket.
Any order by number and postcode; your own order history in the browser after you allow it.
Delivery, returns, payment options, FAQs, the London collection point and the blog.
Get one link that fills your basket, or let a browser agent do it on the page. Opening a link twice never doubles your order, and you always pay yourself.
Googleโs shopping agents will use the Merchant Center feed when the Universal Commerce Protocol reaches the UK.
Signing in to your account from an assistant is planned. Today, account tools (your profile and orders) work when an agent runs in your own browser on camdentools.com and you allow AI agent access on your account page.
Checkout inside assistants (Microsoft Copilot, Google shopping agents and others) is arriving through Stripeโs agentic commerce programme. Until it is switched on, every purchase finishes on camdentools.com.
โCompare the DeWalt DCD796 and the Makita DHP485 at Camden Tools: price inc VAT, weight, and which one is in stock.โ
โCan Camden Tools deliver a Makita DHP485 to Dublin, what would it cost and how long would it take?โ
โTrack my Camden Tools order CT-102938, delivery postcode NW2 7JW.โ
โGet the safety data sheet and COSHH hazard codes for the adhesive you just found me at Camden Tools.โ
โIs Website Express same-day dispatch available at Camden Tools right now, and what is the cutoff?โ
โBuild me a Camden Tools basket with an 18V combi drill, a set of masonry bits and a pack of 40 mm wall plugs, and give me the link to check out.โ
The machine-readable side: endpoints, every tool with its input schema, resources, prompts, skills and the rules of the road. This reference is generated from the server itself.
POST JSON-RPC 2.0 (Streamable HTTP, stateless, JSON responses): initialize, ping, tools/*, resources/*, prompts/*.
Same server with an OAuth bearer token: the account tools become available. Answers 401 with a WWW-Authenticate challenge that starts sign-in; 404 until OAuth is enabled.
POST JSON-RPC: SendMessage (message/send), GetTask, CancelTask. Deterministic shopping skills.
This document: tools by category with JSON Schema inputs, resources, prompts, skills, in-page tools, changelog.
Server identity, endpoint and capabilities.
A2A v1.0 card with skills.
RFC 9727 linkset.
OpenAPI 3.1 for the public endpoints.
Agent Skills discovery index and the generated SKILL.md.
ARD capability manifest.
Web Bot Auth: Ed25519 public keys that verify requests signed by Camden Tools.
Agentic Commerce Protocol discovery document; 404 until agentic checkout is enabled.
RFC 9728 metadata for the account endpoint (authorization server, scopes); 404 until OAuth is enabled.
Authentication and registration rules for agents.
Site overview for language models; llms-full.txt adds policies and the tool catalogue.
Streamable HTTP, stateless, JSON responses. Paste the server URL as a remote MCP server; no authentication for the public tools. Browser GETs of the endpoint land on this page.
https://camdentools.com/mcpnpx @modelcontextprotocol/inspector --transport http --server-url https://camdentools.com/mcpcurl -s https://camdentools.com/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'curl -s https://camdentools.com/a2a -H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{"messageId":"m1","role":"ROLE_USER","parts":[{"text":"cordless drill"}]}}}'Every tool returns a short text summary plus structured JSON, and every link carries attribution parameters. Prices come back both ex and inc VAT. Browser-session tools are only offered to same-origin calls from the shopperโs own browser.
Search and browse products, full product details, live stock, side-by-side comparisons, documents, categories and brands.
search_productsSearch productsFull-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.
| Parameter | Type | Description |
|---|---|---|
| query (required) | string | What the shopper is looking for, e.g. 'cordless combi drill 18v'. |
| express | boolean | Only products eligible for Website Express same-day dispatch (UK). |
| page | integer | Page number, starting at 1. |
| per_page | integer | Results per page: 15, 30, 50 or 100 (default 15). |
| 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. |
| min_price | number | Minimum price in the locale currency. |
| max_price | number | Maximum price in the locale currency. |
| 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. |
list_productsList productsBrowse 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.
| Parameter | Type | Description |
|---|---|---|
| collection (required) | popular | new | on-sale | express | category | Which collection to list. |
| category_slug | string | Required when collection is 'category'. |
| min_discount | number | Minimum discount percentage (on-sale listings). |
| page | integer | Page number, starting at 1. |
| per_page | integer | Results per page: 15, 30, 50 or 100 (default 15). |
| 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. |
| min_price | number | Minimum price in the locale currency. |
| max_price | number | Maximum price in the locale currency. |
| 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. |
get_productGet productFull 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.
| Parameter | Type | Description |
|---|---|---|
| slug | string | Product slug from a product URL (โฆ/product/<slug>). |
| sku | string | Product SKU. |
| id | integer | Numeric product id. |
| 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. |
get_productsGet several productsLook up up to 50 products at once by SKU or by numeric id. Returns compact products (name, price ex/inc VAT, stock, link).
| Parameter | Type | Description |
|---|---|---|
| skus | array of string | |
| ids | array of integer | |
| 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. |
get_stock_levelGet stock levelLive availability check for a SKU (is it available now and how many are in the London warehouse).
| Parameter | Type | Description |
|---|---|---|
| sku (required) | string | Product SKU exactly as shown on the site. |
compare_productsCompare productsSide-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.
| Parameter | Type | Description |
|---|---|---|
| skus (required) | array of 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. |
get_product_documentsGet product documentsSafety data sheets, specification sheets and COSHH hazard codes for a product (by slug or SKU). Returns document URLs.
| Parameter | Type | Description |
|---|---|---|
| slug | string | Product slug from a product URL (โฆ/product/<slug>). |
| sku | string | Product SKU. |
| 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. |
list_categoriesList categoriesProduct categories with slugs and links. Use popular_only for the curated set shown on the site; otherwise the full list.
| Parameter | Type | Description |
|---|---|---|
| popular_only | boolean | Only the popular categories (default false). |
| 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. |
get_categoryGet categoryA category's name, description and its products (paged) by category slug.
| Parameter | Type | Description |
|---|---|---|
| slug (required) | string | Category slug from list_categories. |
| page | integer | Page number, starting at 1. |
| per_page | integer | Results per page: 15, 30, 50 or 100 (default 15). |
| 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. |
list_brandsList brandsBrands sold by Camden Tools (DeWalt, Makita, Milwaukee, Bosch, Stanley โฆ). Without a query returns the popular brands; with a query searches brand names.
| Parameter | Type | Description |
|---|---|---|
| query | string | Brand name search text. |
| page | integer | Page number, starting at 1. |
| per_page | integer | Results per page: 15, 30, 50 or 100 (default 15). |
| sort | string | Sort order: price_low, price_high, name_asc, name_desc or newest. Omit for the default (most popular) order. |
get_brand_productsGet brand productsA brand's details, its active promotions and its products (paged) by brand slug.
| Parameter | Type | Description |
|---|---|---|
| slug (required) | string | Brand slug from list_brands. |
| page | integer | Page number, starting at 1. |
| per_page | integer | Results per page: 15, 30, 50 or 100 (default 15). |
| 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. |
Current promotions, per-product deals, curated bundles and basket-level promotion checks.
list_offersList offersCurrent storefront promotions (percentage/fixed discounts and free gifts), optionally grouped by brand or category. Also points at the /offers page.
| Parameter | Type | Description |
|---|---|---|
| group_by | all | brand | category | Grouping (default all). |
| 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. |
get_product_promotionsGet product promotionsActive promotions that apply to one SKU (discounts, free gifts, end dates).
| Parameter | Type | Description |
|---|---|---|
| sku (required) | 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. |
list_bundlesList bundlesCurated product bundles (kits) with their items and prices.
| Parameter | 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. |
get_cart_promotionsGet basket promotionsEvaluate 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.
| Parameter | Type | Description |
|---|---|---|
| country_code (required) | string | Destination country (ISO alpha-2). |
| items (required) | array of object { id, quantity } | Basket lines as product ids with quantities. |
| has_tax_id | boolean | Whether the buyer has a VAT/tax id (business purchase). |
| 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. |
Website Express same-day dispatch, shipping availability by country, country pricing, delivery estimates and UK postcode lookup.
get_express_delivery_statusGet Website Express statusWhether Website Express (free same-working-day dispatch for eligible UK orders) is available right now, the order-by cutoff and the promised dispatch date.
| Parameter | 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. |
check_express_eligibilityCheck Website Express eligibilityWhole-basket Website Express verdict for a set of product ids and quantities: every line must be eligible (no split shipments).
| Parameter | Type | Description |
|---|---|---|
| items (required) | array of object { id, quantity } | 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. |
check_shipping_availabilityCheck shipping availabilityWhether Camden Tools ships to a country, with any restriction message.
| Parameter | Type | Description |
|---|---|---|
| country_code (required) | string | ISO 3166-1 alpha-2 country code, e.g. GB, IE, DE, US. |
| 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. |
get_prices_for_countryGet prices for a countryCountry-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.
| Parameter | Type | Description |
|---|---|---|
| shipping_country (required) | string | ISO 3166-1 alpha-2 country code, e.g. GB, IE, DE, US. |
| items (required) | array of object { id, quantity } | 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. |
estimate_deliveryEstimate deliveryDelivery 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.
| Parameter | Type | Description |
|---|---|---|
| country_code (required) | string | ISO 3166-1 alpha-2 country code, e.g. GB, IE, DE, US. |
| postcode | string | Destination postcode / ZIP. |
| city | string | Destination city. |
| items (required) | array of object { id, quantity } | 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. |
lookup_uk_postcodeLook up a UK postcodeAddresses for a UK postcode (rate limited upstream). Returns matching addresses or suggestions when the postcode is incomplete.
| Parameter | Type | Description |
|---|---|---|
| postcode (required) | string | UK postcode, e.g. NW2 7JW. |
Prepare a basket the shopper opens on the site, reviews and pays for at checkout.
create_basket_linkCreate a basket linkTurn 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.
| Parameter | Type | Description |
|---|---|---|
| items (required) | array of object { id, quantity } | 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. |
Track any order with its order number and delivery postcode.
track_guest_orderTrack an orderOrder status, tracking number/URL, shipping method and line items for any order, given the order number and the delivery postcode (no sign-in needed).
| Parameter | Type | Description |
|---|---|---|
| order_number (required) | string | Order number from the confirmation email. |
| postcode (required) | string | Delivery postcode / ZIP on the order. |
The signed-in shopper's profile and order history. Only from the shopper's own browser on camdentools.com, after they allow AI agent access.
get_my_profileGet my profilebrowser sessionThe signed-in shopper's name, email and saved addresses. Needs the shopper's browser session with AI agent access, or an OAuth token with the profile:read scope.
No parameters.
list_my_ordersList my ordersbrowser sessionThe signed-in shopper's order history (most recent first). Needs the shopper's browser session with AI agent access, or an OAuth token with the orders:read scope.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
get_my_orderGet my orderbrowser sessionOne of the signed-in shopper's orders by order number, with status, tracking and line items. Needs the shopper's browser session with AI agent access, or an OAuth token with the orders:read scope.
| Parameter | Type | Description |
|---|---|---|
| order_number (required) | string |
Store facts, policies, the London collection point and the blog.
get_site_infoGet store informationWho 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.
| Parameter | 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. |
get_policyGet policy textFull text (markdown) of a store policy: delivery, returns, payment-options, faqs or contact.
| Parameter | Type | Description |
|---|---|---|
| policy (required) | delivery | returns | payment-options | faqs | contact | |
| 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. |
get_collection_point_infoGet collection point infoThe London Click & Collect warehouse: address, opening hours, whether it is open right now (Europe/London, bank holidays respected) and when it next opens.
No parameters.
search_blog_postsSearch blog postsGuides and articles from the Camden Tools blog (how-tos, buying guides, brand news).
| Parameter | Type | Description |
|---|---|---|
| query | string | Search text; omit for the latest posts. |
| page | integer | Page number, starting at 1. |
get_blog_postGet blog postA blog post's full text (plain text) by slug.
| Parameter | Type | Description |
|---|---|---|
| slug (required) | 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. |
camdentools://policies/delivery โ Camden Tools delivery policy as markdown.camdentools://policies/returns โ Camden Tools returns policy as markdown.camdentools://policies/payment-options โ Camden Tools payment options policy as markdown.camdentools://policies/faqs โ Camden Tools faqs policy as markdown.camdentools://policies/contact โ Camden Tools contact policy as markdown.camdentools://store/facts โ Company details, contact points, collection point and VAT display rules.camdentools://llms.txt โ Site overview for language models (same content as https://camdentools.com/llms.txt).find_the_right_tool โ Help a shopper choose a product for a task, within a budget and brand preference, and hand them a basket link.Arguments: task, budget?, brand?check_delivery โ Work out delivery options, cost and timing for a basket to a destination.Arguments: country_code, postcode?compare โ Compare a few SKUs side by side and recommend one.Arguments: skusPOST a JSON-RPC SendMessage to the A2A endpoint with plain text or a JSON part carrying a skill id. Every message is answered synchronously; there are no tasks to poll.
search-products โ Find tools and equipment in the Camden Tools catalogue with prices, stock and links.Example: cordless combi drill 18vproduct-lookup โ Full details for a product by SKU or slug: price ex/inc VAT, stock, variants, documents.Example: {"skill":"product-lookup","sku":"DCD796P2"}compare-products โ Side-by-side comparison of two to five SKUs.Example: DCD796P2, DHP485Z, M18FPD2create-basket โ Turn product ids and quantities into a link that fills the shopper's basket on camdentools.com; they review it and pay at checkout.Example: {"skill":"create-basket","items":[{"id":27155,"quantity":2},{"id":4410,"quantity":1}]}order-status โ Track an order with its order number and delivery postcode.Example: order CT-102938 postcode NW2 7JWshipping-availability โ Whether Camden Tools ships to a country (ISO alpha-2 code).Example: IEexpress-delivery-status โ Whether same-working-day dispatch is available right now for UK orders.Example: express deliveryEvery page on camdentools.com registers these tools with the browser through the WebMCP API (navigator.modelContext). They act on the shopperโs own basket and page, show a notice for every action, and account access needs the shopperโs explicit consent.
cart_getGet basketcart_add_itemAdd to basketcart_update_itemUpdate basket linecart_remove_itemRemove from basketcart_clearEmpty basketcart_apply_promoApply promo codecart_remove_promoRemove promo codewishlist_addAdd to wishlistwishlist_removeRemove from wishlistpage_get_contextGet page contextpage_navigateNavigatepage_set_vat_displaySet VAT displaypage_select_variantSelect variantproduct pagepage_prefill_checkout_addressPre-fill checkout addresscheckout pagepage_request_account_accessRequest account accessRequests sent by Camden Toolsโ own agent layer are signed with Ed25519 HTTP message signatures. Verify them against the public keys in the key directory.
iVuMkdK3A8DRGTiIkpemeEDzvwhDUm3Qo8frb5p_DCUNot enabled yet The ACP discovery document returns 404 until agentic checkout through Stripe is switched on. Until then, finish with a basket link and the shopper pays on the site.
OAuth-ready account access for remote clients: POST /mcp/account with RFC 9728 protected resource metadata and a WWW-Authenticate challenge, account tools gated by the profile:read and orders:read scopes, and a generated /auth.md. The shopper signs in and approves the client on camdentools.com/connect; a grant that lacks a scope is reported as such (reconnect and approve it) rather than as a sign-in problem. Served once the Camden Tools authorization server is configured; until then the endpoint and its metadata return 404. create_basket_link now reports stock per line and lists out_of_stock_ids, and its link is idempotent: opening it makes sure the basket holds at least those quantities, so opening it twice never doubles them. Revoked or disconnected access tokens get the 401 invalid_token challenge.
New create_basket_link tool and A2A create-basket skill: one link fills the shopper's basket on the site (/cart?add=id:qty). Account tools are no longer advertised to remote clients that cannot use them. Capabilities catalogue at /api/agent-capabilities; SKILL.md, OpenAPI and llms-full.txt are generated from it. Web Bot Auth key directory. ACP discovery document (served once agentic checkout is enabled).
Launch: MCP server with 31 tools, 7 resources and 3 prompts; A2A agent with 6 skills; in-page WebMCP tools for the basket, wishlist, navigation, VAT display, variants, checkout prefill and account consent; discovery documents (API catalog, MCP server card, A2A agent card, OpenAPI, agent skills, ai-catalog, auth.md, llms.txt, llms-full.txt).
Partnerships, higher rate limits and commercial integrations: get in touch.