Skip to main content
Glama

Camden Tools

by com.camdentools
OverviewDiscussionsAdmin

Search products

search_products
Read-only

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.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
pageNoPage number, starting at 1.
sortNoSort order: price_low, price_high, name_asc, name_desc or newest. Omit for the default (most popular) order.
brandNoBrand slug to filter by.
queryYesWhat the shopper is looking for, e.g. 'cordless combi drill 18v'.
localeNoStorefront locale such as en-GB (default), en-US, de, fr-FR, es-ES, it-IT, nl-NL, pl. Controls product names, slugs and prices.
expressNoOnly products eligible for Website Express same-day dispatch (UK).
per_pageNoResults per page: 15, 30, 50 or 100 (default 15).
max_priceNoMaximum price in the locale currency.
min_priceNoMinimum price in the locale currency.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
queryYes
productsYes
paginationYes
search_urlYesThe same search on camdentools.com.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "$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"
+}
  2. First observed

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare the tool safe (readOnlyHint, destructiveHint false), so the description only needs to add behavioral context. It does this by noting results are 'compact products' with prices ex/inc VAT, stock, and a link, which tells the agent the response is not full product detail and that follow-up calls to get_product may be useful.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences with no filler: the first states what the tool searches, the second describes the return payload, and the third gives the essential parameter usage. The most important information is front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the rich input schema and the presence of an output schema, the description is complete enough: it orients the agent to catalogue scope, result compactness, and key filters. A minor gap is that it does not explicitly point to get_product for full product details, but that is not required for invoking this tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with each of the 9 parameters already documented. The description adds a useful grouping of page/per_page and brand/min_price/max_price as the main controls, but it does not introduce meaning beyond the schema, so the baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with 'Full-text search of the Camden Tools catalogue' and enumerates product categories, making the action and resource explicit. This clearly distinguishes it from listing-oriented siblings like list_products and get_products, which do not imply free-text search.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives clear usage context by framing the tool as full-text search and then tells the agent how to paginate and narrow results with page/per_page and brand/min_price/max_price. It stops short of an explicit when-not or alternative-tool routing, so it does not earn a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Camden Tools toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources