cpsc-recalls-mcp-server

Search consumer product recalls from the CPSC (Consumer Product Safety Commission) — toys, electronics, furniture, appliances, children's products, tools, and clothing. Give at least one text filter or date bound; to browse the latest recalls without one, use cpsc_get_recent. Filters combine with AND, and a text filter matches records whose field contains every one of its words, in any order and case-insensitively. Start with title_search when you have a product in hand — CPSC titles carry the brand, product, and hazard phrasing. For hazard types ("fire", "choking", "burn"), use hazard_search, which matches hazard descriptions, product names, and remedy instructions. When manufacturer finds nothing, try importer, retailer, or distributor: many recalls name one of those as the responsible company. Page past limit with offset — total_found counts every match and has_more says whether more remain; a page returns fewer than limit recalls when it reaches the 64,000-byte response size budget. Pass a recall_number to cpsc_get_recall for the full record, including the complete description, all images, and incident reports. CPSC jurisdiction: consumer products only — food/drugs (FDA), motor vehicles/tires (NHTSA), boats (USCG), pesticides (EPA), and firearms (ATF) are covered by other agencies.

{
  "type": "object",
  "properties": {
    "product_name": {
      "description": "Product name to search for, e.g. \"crib\", \"space heater\", \"bicycle\". Matches recalls whose product names contain every word, in any order — partial words work.",
      "type": "string",
      "maxLength": 500
    },
    "manufacturer": {
      "description": "Manufacturer name, e.g. \"Samsung\", \"LEGO\". Matches recalls whose manufacturer names contain every word, in any order. Many recalls name the importer, retailer, or distributor rather than the manufacturer — try those filters when this finds nothing.",
      "type": "string",
      "maxLength": 500
    },
    "retailer": {
      "description": "Retailer name, e.g. \"Walmart\", \"Target\", \"Amazon\". Matches recalls whose retailer text (store name, dates sold, and price) contains every word, in any order.",
      "type": "string",
      "maxLength": 500
    },
    "importer": {
      "description": "Importer company name. Matches recalls whose importer names contain every word, in any order. Use when searching for recalls by the company that brought the product into the US.",
      "type": "string",
      "maxLength": 500
    },
    "distributor": {
      "description": "Distributor company name, e.g. \"Walmart\", \"Costco\". Matches recalls whose distributor names contain every word, in any order — a role distinct from retailer and importer, and listed on far fewer recalls.",
      "type": "string",
      "maxLength": 500
    },
    "title_search": {
      "description": "Keyword search within the recall title, e.g. \"chandelier\", \"space heater\", \"Graco crib\". Matches titles containing every word, in any order. CPSC titles name the brand, the product, and the hazard, which makes this the highest-signal single filter for most searches.",
      "type": "string",
      "maxLength": 500
    },
    "description_search": {
      "description": "Keyword search within the recall description only — not the title, hazard text, or remedy instructions; matches descriptions containing every word, in any order. Use for product details not captured in product_name — model numbers, colors, sale channels. For hazard concepts, prefer hazard_search; for the recall headline, prefer title_search.",
      "type": "string",
      "maxLength": 500
    },
    "remedy": {
      "description": "Keyword search within the free-text remedy instructions, e.g. \"repair\", \"refund\", \"firmware update\"; matches instructions containing every word, in any order. This searches the remedy text, not the remedy_options categories — \"repair\" matches records whose remedy_options list only \"Refund\" but whose instructions describe a free repair kit. Combines with the other filters using AND; use hazard_search instead to match remedy text as one of several fields.",
      "type": "string",
      "maxLength": 500
    },
    "hazard_search": {
      "description": "Hazard or safety-concept keyword, e.g. \"fire\", \"choking\", \"burn\", \"tip-over dresser\". Matches when every word appears in the hazard descriptions, product names, or remedy instructions — each word in any of the three, in any order, case-insensitive. The filter to use for hazard types; combine it with another filter to narrow a broad hazard.",
      "type": "string",
      "maxLength": 500
    },
    "date_start": {
      "description": "Include only recalls on or after this date. ISO 8601 format: \"YYYY-MM-DD\". Must be a real calendar date — \"2026-02-31\" and \"2026-99-99\" are rejected.",
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "format": "date",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
          "description": "ISO 8601 date: \"YYYY-MM-DD\"."
        }
      ]
    },
    "date_end": {
      "description": "Include only recalls on or before this date. ISO 8601 format: \"YYYY-MM-DD\". Must be a real calendar date, and on or after date_start.",
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "format": "date",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
          "description": "ISO 8601 date: \"YYYY-MM-DD\"."
        }
      ]
    },
    "updated_start": {
      "description": "Include only recalls last published by CPSC on or after this date. ISO 8601 format: \"YYYY-MM-DD\". A separate axis from date_start: a 2003 recall re-published in 2025 matches updated_start \"2025-01-01\". Use to answer \"what has CPSC updated recently\". Must be a real calendar date.",
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "format": "date",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
          "description": "ISO 8601 date: \"YYYY-MM-DD\"."
        }
      ]
    },
    "updated_end": {
      "description": "Include only recalls last published by CPSC on or before this date. ISO 8601 format: \"YYYY-MM-DD\". Must be a real calendar date, and on or after updated_start.",
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "format": "date",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
          "description": "ISO 8601 date: \"YYYY-MM-DD\"."
        }
      ]
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of recalls to return on this page. Defaults to 20. A page returns fewer when it reaches the 64,000-byte response size budget; has_more then says more remain.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "offset": {
      "default": 0,
      "description": "Skip this many matching records before returning results. To page through total_found, raise offset by the number of recalls the previous page returned — limit, unless that page reached the response size budget. An offset at or past total_found returns an empty result set rather than an error.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "recalls": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "recall_number": {
            "type": "string",
            "description": "Recall identifier (5-digit numeric for 2002+ records, e.g. \"25043\"; 6-char with letter suffix for 1998–2001 records, e.g. \"99003a\"). Pass to cpsc_get_recall for full detail."
          },
          "recall_date": {
            "type": "string",
            "description": "Date the recall was issued, ISO 8601."
          },
          "title": {
            "type": "string",
            "description": "Official recall title."
          },
          "hazards": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Hazard description — what is dangerous."
            },
            "description": "Hazard descriptions — what is dangerous about this product."
          },
          "remedy_options": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Remedy type."
            },
            "description": "Remedy types: Refund, Repair, Replace, New Instructions, Dispose, Label, No Remedy Available, Inspect. Multiple may apply. Often empty — CPSC classified the remedy on fewer than half its records; read remedy_summary when this is empty, and cpsc_url when that is empty too."
          },
          "remedy_summary": {
            "type": "string",
            "description": "Full remedy instructions — what the consumer should do and how to claim."
          },
          "products": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Product name."
                },
                "units_recalled": {
                  "type": "string",
                  "description": "Estimated number of units recalled, e.g. \"About 2,500\"."
                }
              },
              "required": [
                "name",
                "units_recalled"
              ],
              "additionalProperties": false,
              "description": "A product covered by this recall."
            },
            "description": "Products covered by this recall. A recall may cover multiple products."
          },
          "upcs": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "UPC code."
            },
            "description": "UPC codes for this recall (sparse — ~4% of records have UPCs). CPSC lists UPCs for the recall as a whole, not per product, so on a recall covering several products a UPC cannot be tied to one of them."
          },
          "manufacturers": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Manufacturer name."
            },
            "description": "Manufacturer names. Often empty — importer or retailer may be listed instead."
          },
          "importers": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Importer name."
            },
            "description": "Importer company names."
          },
          "retailers": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Retailer name and sale details."
            },
            "description": "Retailer names and sale details (narrative text including stores, dates, price range)."
          },
          "cpsc_url": {
            "type": "string",
            "description": "Official CPSC recall page URL for human verification."
          },
          "images": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string",
                  "description": "Image URL."
                },
                "caption": {
                  "type": "string",
                  "description": "Image caption."
                }
              },
              "required": [
                "url",
                "caption"
              ],
              "additionalProperties": false,
              "description": "An image from the recall notice."
            },
            "description": "Product images from the recall notice."
          },
          "data_quality_notes": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "One gap found in the CPSC record."
            },
            "description": "Gaps this server observed in the CPSC record — absent hazard text, absent product entries. Derived from which fields CPSC left empty, not from any judgement about the recall itself. Empty when nothing is missing."
          }
        },
        "required": [
          "recall_number",
          "recall_date",
          "title",
          "hazards",
          "remedy_options",
          "remedy_summary",
          "products",
          "upcs",
          "manufacturers",
          "importers",
          "retailers",
          "cpsc_url",
          "images",
          "data_quality_notes"
        ],
        "additionalProperties": false,
        "description": "A CPSC recall record."
      },
      "description": "Matching recalls, ordered newest-first."
    },
    "total_found": {
      "type": "number",
      "description": "Total matching records, counted after every filter is applied and before offset, limit, and the response size budget narrow the window."
    },
    "truncated": {
      "type": "boolean",
      "description": "True when matching records remain past this page — always equal to has_more."
    },
    "offset": {
      "type": "number",
      "description": "Number of matching records skipped before this window."
    },
    "has_more": {
      "type": "boolean",
      "description": "True when records remain past this window — call again with offset raised by the number of recalls returned."
    },
    "cpsc_jurisdiction": {
      "type": "string",
      "description": "Which products CPSC covers and which agencies cover the rest — food/drugs (FDA), motor vehicles/tires (NHTSA), boats (USCG), pesticides (EPA), firearms (ATF)."
    },
    "source_note": {
      "type": "string",
      "description": "Provenance caveat: recall fields are CPSC record text with HTML markup and character codes converted to plain text, not otherwise edited or verified; check cpsc_url before a consumer-facing decision."
    },
    "effectiveQuery": {
      "type": "string",
      "description": "The search criteria as applied, joined with AND: each non-blank text filter trimmed, the hazard alias resolved to hazard_search, and blank date bounds dropped."
    },
    "notice": {
      "description": "Present when the page needs explaining: zero matches (with which criterion to relax), an offset past the last match, or a page cut short by the response size budget (with the offset to continue from).",
      "type": "string"
    },
    "error": {
      "description": "Present when the call failed. Absent on success.",
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "JSON-RPC error code for this failure."
        },
        "message": {
          "type": "string",
          "description": "Human-readable description of what went wrong."
        },
        "data": {
          "type": "object",
          "properties": {
            "reason": {
              "type": "string",
              "description": "Machine-readable failure mode. Declared by this tool: `missing_criteria`: No search criterion was given: every text filter was omitted or blank and no date bound was set. `invalid_date_range`: date_start is later than date_end, or updated_start is later than updated_end, so the range can never match. `upstream_error`: The CPSC recall service (saferproducts.gov) was unavailable, timed out, reported a temporary failure reading its recall data, or sent an unreadable response. `upstream_rejected`: CPSC rejected the request instead of returning recalls, and it rejects the same request every time. Other values are possible when a failure originates below the handler.",
              "examples": [
                "missing_criteria",
                "invalid_date_range",
                "upstream_error",
                "upstream_rejected"
              ]
            },
            "recovery": {
              "description": "Actionable next step for the caller.",
              "type": "object",
              "properties": {
                "hint": {
                  "type": "string"
                }
              },
              "required": [
                "hint"
              ],
              "additionalProperties": {}
            },
            "retryable": {
              "description": "Whether retrying may succeed.",
              "type": "boolean"
            }
          },
          "additionalProperties": {}
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": {}
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "anyOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "required": [
        "recalls",
        "total_found",
        "truncated",
        "offset",
        "has_more",
        "cpsc_jurisdiction",
        "source_note",
        "effectiveQuery"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}

Fetch the full record for one CPSC recall by recall number: hazard description, remedy instructions, every product variant, UPCs, incident and injury reports, images, and the official CPSC recall page URL. Get a recall number from cpsc_search_recalls or cpsc_get_recent. CPSC jurisdiction: consumer products only — food/drugs (FDA), motor vehicles/tires (NHTSA), boats (USCG), pesticides (EPA), and firearms (ATF) are covered by other agencies.

{
  "type": "object",
  "properties": {
    "recall_number": {
      "type": "string",
      "pattern": "^\\d{5}([a-d])?$",
      "description": "CPSC recall number: 5 digits for 2002–present records, e.g. \"25043\", or 5 digits plus a letter a–d for 1998–2001 records, e.g. \"99003a\". Get one from cpsc_search_recalls or cpsc_get_recent results."
    }
  },
  "required": [
    "recall_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "recall_number": {
      "type": "string",
      "description": "Recall identifier."
    },
    "recall_date": {
      "type": "string",
      "description": "Date issued, ISO 8601."
    },
    "last_updated": {
      "type": "string",
      "description": "Date last published, ISO 8601."
    },
    "title": {
      "type": "string",
      "description": "Official recall title."
    },
    "description": {
      "description": "Full recall description including product identification details. Model numbers are typically embedded here, not in a structured field. Null when CPSC published the record without a description — rare, but a genuine record can still be complete otherwise.",
      "type": [
        "string",
        "null"
      ]
    },
    "cpsc_url": {
      "type": "string",
      "description": "Official CPSC recall page — authoritative source for consumers."
    },
    "consumer_contact": {
      "description": "Contact information for claiming the remedy. Null when not provided.",
      "type": [
        "string",
        "null"
      ]
    },
    "hazards": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string",
            "description": "What is dangerous about this product."
          }
        },
        "required": [
          "description"
        ],
        "additionalProperties": false,
        "description": "A hazard associated with this recall."
      },
      "description": "Hazards — read this first."
    },
    "remedy_options": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Remedy type."
      },
      "description": "Remedy types available: Refund, Repair, Replace, New Instructions, Dispose, Label, No Remedy Available, Inspect. Often empty — CPSC classified the remedy on fewer than half its records. Read remedy_instructions when this is empty, and fall back to cpsc_url when that is empty too, rather than reporting that no remedy exists."
    },
    "remedy_instructions": {
      "type": "string",
      "description": "Full remedy instructions — exactly what a consumer should do and how to claim."
    },
    "products": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Product name."
          },
          "units_recalled": {
            "type": "string",
            "description": "Estimated number of units recalled, e.g. \"About 2,500\"."
          }
        },
        "required": [
          "name",
          "units_recalled"
        ],
        "additionalProperties": false,
        "description": "A product covered by this recall."
      },
      "description": "Products covered. A recall may include multiple products. Model numbers are often in the description text, not a structured field."
    },
    "upcs": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "UPC code."
      },
      "description": "UPC codes for this recall (sparse — ~4% of records have UPCs). CPSC lists UPCs for the recall as a whole, not per product, so on a recall covering several products a UPC cannot be tied to one of them."
    },
    "injuries": {
      "type": "string",
      "description": "Injury and incident report narrative, e.g. \"None reported\" or incident count."
    },
    "manufacturers": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Manufacturer name."
      },
      "description": "Manufacturer names (often empty — see importers)."
    },
    "importers": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Importer name."
      },
      "description": "Importer company names."
    },
    "retailers": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Retailer name with sale date range and price."
      },
      "description": "Retailer names with sale date ranges and price."
    },
    "distributors": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Distributor name."
      },
      "description": "Distributor company names."
    },
    "manufacturer_countries": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Country of manufacture."
      },
      "description": "Countries of manufacture."
    },
    "images": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Image URL."
          },
          "caption": {
            "type": "string",
            "description": "Caption describing what the image shows."
          }
        },
        "required": [
          "url",
          "caption"
        ],
        "additionalProperties": false,
        "description": "An image from the recall notice."
      },
      "description": "Product and identification images from the recall notice."
    },
    "coordinated_recalls": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "URL of coordinated recall by another agency."
      },
      "description": "URLs of coordinated recalls by other agencies (e.g., Canada Health)."
    },
    "data_quality_notes": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "One gap found in the CPSC record."
      },
      "description": "Gaps this server observed in the CPSC record — absent description, absent hazard text, absent product entries. Derived from which fields CPSC left empty, not from any judgement about the recall itself. Empty when nothing is missing."
    },
    "cpsc_jurisdiction": {
      "type": "string",
      "description": "Which products CPSC covers and which agencies cover the rest — food/drugs (FDA), motor vehicles/tires (NHTSA), boats (USCG), pesticides (EPA), firearms (ATF)."
    },
    "source_note": {
      "type": "string",
      "description": "Provenance caveat: recall fields are CPSC record text with HTML markup and character codes converted to plain text, not otherwise edited or verified; check cpsc_url before a consumer-facing decision."
    },
    "error": {
      "description": "Present when the call failed. Absent on success.",
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "JSON-RPC error code for this failure."
        },
        "message": {
          "type": "string",
          "description": "Human-readable description of what went wrong."
        },
        "data": {
          "type": "object",
          "properties": {
            "reason": {
              "type": "string",
              "description": "Machine-readable failure mode. Declared by this tool: `not_found`: No recall exists with the given recall number. `upstream_error`: The CPSC recall service (saferproducts.gov) was unavailable, timed out, reported a temporary failure reading its recall data, or sent an unreadable response. `upstream_rejected`: CPSC rejected the lookup instead of returning a recall, and it rejects the same request every time. Other values are possible when a failure originates below the handler.",
              "examples": [
                "not_found",
                "upstream_error",
                "upstream_rejected"
              ]
            },
            "recovery": {
              "description": "Actionable next step for the caller.",
              "type": "object",
              "properties": {
                "hint": {
                  "type": "string"
                }
              },
              "required": [
                "hint"
              ],
              "additionalProperties": {}
            },
            "retryable": {
              "description": "Whether retrying may succeed.",
              "type": "boolean"
            }
          },
          "additionalProperties": {}
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": {}
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "anyOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "required": [
        "recall_number",
        "recall_date",
        "last_updated",
        "title",
        "description",
        "cpsc_url",
        "consumer_contact",
        "hazards",
        "remedy_options",
        "remedy_instructions",
        "products",
        "upcs",
        "injuries",
        "manufacturers",
        "importers",
        "retailers",
        "distributors",
        "manufacturer_countries",
        "images",
        "coordinated_recalls",
        "data_quality_notes",
        "cpsc_jurisdiction",
        "source_note"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}

Fetch the most recent CPSC consumer product recalls, newest-first, from a window of the last N days (default 30, up to 365). Use for "what's been recalled lately?" or a product safety feed; to find recalls by product, brand, hazard, or an older date range, use cpsc_search_recalls. Page past limit with offset: narrowing days cannot page, because the window is anchored to today and shrinking it drops the oldest recalls rather than advancing past the newest. A page returns fewer than limit recalls when it reaches the 64,000-byte response size budget; has_more and the notice give the offset to continue from. Pass a recall_number to cpsc_get_recall for the full record. CPSC jurisdiction: consumer products only — food/drugs (FDA), motor vehicles/tires (NHTSA), boats (USCG), pesticides (EPA), and firearms (ATF) are covered by other agencies.

{
  "type": "object",
  "properties": {
    "days": {
      "default": 30,
      "description": "Look back this many days from today. Defaults to 30. Use 7 for a weekly digest, 90 for a quarterly review.",
      "type": "integer",
      "minimum": 1,
      "maximum": 365
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of recalls to return. Defaults to 20. A page returns fewer when it reaches the 64,000-byte response size budget.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Skip this many recalls in the window before returning results. To page through total_found, raise offset by the number of recalls the previous page returned — limit, unless that page reached the response size budget. An offset at or past total_found returns an empty result set rather than an error.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "recalls": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "recall_number": {
            "type": "string",
            "description": "Recall identifier. Pass to cpsc_get_recall for full detail."
          },
          "recall_date": {
            "type": "string",
            "description": "Date issued, ISO 8601."
          },
          "title": {
            "type": "string",
            "description": "Recall title."
          },
          "hazards": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Hazard description."
            },
            "description": "What is dangerous."
          },
          "remedy_options": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Remedy type."
            },
            "description": "Remedy types: Refund, Repair, Replace, New Instructions, Dispose, Label, No Remedy Available, Inspect. Multiple may apply. Often empty — CPSC classified the remedy on fewer than half its records; call cpsc_get_recall for the remedy instructions when this is empty."
          },
          "products": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Product name."
            },
            "description": "Product names recalled."
          },
          "cpsc_url": {
            "type": "string",
            "description": "Official CPSC recall page URL."
          },
          "data_quality_notes": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "One gap found in the CPSC record."
            },
            "description": "Gaps this server observed in the CPSC record — absent hazard text, absent product entries. Derived from which fields CPSC left empty, not from any judgement about the recall itself. Empty when nothing is missing."
          }
        },
        "required": [
          "recall_number",
          "recall_date",
          "title",
          "hazards",
          "remedy_options",
          "products",
          "cpsc_url",
          "data_quality_notes"
        ],
        "additionalProperties": false,
        "description": "A recent CPSC recall."
      },
      "description": "Recent recalls, newest-first."
    },
    "period": {
      "type": "object",
      "properties": {
        "start": {
          "type": "string",
          "description": "Start date of the query window, ISO 8601."
        },
        "end": {
          "type": "string",
          "description": "End date (today), ISO 8601."
        },
        "days": {
          "type": "number",
          "description": "Window length in days."
        }
      },
      "required": [
        "start",
        "end",
        "days"
      ],
      "additionalProperties": false,
      "description": "Date range queried."
    },
    "total_found": {
      "type": "number",
      "description": "Total recalls in this period, counted before offset, limit, and the response size budget narrow the window."
    },
    "truncated": {
      "type": "boolean",
      "description": "True when recalls in the window remain past this page — always equal to has_more."
    },
    "offset": {
      "type": "number",
      "description": "Number of recalls skipped before this window."
    },
    "has_more": {
      "type": "boolean",
      "description": "True when recalls remain past this window — call again with offset raised by the number of recalls returned."
    },
    "cpsc_jurisdiction": {
      "type": "string",
      "description": "Which products CPSC covers and which agencies cover the rest — food/drugs (FDA), motor vehicles/tires (NHTSA), boats (USCG), pesticides (EPA), firearms (ATF)."
    },
    "source_note": {
      "type": "string",
      "description": "Provenance caveat: recall fields are CPSC record text with HTML markup and character codes converted to plain text, not otherwise edited or verified; check cpsc_url before a consumer-facing decision."
    },
    "notice": {
      "description": "Present when the page needs explaining: a window with no recalls (with a larger days to try), an offset past the last recall, or a page cut short by the response size budget (with the offset to continue from).",
      "type": "string"
    },
    "error": {
      "description": "Present when the call failed. Absent on success.",
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "JSON-RPC error code for this failure."
        },
        "message": {
          "type": "string",
          "description": "Human-readable description of what went wrong."
        },
        "data": {
          "type": "object",
          "properties": {
            "reason": {
              "type": "string",
              "description": "Machine-readable failure mode. Declared by this tool: `upstream_error`: The CPSC recall service (saferproducts.gov) was unavailable, timed out, reported a temporary failure reading its recall data, or sent an unreadable response. `upstream_rejected`: CPSC rejected the request instead of returning recalls, and it rejects the same request every time. Other values are possible when a failure originates below the handler.",
              "examples": [
                "upstream_error",
                "upstream_rejected"
              ]
            },
            "recovery": {
              "description": "Actionable next step for the caller.",
              "type": "object",
              "properties": {
                "hint": {
                  "type": "string"
                }
              },
              "required": [
                "hint"
              ],
              "additionalProperties": {}
            },
            "retryable": {
              "description": "Whether retrying may succeed.",
              "type": "boolean"
            }
          },
          "additionalProperties": {}
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": {}
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "anyOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "required": [
        "recalls",
        "period",
        "total_found",
        "truncated",
        "offset",
        "has_more",
        "cpsc_jurisdiction",
        "source_note"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}