Shop Camden Tools with your AI assistant
What your assistant can do here
Find and compare
Search the whole catalogue, open full product details and compare up to five products side by side.
Live prices
Prices ex and inc VAT with bulk breaks and sale prices, in your currency.
Stock right now
Warehouse availability checked live, so nothing is recommended that cannot ship.
Delivery and Website Express
Shipping to your country, delivery estimates and whether same-day dispatch is still open.
Offers and bundles
Current promotions, free gifts and curated kits, plus which offers apply to a basket.
Track orders
Any order by number and postcode; your own order history in the browser after you allow it.
Policies and help
Delivery, returns, payment options, FAQs, the London collection point and the blog.
A basket, ready to pay
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.
Connect your assistant
- Open Camden Tools in the Claude connectors directory.
- Choose Connect. No sign-in is needed.
- Enable the connector in a chat and ask about any product.
Or add it by hand: Customize → Connectors → Add custom connector, paste the server URL and choose No sign-in.
- Settings → Security and login → turn on Developer mode.
- Settings → Plugins (Apps & Connectors) → + → name Camden Tools, paste the server URL, no authentication.
- In a chat, enable Camden Tools under Tools and ask away. Purchases finish on camdentools.com.
- Perplexity for Mac → Settings → Connectors → Add custom connector.
- Paste the server URL and save.
- Or simply ask Perplexity about Camden Tools products: it reads the site directly.
- Gemini Spark → Connected apps → Add → paste the server URL.
- Consumer Gemini has no custom connectors yet; ask it about Camden Tools products and it will use the site’s public pages.
Google’s shopping agents will use the Merchant Center feed when the Universal Commerce Protocol reaches the UK.
- Copilot Studio (Microsoft 365): add the server URL as an MCP connector for your agents.
- Shopping inside Copilot arrives through Stripe’s agentic commerce programme; the catalogue tools already work from any MCP-capable client.
- Nothing to install: every page on camdentools.com registers its tools with the browser.
- Chrome runs WebMCP on camdentools.com as an origin trial, so there is no flag to enable in versions that support it; use an agent that speaks WebMCP. Other agent browsers read the page directly.
- The agent can fill your basket, switch VAT display and pre-fill checkout; you see a notice for every action and pay yourself.
Add a second connector with the account URL below. Your assistant will ask you to sign in to Camden Tools once; it can then read your profile and order history (never place orders or pay). Disconnect it at any time from your account page.
- Claude: Add custom connector → paste the account URL → Save. ChatGPT (Developer mode): add the account URL with OAuth.
- Your browser opens camdentools.com/connect: sign in there, check the assistant's name and return address, and allow the profile and orders permissions.
- Ask “show my recent Camden Tools orders” or “where is my order CT-…”.
Buying with an assistant
- Research: search, compare, read the specification sheets and safety documents.
- Check the practical bits: stock, delivery to your address, Website Express cutoff, offers that apply.
- Prepare the basket: hand you a link that fills it, or add items in the page when it runs in your browser.
- Track an order with its number and postcode, and read your order history in the browser once you allow it.
- Pay or place an order: checkout is always yours, on Stripe-hosted payment.
- Log in, register or change your details on your behalf.
- See card details: the tools never handle payment data.
- Read your account from outside your browser: account tools are not offered to remote clients.
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.
Things to ask
“On camdentools.com, compare the DeWalt DCD796 and the Makita DHP485: price inc VAT, weight, and which one is in stock. Search the web for site:camdentools.com DeWalt DCD796 and site:camdentools.com Makita DHP485. Use only camdentools.com for this, not other shops.”
“Can camdentools.com deliver a Makita DHP485 to Dublin, what would it cost and how long would it take? Search the web for site:camdentools.com Makita DHP485; delivery rules: https://camdentools.com/deliveries Use only camdentools.com for this, not other shops.”
“Track my camdentools.com order CT-102938, delivery postcode NW2 7JW. (Needs the Camden Tools connector; without it, use the track order page on camdentools.com.)”
“Find a grab adhesive on camdentools.com and give me its safety data sheet and COSHH hazard codes. Search the web for site:camdentools.com grab adhesive. Use only camdentools.com for this, not other shops.”
“Is Website Express same-day dispatch available on camdentools.com right now, and what is the cutoff? (Needs the Camden Tools connector; without it, see the deliveries page on camdentools.com.)”
“Build me a camdentools.com 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. With the Camden Tools connector, give me one basket link; without it, search the web with site:camdentools.com and list the product pages. Use only camdentools.com for this, not other shops.”
For developers and agents
Description
Endpoints and discovery documents
- MCP server
POST JSON-RPC 2.0 (Streamable HTTP, stateless, JSON responses): initialize, ping, tools/*, resources/*, prompts/*.
- MCP server (account)
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.
- A2A agent
POST JSON-RPC: SendMessage (message/send), GetTask, CancelTask. Deterministic shopping skills.
- Plain GET for assistants
For assistants with no connector: /api/agent/search?q=, /api/agent/product/{slug} and /api/agent/basket?items=id:qty answer Markdown (format=json for JSON) with live prices, stock and basket links.
- Capabilities catalogue
This document: tools by category with JSON Schema inputs, resources, prompts, skills, in-page tools, changelog.
- MCP server card
Server identity, endpoint and capabilities.
- A2A agent card
A2A v1.0 card with skills.
- API catalog
RFC 9727 linkset.
- OpenAPI
OpenAPI 3.1 for the public endpoints.
- Agent skills
Agent Skills discovery index and the generated SKILL.md.
- ai-catalog
ARD capability manifest.
- Key directory
Web Bot Auth: Ed25519 public keys that verify requests signed by Camden Tools.
- ACP discovery
Agentic Commerce Protocol discovery document; 404 until agentic checkout is enabled.
- OAuth protected resource
RFC 9728 metadata for the account endpoint (authorization server, scopes); 404 until OAuth is enabled.
- auth.md
Authentication and registration rules for agents.
- llms.txt
Site overview for language models; llms-full.txt adds policies and the tool catalogue.
Connect any MCP client
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.
Server URL
https://camdentools.com/mcpMCP Inspector
npx @modelcontextprotocol/inspector --transport http --server-url https://camdentools.com/mcpcurl
curl -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":{}}'A2A
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"}]}}}'No connector? Plain URLs
Most conversations have no connector installed, and a browsing tool can only open URLs. These answer compact Markdown with the same live prices, stock and basket links as the tools; add format=json for JSON. Claude and Perplexity open them from a prompt. ChatGPT only opens URLs that OpenAI's web index already knows, so in a ChatGPT prompt name camdentools.com and ask for a site:camdentools.com search, or give it a product page URL without tracking parameters.
- Guide
https://camdentools.com/api/agentThe instructions below as a page an assistant can open.
- Search
https://camdentools.com/api/agent/search?q=cordless+combi+drillProducts with price inc and ex VAT, stock, id, links and a ready basket link for each in-stock product. Optional: page, locale.
- One product
https://camdentools.com/api/agent/product/<slug>The slug is the last part of a product page URL. Specifications, variants, quantity prices and documents.
- Basket link
https://camdentools.com/api/agent/basket?items=<id>:<quantity>,<id>:<quantity>Checks stock and answers one link that fills the shopper's basket. Nothing is bought: the shopper pays on the site.
Tools by category (32)
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 (tools and hardware, electrical, cleaning, household, garden, safety and more). Returns compact products with prices ex/inc VAT, stock and a link. Out-of-stock products are left out unless include_out_of_stock is true. 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). include_out_of_stock boolean Also return out-of-stock products, which search leaves out by default. Use it when the shopper wants a specific model that may be sold out. 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': a category (leaf) slug from list_categories. 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: whether it can be bought now and how many units can be ordered. Fresher than the stock_level on product results, which can be hours old.
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, shipping 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 categoriesThe category tree: departments, the groups inside them, and the categories (leaves) that hold products. With no department, lists every department and its groups; with a department or group slug, lists what is inside it. Use popular_only for the popular categories shown on the site. Browse a category's products with get_category or list_products.
Parameter Type Description department string A department or group slug from an earlier list_categories call, to list what is inside it. popular_only boolean Only the popular categories (default false). limit integer Maximum entries to return (default 200). 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 details and its products (paged) by slug. For a department or group slug, returns what is inside it instead, since only categories hold products.
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 full UK postcode such as NW2 7JW (rate limited upstream). A partial postcode (only the outward part, e.g. NW2) is refused.
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.
Resources
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).
Prompts
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:skus
A2A skills
POST 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 delivery
In-browser tools (WebMCP) (15)
Every page on camdentools.com registers these tools with the browser through the WebMCP API (document.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 access
Security and privacy
- Public tools need no credentials. Requests are rate limited per client; a 429 means wait and retry.
- Browser calls: only same-origin pages can use the shopper’s session; cross-origin browser requests to the endpoints are refused.
- Account tools run only after the shopper allows AI agent access (30 days, revocable on the account page) and are never offered to remote clients.
- No card data, no payments: checkout is completed by the shopper on Stripe-hosted payment.
- Links carry utm_source=ai-agent, utm_medium (channel), utm_campaign (client) and utm_content (tool); keep them intact.
- Bodies over 64 KB are rejected; the MCP endpoint is stateless and answers with JSON, never streams.
- Remote account access uses OAuth 2.1 (authorization code with PKCE) issued by the Camden Tools authorization server; /mcp/account answers 401 with an RFC 9728 resource_metadata challenge, tokens are validated for issuer, audience, expiry and scope, and are never logged. https://camdentools.com/.well-known/oauth-protected-resource/mcp/account
Identity (Web Bot Auth)
Requests sent by Camden Tools’ own agent layer are signed with Ed25519 HTTP message signatures. Verify them against the public keys in the key directory.
- https://camdentools.com/.well-known/http-message-signatures-directory
- Key id:
iVuMkdK3A8DRGTiIkpemeEDzvwhDUm3Qo8frb5p_DCU
Agentic checkout (ACP)
Not 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.
Changelog
- v1.8.0
Categories follow the site's new category tree (department, group, category). list_categories lists departments and groups, or with department set, what is inside one; each entry has a level, and only level category holds products. get_category on a department or group returns what is inside it, and category links point at the new /category/{department}/{group}/{category} pages. Categories with no products are left out of lists. A slug from the old tree is followed to the category that replaced it, and an unknown slug says to call list_categories. WebMCP page_navigate and llms.txt use the new pages too.
- v1.7.0
Every MCP tool result now carries its full payload as JSON text after the summary, so clients that only pass text content to the model (and not structuredContent) see the products, prices and stock, not just counts. search_products leaves out-of-stock products out by default; pass include_out_of_stock to include them. list_products on-sale adds source: 'discount', 'promotion' (nothing is discounted, so products in active promotions are listed at their normal price) or 'none'. weight_kg is labelled as the shipping weight. The payment policy adds Discover and Klarna to the methods accepted everywhere.
- v1.6.0
Fixes from an end-to-end test of every tool. Policy text (get_policy, get_site_info and the policy resources) puts each heading before its own text, pairs every FAQ question with its answer, and no longer shows internal labels or placeholders; delivery lists the countries served and the payment policy names every method. An unknown SKU no longer fails get_product, get_products or compare_products: the others are returned and the unknown one is reported as not found. get_stock_level adds stock_level, the units that can be ordered now (warehouse_quantity is 0 for items shipped from a supplier). get_brand_products prices include VAT. list_bundles names bundles instead of returning translation keys, and check_shipping_availability explains a refused country in words. Clearer errors for an unknown brand slug and a partial UK postcode. Blog posts show featured products as SKUs. Product results list at most 8 categories.
- v1.5.1
Every tool states readOnlyHint, destructiveHint and openWorldHint explicitly, as OpenAI's app directory requires. None is destructive: every tool is read-only. No other tool changes.
- v1.5.0
Every tool declares an outputSchema describing its structured result, and each result is checked against it before it is sent. compare_products reports weight_kg in kilograms (it was grams). list_products returns its category in the same shape as get_category, check_express_eligibility's express block has fixed fields, and prices, totals and discount values are always numbers.
- v1.4.1
The server description and instructions now cover international delivery: orders typically arrive in 2–7 days, with premium UPS services (Worldwide Saver, Express, Express Plus). Agents are asked to quote estimate_delivery's services and transit times for an address rather than the general range. No tool changes.
- v1.4.0
The MCP endpoints also speak the stateless 2026-07-28 revision: server/discover, per-request protocol version in _meta with the MCP-Protocol-Version, Mcp-Method and Mcp-Name headers, resultType on every result and cache hints on list and read results. Clients using initialize keep the 2025 revisions. New discovery documents: /.well-known/agents.json (every agent endpoint) and /.well-known/oauth-authorization-server (the authorization server's metadata, mirrored on this origin). In-page tools use document.modelContext, and the newsletter form on the homepage is a declarative WebMCP tool (newsletter_subscribe) that fills in the email and leaves consent and submitting to the shopper.
- v1.3.0
The shop over plain GET, for assistants with no connector installed: /api/agent (guide), /api/agent/search?q=, /api/agent/product/{slug} and /api/agent/basket?items=id:qty answer compact Markdown (or JSON) with the same live prices, stock and basket links as the MCP tools. llms.txt now opens with these instructions, and they are in SKILL.md and the OpenAPI document.
- v1.2.0
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.
- v1.1.0
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).
- v1.0.0
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).
Machine-readable documents
Building something with Camden Tools?
Partnerships, higher rate limits and commercial integrations: get in touch.