Caddence

Get retailer offers for a product

get_product_offers

Read-onlyIdempotent

Current UK retailer offers for one product, in-stock first then cheapest, with variant details (shaft, flex, hand, loft, condition). The summary object always gives the cheapest in-stock new offer and the cheapest in-stock used offer, with counts, whatever condition is requested. Used means every second-hand condition (used, refurbished, ex-display); each offer still states its own condition. Set condition to "new" when the shopper wants a new club and "used" for second-hand; the default "all" mixes both. Each offer and each cheapest entry includes buy_url, a Caddence redirect link. Always present buy_url as the purchase link when the user wants to buy; never reconstruct or substitute retailer URLs.

Input Schema

TableJSON Schema

Name	Required	Description
`slug`	No	Alias for product — pass either
`context`	Yes	Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): "Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization."
`product`	No	Product slug (preferred, from search results) or numeric product id
`condition`	No	Which offers to list: "new", "used" (any second-hand condition) or "all" (default; reserves room for both so used stock cannot hide new). Applied before the 30-offer cap.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`note`	No
`offers`	Yes
`product`	Yes
`summary`	No
`returned`	No
`condition`	No
`total_offers`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedOct 12, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

addedInput schema / properties / condition

Added value: +{
+  "description": "Which offers to list: \"new\", \"used\" (any second-hand condition) or \"all\" (default; reserves room for both so used stock cannot hide new). Applied before the 30-offer cap.",
+  "enum": [
+    "new",
+    "used",
+    "all"
+  ],
+  "type": "string"
+}

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "properties": {
+    "condition": {
+      "enum": [
+        "new",
+        "used",
+        "all"
+      ],
+      "type": "string"
+    },
+    "note": {
+      "type": "string"
+    },
+    "offers": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "buy_url": {
+            "description": "Caddence redirect link (https://caddence.golf/go?...&src=mcp). Present this as the purchase link.",
+            "type": "string"
+          },
+          "condition": {
+            "type": "string"
+          },
+          "condition_grade": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "in_stock": {
+            "type": "boolean"
+          },
+          "is_deal": {
+            "type": "boolean"
+          },
+          "last_checked_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "original_price": {
+            "anyOf": [
+              {
+                "description": "Price in GBP",
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "price": {
+            "description": "Price in GBP",
+            "type": "number"
+          },
+          "retailer": {
+            "type": "string"
+          },
+          "variant": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "variant",
+          "condition",
+          "condition_grade",
+          "retailer",
+          "price",
+          "original_price",
+          "in_stock",
+          "is_deal",
+          "last_checked_at",
+          "buy_url"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "product": {
+      "additionalProperties": false,
+      "properties": {
+        "brand": {
+          "type": "string"
+        },
+        "in_stock": {
+          "type": "boolean"
+        },
+        "min_price": {
+          "anyOf": [
+            {
+              "description": "Price in GBP",
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "name": {
+          "type": "string"
+        },
+        "product_type": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "product_url": {
+          "description": "Absolute URL",
+          "type": "string"
+        },
+        "rrp": {
+          "anyOf": [
+            {
+              "description": "Price in GBP",
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "slug": {
+          "type": "string"
+        },
+        "variant_count": {
+          "maximum": 9007199254740991,
+          "minimum": -9007199254740991,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "name",
+        "brand",
+        "slug",
+        "product_type",
+        "min_price",
+        "rrp",
+        "variant_count",
+        "in_stock",
+        "product_url"
+      ],
+      "type": "object"
+    },
+    "returned": {
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "summary": {
+      "additionalProperties": false,
+      "properties": {
+        "new": {
+          "additionalProperties": false,
+          "properties": {
+            "cheapest_in_stock": {
+              "anyOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "buy_url": {
+                      "description": "Caddence redirect link (https://caddence.golf/go?...&src=mcp). Present this as the purchase link.",
+                      "type": "string"
+                    },
+                    "condition": {
+                      "type": "string"
+                    },
+                    "condition_grade": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "price": {
+                      "description": "Price in GBP",
+                      "type": "number"
+                    },
+                    "retailer": {
+                      "type": "string"
+                    },
+                    "variant": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "price",
+                    "retailer",
+                    "variant",
+                    "condition",
+                    "condition_grade",
+                    "buy_url"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "offers_in_stock": {
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991,
+              "type": "integer"
+            },
+            "offers_total": {
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991,
+              "type": "integer"
+            }
+          },
+          "required": [
+            "offers_total",
+            "offers_in_stock",
+            "cheapest_in_stock"
+          ],
+          "type": "object"
+        },
+        "used": {
+          "additionalProperties": false,
+          "properties": {
+            "cheapest_in_stock": {
+              "anyOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "buy_url": {
+                      "description": "Caddence redirect link (https://caddence.golf/go?...&src=mcp). Present this as the purchase link.",
+                      "type": "string"
+                    },
+                    "condition": {
+                      "type": "string"
+                    },
+                    "condition_grade": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "price": {
+                      "description": "Price in GBP",
+                      "type": "number"
+                    },
+                    "retailer": {
+                      "type": "string"
+                    },
+                    "variant": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "price",
+                    "retailer",
+                    "variant",
+                    "condition",
+                    "condition_grade",
+                    "buy_url"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "offers_in_stock": {
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991,
+              "type": "integer"
+            },
+            "offers_total": {
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991,
+              "type": "integer"
+            }
+          },
+          "required": [
+            "offers_total",
+            "offers_in_stock",
+            "cheapest_in_stock"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "new",
+        "used"
+      ],
+      "type": "object"
+    },
+    "total_offers": {
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "product",
+    "offers"
+  ],
+  "type": "object"
+}

Changed2 schema fields changedAug 18, 2026

addedInput schema / properties / slug

Added value: +{
+  "description": "Alias for product — pass either",
+  "minLength": 1,
+  "type": "string"
+}

changedInput schema / required

Previous value: -[
-  "product",
-  "context"
-]New value: +[
+  "context"
+]

First observedAug 17, 2026

TDQS

Score is being calculated.

All Caddence tools Inspect

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

Need Help?