Skip to main content
Glama
Sign In

Caddence

by golf.caddence
OverviewDiscussionsAdmin

Get deal intelligence (CaddenceScore)

get_deal_intelligence
Read-onlyIdempotent

Deal-quality assessment for one product: CaddenceScore (0-100 rating of the current best DEAL, not the club), price trajectory vs typical/low/high, used market stats, and per-build availability (condition/flex/loft/hand) with the cheapest retailer and a buy_url purchase link per build. Use this to answer "is this a good price right now?".

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "context": "<context>"
    },
    "name": "get_deal_intelligence"
  }
}

Input Schema

NameRequiredDescriptionDefault
slugNoAlias for product — pass either
contextYesExplain 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."
productNoProduct slug (preferred, from search results) or numeric product id

Output Schema

NameRequiredDescriptionDefault
nameYes
slugYes
usedYes
brandYes
scoreYes
trajectoryYes
product_urlYesAbsolute URL
availabilityYes
cheapest_newYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "properties": {
+    "availability": {
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "buy_url": {
+            "anyOf": [
+              {
+                "description": "Caddence redirect link (https://caddence.golf/go?...&src=mcp). Present this as the purchase link.",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "cheapest_retailer": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "condition": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "flex": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "from_price": {
+            "description": "Price in GBP",
+            "type": "number"
+          },
+          "hand": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "loft": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "retailer_count": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "condition",
+          "flex",
+          "loft",
+          "hand",
+          "retailer_count",
+          "from_price",
+          "cheapest_retailer",
+          "buy_url"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "brand": {
+      "type": "string"
+    },
+    "cheapest_new": {
+      "anyOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "price": {
+              "description": "Price in GBP",
+              "type": "number"
+            },
+            "retailer": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "price",
+            "retailer"
+          ],
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "name": {
+      "type": "string"
+    },
+    "product_url": {
+      "description": "Absolute URL",
+      "type": "string"
+    },
+    "score": {
+      "additionalProperties": {},
+      "properties": {
+        "components": {
+          "anyOf": [
+            {
+              "additionalProperties": {},
+              "propertyNames": {
+                "type": "string"
+              },
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "flag": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "tier": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "value": {
+          "type": [
+            "number",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "value",
+        "tier",
+        "flag",
+        "components"
+      ],
+      "type": "object"
+    },
+    "slug": {
+      "type": "string"
+    },
+    "trajectory": {
+      "additionalProperties": {},
+      "properties": {
+        "change_7d": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "change_since_start": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "high": {
+          "anyOf": [
+            {
+              "description": "Price in GBP",
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "low": {
+          "anyOf": [
+            {
+              "description": "Price in GBP",
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "low_date": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "sale_count": {
+          "anyOf": [
+            {
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "today": {
+          "anyOf": [
+            {
+              "description": "Price in GBP",
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "typical": {
+          "anyOf": [
+            {
+              "description": "Price in GBP",
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "typical_low": {
+          "anyOf": [
+            {
+              "description": "Price in GBP",
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "window_days": {
+          "anyOf": [
+            {
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "window_start": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "used": {
+      "anyOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "avg_price": {
+              "description": "Price in GBP",
+              "type": "number"
+            },
+            "listings": {
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991,
+              "type": "integer"
+            },
+            "min_price": {
+              "description": "Price in GBP",
+              "type": "number"
+            },
+            "retention_pct": {
+              "type": [
+                "number",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "min_price",
+            "avg_price",
+            "listings",
+            "retention_pct"
+          ],
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "required": [
+    "name",
+    "brand",
+    "slug",
+    "product_url",
+    "score",
+    "cheapest_new",
+    "trajectory",
+    "used",
+    "availability"
+  ],
+  "type": "object"
+}
  2. Changed2 schema fields changed
    • 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"
+]
  3. First observed

TDQS

A3.6/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true, idempotentHint=true, openWorldHint=false and destructiveHint=false, so the safety profile is covered. The description adds useful context about the response shape (cheapest retailer, buy_url purchase link, per-build condition/flex/loft/hand), but says nothing about latency, data freshness, or what happens when a product/build has no offer.

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

Conciseness4/5

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

The core purpose is front-loaded in the opening clause, and the long field enumeration is a single dense sentence rather than filler. It is somewhat run-on, but every element maps to an actual returned field, so little is wasted.

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?

For a read-only lookup with a full output schema and rich annotations, the description covers purpose, scope, and the returned signals adequately. It does not explain the scoring methodology or rating bands, which would help an agent interpret a CaddenceScore of, say, 62.

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%, so the schema already documents slug/product aliasing and the verbose context parameter; baseline 3 applies. The description's phrase 'for one product' reinforces single-product scoping but adds no format, alias, or id-versus-slug guidance beyond the schema.

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

Purpose4/5

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

States a specific resource and scope: 'Deal-quality assessment for one product' with the CaddenceScore 0-100 rating, explicitly noting it rates the DEAL and not the club. It distinguishes itself functionally from get_price_history and get_product_offers by combining trajectory, market stats, and per-build availability, but never names those siblings, so the differentiation is inferred rather than stated.

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?

Gives a clear triggering question ('Use this to answer "is this a good price right now?"'), which tells an agent exactly what user intent should route here. It stops short of naming when NOT to use it or which sibling (get_market_deals, get_price_history, get_product_offers) to prefer for narrower questions.

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

All Caddence 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