AirShelf Catalog

Get product details

get_product

Read-only

Get the full golden record (AirShelf's verified product record) and latest price for one catalog product by slug ("-").

Returns the product's specs and provenance (which page each fact came from), plus canonical_name (its exact catalog name). A field's evidence_sha256 is the SHA-256 of the source document AirShelf archived when it extracted that claim. A caller holding the same bytes can compare the hash to check that the cited document has not changed. AirShelf does not serve those archived bytes, and the hash does not promise they remain retrievable. Branch on commercial_data.actionable before using price or stock: observations older than 24 hours are withheld from latestPrice and retained only as labelled last_observed history. For quote-gated B2B pricing, a null price with a quote path is expected rather than an error. product.commercial_disclosure is present when the product's maker is a seller AirShelf serves through its own agent endpoints (relationship "onboarded_merchant"). In clients that render MCP Apps the response also draws one product card per call. related_products — relationships extracted from vendor documents (e.g. compatible toner or drum accessories with their source quotes, functional equivalents, supersessions); each entry names the related catalog slug, the relation type, its direction (direction is "from_this" when the relation reads this-product → related-product, "to_this" when it reads related-product → this-product), and the source URL and quote the relation was extracted from.

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": {
      "slug": "<slug>"
    },
    "name": "get_product"
  }
}

Input Schema

Name	Required	Description	Default
`slug`	Yes	Composite slug, e.g. toshiba-b-ex4t1-ts12-qm-r

Output Schema

Name	Required	Description
`title`	Yes
`action`	Yes
`buyUrl`	No
`product`	No
`benefits`	No
`imageUrl`	No
`productId`	Yes
`buttonLabel`	Yes
`pricing_gated`	No
`related_products`	No	Documented related catalog products, including accessories, equivalents and replacements.

Schema Changelog

Changes observed during successful MCP inspections.

Changed6 schema fields changedSep 23, 2026

addedOutput schema / properties / product / properties

Added value: +{
+  "cited_field_count": {
+    "description": "Number of golden-record fields with claim-level citations.",
+    "type": "number"
+  },
+  "field_count": {
+    "description": "Total golden-record fields used as the evidence coverage denominator.",
+    "type": "number"
+  },
+  "latestPrice": {
+    "anyOf": [
+      {
+        "additionalProperties": {},
+        "properties": {
+          "capturedAt": {
+            "type": "string"
+          },
+          "currency": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "inStock": {
+            "anyOf": [
+              {
+                "type": "boolean"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "price": {
+            "type": "number"
+          },
+          "retailer": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "price",
+          "currency",
+          "retailer",
+          "inStock",
+          "capturedAt"
+        ],
+        "type": "object"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "description": "Latest valid price observation within 24 hours. Null when absent or stale; stale history remains in commercial_data.last_observed."
+  },
+  "lifecycle_status": {
+    "description": "Retirement marker from stored product evidence. current means no retirement marker was found.",
+    "enum": [
+      "current",
+      "retired"
+    ],
+    "type": "string"
+  },
+  "pdfFilenames": {
+    "description": "Stored source PDF filenames. A filename is not a download URL.",
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  },
+  "qualityScore": {
+    "description": "Percentage of golden-record fields with claim-level citations. Zero when there are no fields.",
+    "type": "number"
+  },
+  "related_products": {
+    "description": "Documented related catalog products, including accessories, equivalents and replacements.",
+    "items": {
+      "additionalProperties": {},
+      "properties": {
+        "direction": {
+          "description": "from_this means this product points to the related product; to_this means the reverse.",
+          "enum": [
+            "from_this",
+            "to_this"
+          ],
+          "type": "string"
+        },
+        "relation": {
+          "description": "Relationship type recorded from vendor documents.",
+          "type": "string"
+        },
+        "slug": {
+          "type": "string"
+        },
+        "source": {
+          "anyOf": [
+            {
+              "additionalProperties": {},
+              "propertyNames": {
+                "type": "string"
+              },
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Stored source URL, quote, section or page for the relationship; null when none was recorded."
+        }
+      },
+      "required": [
+        "slug",
+        "relation",
+        "direction"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "sources": {
+    "anyOf": [
+      {
+        "anyOf": [
+          {
+            "items": {
+              "anyOf": [
+                {
+                  "additionalProperties": {},
+                  "properties": {
+                    "type": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Stored source type, such as pdf or product_page."
+                    },
+                    "url": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Source document or product-page URL when recorded."
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            },
+            "type": "array"
+          },
+          {
+            "additionalProperties": {},
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          }
+        ]
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "description": "Stored evidence sources. Imports may preserve a source object, use ref instead of url, or list plain strings. Null when unavailable."
+  },
+  "updatedAt": {
+    "description": "Catalog row update time as an ISO 8601 timestamp, not a per-claim verification time.",
+    "type": "string"
+  }
+}

removedOutput schema / properties / product / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```

addedOutput schema / properties / related_products / description

Added value: +"Documented related catalog products, including accessories, equivalents and replacements."

addedOutput schema / properties / related_products / items / properties

Added value: +{
+  "direction": {
+    "description": "from_this means this product points to the related product; to_this means the reverse.",
+    "enum": [
+      "from_this",
+      "to_this"
+    ],
+    "type": "string"
+  },
+  "relation": {
+    "description": "Relationship type recorded from vendor documents.",
+    "type": "string"
+  },
+  "slug": {
+    "type": "string"
+  },
+  "source": {
+    "anyOf": [
+      {
+        "additionalProperties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "description": "Stored source URL, quote, section or page for the relationship; null when none was recorded."
+  }
+}

removedOutput schema / properties / related_products / items / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```
addedOutput schema / properties / related_products / items / required
```
Added value: +[
+  "slug",
+  "relation",
+  "direction"
+]
```

Changed1 schema field changedSep 21, 2026

changedInput schema / properties / slug / description

Previous value: -"Composite slug, e.g. keychron-q1-pro"New value: +"Composite slug, e.g. toshiba-b-ex4t1-ts12-qm-r"

Changed1 schema field changedAug 17, 2026

addedOutput schema / properties / related_products

Added value: +{
+  "items": {
+    "additionalProperties": {},
+    "propertyNames": {
+      "type": "string"
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

Changed1 schema field changedAug 5, 2026
- addedInput schema / properties / slug / minLength
```
Added value: +1
```
Changed1 schema field changedJul 27, 2026
- addedOutput schema / properties / pricing_gated
```
Added value: +{
+  "type": "boolean"
+}
```

Changed2 schema fields changedJul 13, 2026

addedOutput schema / properties / benefits

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / product

Added value: +{
+  "additionalProperties": {},
+  "propertyNames": {
+    "type": "string"
+  },
+  "type": "object"
+}

Changed1 schema field changedJul 6, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "action": {
+      "enum": [
+        "quote",
+        "link"
+      ],
+      "type": "string"
+    },
+    "buttonLabel": {
+      "type": "string"
+    },
+    "buyUrl": {
+      "type": "string"
+    },
+    "imageUrl": {
+      "type": "string"
+    },
+    "productId": {
+      "type": "string"
+    },
+    "title": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "title",
+    "productId",
+    "buttonLabel",
+    "action"
+  ],
+  "type": "object"
+}

First observedJun 17, 2026

TDQS

A4.1/5.0

Behavior5/5

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

Beyond the readOnly/non-destructive annotations, the description discloses provenance hash semantics, that AirShelf does not serve or guarantee the archived bytes, the 24-hour latestPrice withholding rule, quote-gated null behavior, commercial_disclosure conditions, MCP Apps card rendering, and related_products direction semantics. These are substantive behavioral traits not covered by the annotations.

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

Conciseness3/5

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

The purpose is front-loaded and most sentences carry meaningful caveats, but the description is very long for a one-parameter read tool. It spends substantial text explaining return-shape details even though an output schema exists, and the single-block format makes later caveats harder to scan.

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

Completeness5/5

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

For a complex catalog lookup with rich output, the description covers provenance, price staleness, quote-gated nulls, merchant disclosure, and related-product relations, so an agent has enough context to invoke and interpret it. The main gap is explicit sibling routing rather than missing operational context.

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?

There is one required slug parameter with 100% schema description coverage, and the schema already gives a composite slug example. The description restates the '<manufacturer>-<model>' format but adds no syntax, constraints, or edge cases beyond the schema.

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 first sentence names a specific verb ('Get'), resource ('full golden record... latest price'), and scope ('one catalog product by slug'), and gives the slug shape. This clearly separates it from catalog search/find/compare siblings, even without naming them explicitly.

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

Usage Guidelines3/5

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

It explains how to interpret returned commercial data, including branching on commercial_data.actionable and expecting null quote-gated prices. However, it never states when to choose this tool over find_products, search_catalog, or explain_product; the requirement for a composite slug only implies that discovery happens elsewhere.

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

All AirShelf Catalog 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?