Skip to main content
Glama

Shopper: check recalls

check_recalls
Read-only

Returns official recall notices. Category kids checks up to 6 baby and child items with optional ages and country, including recall matches, same-brand notices and relevant safe-sleep and tip-over guidance. Coverage: US, UK, Canada and EU. In the US, category 'product' searches CPSC consumer-product recalls by words in the product name (brand plus product type, e.g. 'Rowenta vacuum'); 'food_drug' searches FDA food, drug and medical device enforcement reports (e.g. 'CPAP', 'insulin pump'); 'vehicle' searches NHTSA by make, model and model year. country 'GB' searches UK OPSS product recalls and Food Standards Agency alerts; 'CA' Health Canada; an EU or EEA country (e.g. 'DE', 'France') the EU Safety Gate alerts on dangerous non-food products and vehicles from the last three years. An empty result means no notice was found; it does not mean an item is free of recalls elsewhere. Applies to questions about whether a product, food, drug, medical device or vehicle has a recall notice. Results report what the official sources say and are not a safety assessment. Not medical advice.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "check_recalls"
  }
}

Input Schema

NameRequiredDescriptionDefault
agesNoFor kids: children’s ages, used for safety guidance
makeNoVehicle make, e.g. 'Honda' (vehicle only)
yearNoVehicle model year (vehicle only)
itemsNoFor kids: up to 6 child items, brand plus product
modelNoVehicle model, e.g. 'Civic' (vehicle only)
queryNoProduct, food, drug or medical device words, for product and food_drug, e.g. 'stroller', 'peanut butter' or 'CPAP'
countryNoCountry whose notices are searched: United States (default), United Kingdom, Canada or any EU/EEA country
categoryNoproduct (CPSC), food_drug (FDA food, drugs and medical devices), vehicle (NHTSA), or kids (a list of child items); inferred when left out

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changed
    • addedInput schema / properties / ages
      Added value: +{
      +  "description": "For kids: children’s ages, used for safety guidance",
      +  "maxLength": 80,
      +  "type": "string"
      +}
    • changedInput schema / properties / category / description
      Previous value: -"product (CPSC), food_drug (FDA food, drugs and medical devices) or vehicle (NHTSA)"New value: +"product (CPSC), food_drug (FDA food, drugs and medical devices), vehicle (NHTSA), or kids (a list of child items); inferred when left out"
    • changedInput schema / properties / category / enum
      Previous value: -[
      -  "product",
      -  "food_drug",
      -  "vehicle"
      -]New value: +[
      +  "product",
      +  "food_drug",
      +  "vehicle",
      +  "kids"
      +]
    • addedInput schema / properties / items
      Added value: +{
      +  "description": "For kids: up to 6 child items, brand plus product",
      +  "items": {
      +    "maxLength": 80,
      +    "minLength": 2,
      +    "type": "string"
      +  },
      +  "maxItems": 6,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • removedInput schema / required
      Removed value: -[
      -  "category"
      -]
  2. Changed1 schema field changed
    • changedInput schema / properties / country / description
      Previous value: -"Where the person lives or bought it: United States (default), United Kingdom, Canada or any EU/EEA country"New value: +"Country whose notices are searched: United States (default), United Kingdom, Canada or any EU/EEA country"
  3. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -{
      -  "$schema": "https://json-schema.org/draft/2020-12/schema",
      -  "additionalProperties": false,
      -  "properties": {
      -    "category": {
      -      "enum": [
      -        "product",
      -        "food_drug",
      -        "vehicle"
      -      ],
      -      "type": "string"
      -    },
      -    "checked_at": {
      -      "type": "string"
      -    },
      -    "note": {
      -      "type": "string"
      -    },
      -    "query": {
      -      "type": "string"
      -    },
      -    "recalls": {
      -      "items": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "date": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "hazard": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "link": {
      -            "type": "string"
      -          },
      -          "remedy": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "source": {
      -            "enum": [
      -              "CPSC",
      -              "FDA",
      -              "NHTSA",
      -              "UK OPSS",
      -              "UK FSA",
      -              "Health Canada",
      -              "EU Safety Gate"
      -            ],
      -            "type": "string"
      -          },
      -          "status": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "source",
      -          "title",
      -          "date",
      -          "hazard",
      -          "remedy",
      -          "status",
      -          "link"
      -        ],
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "sources": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    }
      -  },
      -  "required": [
      -    "category",
      -    "query",
      -    "sources",
      -    "checked_at",
      -    "recalls",
      -    "note"
      -  ],
      -  "type": "object"
      -}New value: +null
  4. Changed2 schema fields changed
    • changedInput schema / properties / country / description
      Previous value: -"Where the person lives or bought it: United States (default), United Kingdom or Canada"New value: +"Where the person lives or bought it: United States (default), United Kingdom, Canada or any EU/EEA country"
    • changedOutput schema / properties / recalls / items / properties / source / enum
      Previous value: -[
      -  "CPSC",
      -  "FDA",
      -  "NHTSA",
      -  "UK OPSS",
      -  "UK FSA",
      -  "Health Canada"
      -]New value: +[
      +  "CPSC",
      +  "FDA",
      +  "NHTSA",
      +  "UK OPSS",
      +  "UK FSA",
      +  "Health Canada",
      +  "EU Safety Gate"
      +]
  5. Changed2 schema fields changed
    • addedInput schema / properties / country
      Added value: +{
      +  "description": "Where the person lives or bought it: United States (default), United Kingdom or Canada",
      +  "maxLength": 60,
      +  "type": "string"
      +}
    • changedOutput schema / properties / recalls / items / properties / source / enum
      Previous value: -[
      -  "CPSC",
      -  "FDA",
      -  "NHTSA"
      -]New value: +[
      +  "CPSC",
      +  "FDA",
      +  "NHTSA",
      +  "UK OPSS",
      +  "UK FSA",
      +  "Health Canada"
      +]
  6. Changed2 schema fields changed
    • changedInput schema / properties / category / description
      Previous value: -"product (CPSC), food_drug (FDA) or vehicle (NHTSA)"New value: +"product (CPSC), food_drug (FDA food, drugs and medical devices) or vehicle (NHTSA)"
    • changedInput schema / properties / query / description
      Previous value: -"Product or food/drug words, for product and food_drug, e.g. 'stroller' or 'peanut butter'"New value: +"Product, food, drug or medical device words, for product and food_drug, e.g. 'stroller', 'peanut butter' or 'CPAP'"
  7. First observed

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, openWorldHint and destructiveHint=false, but the description adds genuine value beyond them: per-country source registries, the EU three-year window, and a crucial semantic caveat that an empty result means no notice was found in these sources, not that the item is recall-free. It still doesn't describe pagination or result volume, so not a 5.

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?

Front-loaded with the one-line purpose, then organized by category and region, which is the right structure for a multi-source tool. Dense but nearly every clause carries routing or caveat information; the final 'Not medical advice' is short enough to earn its place alongside the safety-assessment disclaimer.

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 an 8-parameter, multi-jurisdiction tool with no output schema, the description covers what it searches, where, how to shape inputs, what an empty response means, and the limits of the result. An agent could select and call this correctly without any further documentation.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline would be 3, but the description meaningfully elaborates: it explains what 'query' words should look like per category ('Rowenta vacuum' for product, 'CPAP'/'insulin pump' for food_drug, make/model/year for vehicle), that 'GB' maps to OPSS/FSA and an EU country to Safety Gate, and that category is inferred when omitted. Ages/items are only lightly covered, which keeps it at 4.

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?

Opens with a specific verb and resource ('Returns official recall notices') and immediately scopes it: consumer products, food/drug/devices, vehicles, and child items across US, UK, Canada and EU. The category-by-category routing (CPSC vs FDA vs NHTSA, OPSS vs Health Canada vs Safety Gate) makes it unmistakable which sibling tool would not do this job.

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?

Provides an explicit triggering condition: 'Applies to questions about whether a product, food, drug, medical device or vehicle has a recall notice,' plus an explicit exclusion ('not a safety assessment', 'not medical advice'). It does not name a sibling alternative for cases the user actually wants general product or food safety info, which keeps it short of a 5.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources