cpsc-recalls-mcp-server
An MCP server that allows agents to search and retrieve US consumer product recalls from the CPSC database. It supports filtering by product, brand, retailer, hazard, and remedy, fetching full details for specific recalls, and accessing recent recall feeds.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://cpsc-recalls.caseyjhand.com/mcpWhat its tools do
3 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (3)
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Search consumer product recalls by title, product name, brand, retailer, importer, distributor, hazard, remedy, or description keyword
- Fetch full detail for a single recall by recall number including hazards, remedy, products, injuries, images, and the official CPSC page
- Fetch the most recent recalls ordered newest-first, scoped to a configurable date window
Source and maintenance
Community listingRegistry 0.3.1
- Maintenance checked
Protocol and capabilities
- Server
- cpsc-recalls-mcp-server 0.3.1
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 3 advertised
- Resources
- 1 advertised
- Resource templates
- 1 advertised
- Prompts
- 0 advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
},
"logging": {},
"prompts": {
"listChanged": true
},
"resources": {
"subscribe": true,
"listChanged": true
},
"extensions": {
"io.modelcontextprotocol/skills": {
"directoryRead": true
}
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
3 advertised
cpsc_search_recalls — Search CPSC Recalls
Advertised read-only
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 — each word as a case-insensitive substring with no stemming, so "fire" also matches fireworks and "battery" misses batteries; search a stem instead ("batter" finds battery and batteries). 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, including child-resistant packaging for drugs and supplements, ATVs and snowmobiles, bicycle tires, and gun safes and locks; food and drugs (FDA), on-road vehicles and their tires (NHTSA), boats (USCG), pesticides (EPA), and firearms (ATF) belong to other agencies.
cpsc_search_recalls input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 10000,
"minimum": 1,
"description": "Maximum number of recalls to return on this page. Defaults to 20. A page holds at most 200: a larger limit, up to 10,000, returns 200 with a notice giving the offset to continue from. A page returns fewer when it reaches the 64,000-byte response size budget; has_more then says more remain."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 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."
},
"remedy": {
"type": "string",
"maxLength": 500,
"description": "Keyword search within the free-text remedy instructions, e.g. \"repair\", \"refund\", \"firmware update\"; matches instructions containing every word, in any order, each as a case-insensitive substring with no stemming. 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."
},
"date_end": {
"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\"."
}
],
"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."
},
"importer": {
"type": "string",
"maxLength": 500,
"description": "Importer company name. Matches recalls whose importer names contain every word, in any order, each as a case-insensitive substring with no stemming. Use when searching for recalls by the company that brought the product into the US."
},
"retailer": {
"type": "string",
"maxLength": 500,
"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, each as a case-insensitive substring with no stemming."
},
"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\"."
}
],
"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."
},
"distributor": {
"type": "string",
"maxLength": 500,
"description": "Distributor company name, e.g. \"Walmart\", \"Costco\". Matches recalls whose distributor names contain every word, in any order, each as a case-insensitive substring with no stemming — a role distinct from retailer and importer, and listed on far fewer recalls."
},
"updated_end": {
"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\"."
}
],
"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."
},
"manufacturer": {
"type": "string",
"maxLength": 500,
"description": "Manufacturer name, e.g. \"Samsung\", \"LEGO\". Matches recalls whose manufacturer names contain every word, in any order, each as a case-insensitive substring with no stemming. Many recalls name the importer, retailer, or distributor rather than the manufacturer — try those filters when this finds nothing."
},
"product_name": {
"type": "string",
"maxLength": 500,
"description": "Product name to search for, e.g. \"crib\", \"space heater\", \"bicycle\". Matches recalls whose product names contain every word, in any order, each as a case-insensitive substring with no stemming — partial words work."
},
"title_search": {
"type": "string",
"maxLength": 500,
"description": "Keyword search within the recall title, e.g. \"chandelier\", \"space heater\", \"Graco crib\". Matches titles containing every word, in any order, each as a case-insensitive substring with no stemming. CPSC titles name the brand, the product, and the hazard, which makes this the highest-signal single filter for most searches."
},
"hazard_search": {
"type": "string",
"maxLength": 500,
"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, as a case-insensitive substring with no stemming. The filter to use for hazard types; combine it with another filter to narrow a broad hazard."
},
"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\"."
}
],
"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."
},
"description_search": {
"type": "string",
"maxLength": 500,
"description": "Keyword search within the recall description only — not the title, hazard text, or remedy instructions; matches descriptions containing every word, in any order, each as a case-insensitive substring with no stemming. 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."
}
},
"additionalProperties": false
}cpsc_search_recalls output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"recalls",
"total_found",
"truncated",
"offset",
"has_more",
"cpsc_jurisdiction",
"source_note",
"effectiveQuery"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"missing_criteria",
"invalid_date_range",
"upstream_error",
"upstream_rejected"
],
"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."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"notice": {
"type": "string",
"description": "Present when the page needs explaining: zero matches (with which criterion to relax), an offset past the last match, a page cut short by the response size budget, or a page held to 200 recalls under a larger limit (each with the offset to continue from)."
},
"offset": {
"type": "number",
"description": "Number of matching records skipped before this window."
},
"recalls": {
"type": "array",
"items": {
"type": "object",
"required": [
"recall_number",
"recall_date",
"last_updated",
"title",
"hazards",
"remedy_options",
"remedy_summary",
"products",
"upcs",
"manufacturers",
"importers",
"retailers",
"distributors",
"cpsc_url",
"images",
"data_quality_notes"
],
"properties": {
"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."
},
"title": {
"type": "string",
"description": "Official recall title."
},
"images": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"caption"
],
"properties": {
"url": {
"type": "string",
"description": "Image URL."
},
"caption": {
"type": "string",
"description": "Image caption."
}
},
"description": "An image from the recall notice.",
"additionalProperties": false
},
"description": "Product images from the recall notice."
},
"hazards": {
"type": "array",
"items": {
"type": "string",
"description": "Hazard description — what is dangerous."
},
"description": "Hazard descriptions — what is dangerous about this product."
},
"cpsc_url": {
"type": "string",
"description": "Official CPSC recall page URL for human verification."
},
"products": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"units_recalled"
],
"properties": {
"name": {
"type": "string",
"description": "Product name."
},
"units_recalled": {
"type": "string",
"description": "Estimated number of units recalled, e.g. \"About 2,500\"."
}
},
"description": "A product covered by this recall.",
"additionalProperties": false
},
"description": "Products covered by this recall. A recall may cover multiple products."
},
"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)."
},
"recall_date": {
"type": "string",
"description": "Date the recall was issued, ISO 8601."
},
"distributors": {
"type": "array",
"items": {
"type": "string",
"description": "Distributor name."
},
"description": "Distributor company names."
},
"last_updated": {
"type": "string",
"description": "Date last published, ISO 8601."
},
"manufacturers": {
"type": "array",
"items": {
"type": "string",
"description": "Manufacturer name."
},
"description": "Manufacturer names. Often empty — importer or retailer may be listed instead."
},
"recall_number": {
"type": "string",
"description": "Recall identifier: 5 digits, e.g. \"25043\", with a letter a–d on some 1998–2001 records, e.g. \"99003a\". Pass to cpsc_get_recall for full detail."
},
"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."
},
"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."
}
},
"description": "A CPSC recall record.",
"additionalProperties": false
},
"description": "Matching recalls, ordered newest-first."
},
"has_more": {
"type": "boolean",
"description": "True when records remain past this window — call again with offset raised by the number of recalls returned."
},
"truncated": {
"type": "boolean",
"description": "True when matching records remain past this page — always equal to has_more."
},
"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."
},
"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."
},
"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."
},
"cpsc_jurisdiction": {
"type": "string",
"description": "Which products CPSC covers, including those near the lines of other agencies, and which agencies own food and drugs (FDA), on-road vehicles and their tires (NHTSA), boats (USCG), pesticides (EPA), and firearms (ATF), with a reminder to search here before routing such a product away."
}
},
"additionalProperties": false
}cpsc_search_recalls annotations
{
"readOnlyHint": true,
"idempotentHint": true
}cpsc_get_recall — Get CPSC Recall Detail
Advertised read-only
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, including child-resistant packaging for drugs and supplements, ATVs and snowmobiles, bicycle tires, and gun safes and locks; food and drugs (FDA), on-road vehicles and their tires (NHTSA), boats (USCG), pesticides (EPA), and firearms (ATF) belong to other agencies.
cpsc_get_recall input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"recall_number"
],
"properties": {
"recall_number": {
"type": "string",
"pattern": "^\\d{5}([a-d])?$",
"description": "CPSC recall number: 5 digits, e.g. \"25043\", with a letter a–d on some 1998–2001 records, e.g. \"99003a\". Get one from cpsc_search_recalls or cpsc_get_recent results."
}
},
"additionalProperties": false
}cpsc_get_recall output schema
{
"type": "object",
"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"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"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."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"not_found",
"upstream_error",
"upstream_rejected"
],
"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."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"title": {
"type": "string",
"description": "Official recall title."
},
"images": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"caption"
],
"properties": {
"url": {
"type": "string",
"description": "Image URL."
},
"caption": {
"type": "string",
"description": "Caption describing what the image shows."
}
},
"description": "An image from the recall notice.",
"additionalProperties": false
},
"description": "Product and identification images from the recall notice."
},
"hazards": {
"type": "array",
"items": {
"type": "object",
"required": [
"description"
],
"properties": {
"description": {
"type": "string",
"description": "What is dangerous about this product."
}
},
"description": "A hazard associated with this recall.",
"additionalProperties": false
},
"description": "Hazards — read this first."
},
"cpsc_url": {
"type": "string",
"description": "Official CPSC recall page — authoritative source for consumers."
},
"injuries": {
"type": "string",
"description": "Injury and incident report narrative, e.g. \"None reported\" or incident count."
},
"products": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"units_recalled"
],
"properties": {
"name": {
"type": "string",
"description": "Product name."
},
"units_recalled": {
"type": "string",
"description": "Estimated number of units recalled, e.g. \"About 2,500\"."
}
},
"description": "A product covered by this recall.",
"additionalProperties": false
},
"description": "Products covered. A recall may include multiple products. Model numbers are often in the description text, not a structured field."
},
"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."
},
"description": {
"type": [
"string",
"null"
],
"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."
},
"recall_date": {
"type": "string",
"description": "Date issued, ISO 8601."
},
"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."
},
"distributors": {
"type": "array",
"items": {
"type": "string",
"description": "Distributor name."
},
"description": "Distributor company names."
},
"last_updated": {
"type": "string",
"description": "Date last published, ISO 8601."
},
"manufacturers": {
"type": "array",
"items": {
"type": "string",
"description": "Manufacturer name."
},
"description": "Manufacturer names (often empty — see importers)."
},
"recall_number": {
"type": "string",
"description": "Recall identifier."
},
"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."
},
"consumer_contact": {
"type": [
"string",
"null"
],
"description": "Contact information for claiming the remedy. Null when not provided."
},
"cpsc_jurisdiction": {
"type": "string",
"description": "Which products CPSC covers, including those near the lines of other agencies, and which agencies own food and drugs (FDA), on-road vehicles and their tires (NHTSA), boats (USCG), pesticides (EPA), and firearms (ATF)."
},
"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."
},
"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)."
},
"remedy_instructions": {
"type": "string",
"description": "Full remedy instructions — exactly what a consumer should do and how to claim."
},
"manufacturer_countries": {
"type": "array",
"items": {
"type": "string",
"description": "Country of manufacture."
},
"description": "Countries of manufacture."
}
},
"additionalProperties": false
}cpsc_get_recall annotations
{
"readOnlyHint": true,
"idempotentHint": true
}cpsc_get_recent — Get Recent CPSC Recalls
Advertised read-only
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, including child-resistant packaging for drugs and supplements, ATVs and snowmobiles, bicycle tires, and gun safes and locks; food and drugs (FDA), on-road vehicles and their tires (NHTSA), boats (USCG), pesticides (EPA), and firearms (ATF) belong to other agencies.
cpsc_get_recent input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"days": {
"type": "integer",
"default": 30,
"maximum": 365,
"minimum": 1,
"description": "Look back this many days from today. Defaults to 30. Use 7 for a weekly digest, 90 for a quarterly review."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 10000,
"minimum": 1,
"description": "Maximum number of recalls to return. Defaults to 20. A page holds at most 100: a larger limit, up to 10,000, returns 100 with a notice giving the offset to continue from. A page returns fewer when it reaches the 64,000-byte response size budget."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 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."
}
},
"additionalProperties": false
}cpsc_get_recent output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"recalls",
"period",
"total_found",
"truncated",
"offset",
"has_more",
"cpsc_jurisdiction",
"source_note"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"upstream_error",
"upstream_rejected"
],
"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."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"notice": {
"type": "string",
"description": "Present when the page needs explaining: a window with no recalls (with a larger days to try), an offset past the last recall, a page cut short by the response size budget, or a page held to 100 recalls under a larger limit (each with the offset to continue from)."
},
"offset": {
"type": "number",
"description": "Number of recalls skipped before this window."
},
"period": {
"type": "object",
"required": [
"start",
"end",
"days"
],
"properties": {
"end": {
"type": "string",
"description": "End date (today), ISO 8601."
},
"days": {
"type": "number",
"description": "Window length in days."
},
"start": {
"type": "string",
"description": "Start date of the query window, ISO 8601."
}
},
"description": "Date range queried.",
"additionalProperties": false
},
"recalls": {
"type": "array",
"items": {
"type": "object",
"required": [
"recall_number",
"recall_date",
"title",
"hazards",
"remedy_options",
"products",
"cpsc_url",
"data_quality_notes"
],
"properties": {
"title": {
"type": "string",
"description": "Recall title."
},
"hazards": {
"type": "array",
"items": {
"type": "string",
"description": "Hazard description."
},
"description": "What is dangerous."
},
"cpsc_url": {
"type": "string",
"description": "Official CPSC recall page URL."
},
"products": {
"type": "array",
"items": {
"type": "string",
"description": "Product name."
},
"description": "Product names recalled."
},
"recall_date": {
"type": "string",
"description": "Date issued, ISO 8601."
},
"recall_number": {
"type": "string",
"description": "Recall identifier. Pass to cpsc_get_recall for full detail."
},
"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."
},
"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."
}
},
"description": "A recent CPSC recall.",
"additionalProperties": false
},
"description": "Recent recalls, newest-first."
},
"has_more": {
"type": "boolean",
"description": "True when recalls remain past this window — call again with offset raised by the number of recalls returned."
},
"truncated": {
"type": "boolean",
"description": "True when recalls in the window remain past this page — always equal to has_more."
},
"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."
},
"total_found": {
"type": "number",
"description": "Total recalls in this period, counted before offset, limit, and the response size budget narrow the window."
},
"cpsc_jurisdiction": {
"type": "string",
"description": "Which products CPSC covers, including those near the lines of other agencies, and which agencies own food and drugs (FDA), on-road vehicles and their tires (NHTSA), boats (USCG), pesticides (EPA), and firearms (ATF)."
}
},
"additionalProperties": false
}cpsc_get_recent annotations
{
"readOnlyHint": true
}Prompts
0 advertised
Resources
1 advertised
cpsc-recalls-guide
Find and confirm US consumer product recalls with the cpsc_* tools. Use when checking whether a specific product, model, serial, or UPC was recalled, sweeping a brand's or retailer's recall history, monitoring new or republished recalls for a hazard, or deciding whether a product is CPSC's at all. Covers search formulation, recall-number quirks, and when an empty result proves nothing.
cpsc-recalls-guide URI
skill://cpsc-recalls-guide/SKILL.mdio.modelcontextprotocol/skills
io.modelcontextprotocol/skills URI template
skill://{+path}30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 767 ms
- 95th percentile latency
- 767 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 767 ms · metadata changed · 3 tool(s), 1 resource(s), 1 resource template(s), 0 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http cpsc-recalls-mcp-server-caseyjhand https://cpsc-recalls.caseyjhand.com/mcpCodex
Codex configuration
codex mcp add cpsc-recalls-mcp-server-caseyjhand --url https://cpsc-recalls.caseyjhand.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"cpsc-recalls-mcp-server-caseyjhand": {
"url": "https://cpsc-recalls.caseyjhand.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"cpsc-recalls-mcp-server-caseyjhand": {
"type": "streamableHttp",
"url": "https://cpsc-recalls.caseyjhand.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"cpsc-recalls-mcp-server-caseyjhand": {
"type": "http",
"url": "https://cpsc-recalls.caseyjhand.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http cpsc-recalls-mcp-server-caseyjhand https://cpsc-recalls.caseyjhand.com/mcpClaude Desktop
Claude Desktop configuration
https://cpsc-recalls.caseyjhand.com/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"cpsc-recalls-mcp-server-caseyjhand": {
"serverUrl": "https://cpsc-recalls.caseyjhand.com/mcp"
}
}
}Let your agent find its tools
Find servers like cpsc-recalls-mcp-server from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.