Recall Kitchen is an MCP server published by io.github.adamdecaf, hosted at app.recallkitchen.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 20 tools, including add_inventory_product, add_watch_pattern, check_tracked_products, create_api_key, get_product_recall.
US recalls MCP: free API key/signup or x402 $0.025 Base; some tools need key; verify↑limits
65 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Add a product to this API key's inventory. Optional category is food, beverage, baby, household, electronics, vehicle, medical_device, drug, cosmetics, pet, or other. Requires a verified account (sign in at https://app.recallkitchen.com with the signup email). Unverified signup keys cannot add inventory.
| Parameter | Type | Description |
|---|---|---|
| sku | string | optional SKU or UPC |
| name * | string | product name |
| brand | string | optional brand |
| category | string | optional product category: food, beverage, baby, household, electronics, vehicle, medical_device, drug, cosmetics, pet, or other |
{
"name": "add_inventory_product",
"description": "Add a product to this API key's inventory. Optional category is food, beverage, baby, household, electronics, vehicle, medical_device, drug, cosmetics, pet, or other. Requires a verified account (sign in at https://app.recallkitchen.com with the signup email). Unverified signup keys cannot add inventory.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"sku": {
"type": "string",
"description": "optional SKU or UPC"
},
"name": {
"type": "string",
"description": "product name"
},
"brand": {
"type": "string",
"description": "optional brand"
},
"category": {
"enum": [
"food",
"beverage",
"baby",
"household",
"electronics",
"vehicle",
"medical_device",
"drug",
"cosmetics",
"pet",
"other"
],
"type": "string",
"description": "optional product category: food, beverage, baby, household, electronics, vehicle, medical_device, drug, cosmetics, pet, or other"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"id",
"name",
"brand",
"category",
"sku"
],
"properties": {
"id": {
"type": "integer"
},
"sku": {
"type": "string"
},
"name": {
"type": "string"
},
"brand": {
"type": "string"
},
"category": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Add a recall watch pattern for this API key. Same websearch syntax as search_product_recalls (AND, OR, -exclude, quoted phrases). New matches show up in Recall Kitchen. Requires an API key.
| Parameter | Type | Description |
|---|---|---|
| weight | integer | optional weight 0-8, default 4 |
| pattern * | string | websearch pattern: unquoted words are AND, OR is or, -term excludes, quoted phrases match as a unit |
{
"name": "add_watch_pattern",
"description": "Add a recall watch pattern for this API key. Same websearch syntax as search_product_recalls (AND, OR, -exclude, quoted phrases). New matches show up in Recall Kitchen. Requires an API key.",
"inputSchema": {
"type": "object",
"required": [
"pattern"
],
"properties": {
"weight": {
"type": "integer",
"maximum": 8,
"minimum": 0,
"description": "optional weight 0-8, default 4"
},
"pattern": {
"type": "string",
"description": "websearch pattern: unquoted words are AND, OR is or, -term excludes, quoted phrases match as a unit"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"pattern",
"weight"
],
"properties": {
"weight": {
"type": "integer"
},
"pattern": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Check this API key's watch patterns and inventory against current indexed recalls (including historical notices). Does not create notifications. Generic patterns such as food or hazard only match in titles. Requires an API key.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | maximum matches to return |
| offset | integer | number of matches to skip |
{
"name": "check_tracked_products",
"description": "Check this API key's watch patterns and inventory against current indexed recalls (including historical notices). Does not create notifications. Generic patterns such as food or hazard only match in titles. Requires an API key.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 3,
"maximum": 100,
"minimum": 1,
"description": "maximum matches to return"
},
"offset": {
"type": "integer",
"maximum": 100,
"minimum": 0,
"description": "number of matches to skip"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"matches",
"offset"
],
"properties": {
"offset": {
"type": "integer"
},
"matches": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"recall",
"reasons"
],
"properties": {
"recall": {
"type": "object",
"required": [
"id",
"source",
"title",
"description",
"url",
"publishedOn"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"source": {
"type": "string"
},
"status": {
"type": "string"
},
"extracted": {
"type": [
"null",
"object"
],
"properties": {
"images": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"stores": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"contact": {
"type": [
"null",
"object"
],
"properties": {
"emails": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"phones": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"websites": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"products": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"upcs": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"lotCodes": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"packaging": {
"type": "string"
},
"useByDates": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"productName": {
"type": "string"
},
"modelNumbers": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"locations": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"establishments": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"productsTruncated": {
"type": "boolean"
}
},
"additionalProperties": false
},
"description": {
"type": "string"
},
"publishedOn": {
"type": "string"
},
"descriptionTruncated": {
"type": "boolean"
}
},
"additionalProperties": false
},
"reasons": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"patterns": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"inventory": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"id",
"name",
"brand",
"category",
"sku"
],
"properties": {
"id": {
"type": "integer"
},
"sku": {
"type": "string"
},
"name": {
"type": "string"
},
"brand": {
"type": "string"
},
"category": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"message": {
"type": "string"
},
"nextOffset": {
"type": [
"null",
"integer"
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create an additional API key for this account. Requires an existing API key. Unverified accounts may have only one key; verified accounts may have three. Usage is counted per account, not per key.
| Parameter | Type | Description |
|---|---|---|
| kind | string | optional kind: user or agent, default agent |
| name | string | optional key name |
{
"name": "create_api_key",
"description": "Create an additional API key for this account. Requires an existing API key. Unverified accounts may have only one key; verified accounts may have three. Usage is counted per account, not per key.",
"inputSchema": {
"type": "object",
"properties": {
"kind": {
"enum": [
"user",
"agent"
],
"type": "string",
"description": "optional kind: user or agent, default agent"
},
"name": {
"type": "string",
"description": "optional key name"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"key_id",
"name",
"kind",
"api_key",
"limits",
"message"
],
"properties": {
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"key_id": {
"type": "string"
},
"limits": {
"type": "object",
"required": [
"hourly",
"daily",
"max_keys_per_user",
"max_watch_patterns",
"max_inventory",
"allow_account_writes",
"tier"
],
"properties": {
"tier": {
"type": "string"
},
"daily": {
"type": "integer"
},
"hourly": {
"type": "integer"
},
"max_inventory": {
"type": "integer"
},
"max_keys_per_user": {
"type": "integer"
},
"max_watch_patterns": {
"type": "integer"
},
"allow_account_writes": {
"type": "boolean"
}
},
"additionalProperties": false
},
"api_key": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Get a recall by id, including extracted lots, UPCs, model numbers, locations, contact info, and product photo URLs
| Parameter | Type | Description |
|---|---|---|
| id | string | alias for recall_id |
| recall_id | string | recall id returned by search tools |
{
"name": "get_product_recall",
"description": "Get a recall by id, including extracted lots, UPCs, model numbers, locations, contact info, and product photo URLs",
"inputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "alias for recall_id"
},
"recall_id": {
"type": "string",
"description": "recall id returned by search tools"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"id",
"source",
"title",
"description",
"url",
"publishedOn"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"source": {
"type": "string"
},
"status": {
"type": "string"
},
"extracted": {
"type": [
"null",
"object"
],
"properties": {
"images": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"stores": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"contact": {
"type": [
"null",
"object"
],
"properties": {
"emails": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"phones": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"websites": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"products": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"upcs": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"lotCodes": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"packaging": {
"type": "string"
},
"useByDates": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"productName": {
"type": "string"
},
"modelNumbers": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"locations": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"establishments": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"productsTruncated": {
"type": "boolean"
}
},
"additionalProperties": false
},
"description": {
"type": "string"
},
"publishedOn": {
"type": "string"
},
"descriptionTruncated": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Report a bug, missing capability, bad search result, or confusing schema to the Recall Kitchen team. Use this instead of silently working around a problem. message is required and should include the MCP tool names you called, the actions you took, the query or identifiers, and any recall_id. Do not send API keys, photos, or PII. Optional category: bad_result, tool_error, missing_capability, confusing_schema, docs, other. Optional severity: blocked, workaround, annoyance. No API key or x402 required. Does not count against search quotas.
| Parameter | Type | Description |
|---|---|---|
| message * | string | describe the problem. Include the MCP tool names you called, the actions you took, the query or identifiers, and any recall_id. Do not send API keys, photos, or PII. |
| category | string | optional: bad_result, tool_error, missing_capability, confusing_schema, docs, or other |
| severity | string | optional: blocked, workaround, or annoyance |
{
"name": "give_feedback",
"description": "Report a bug, missing capability, bad search result, or confusing schema to the Recall Kitchen team. Use this instead of silently working around a problem. message is required and should include the MCP tool names you called, the actions you took, the query or identifiers, and any recall_id. Do not send API keys, photos, or PII. Optional category: bad_result, tool_error, missing_capability, confusing_schema, docs, other. Optional severity: blocked, workaround, annoyance. No API key or x402 required. Does not count against search quotas.",
"inputSchema": {
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string",
"description": "describe the problem. Include the MCP tool names you called, the actions you took, the query or identifiers, and any recall_id. Do not send API keys, photos, or PII."
},
"category": {
"enum": [
"bad_result",
"tool_error",
"missing_capability",
"confusing_schema",
"docs",
"other"
],
"type": "string",
"description": "optional: bad_result, tool_error, missing_capability, confusing_schema, docs, or other"
},
"severity": {
"enum": [
"blocked",
"workaround",
"annoyance"
],
"type": "string",
"description": "optional: blocked, workaround, or annoyance"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"accepted",
"message"
],
"properties": {
"message": {
"type": "string"
},
"accepted": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}List this account's API keys (id, name, prefix, created). Secrets are not shown. Requires an API key.
No parameters.
{
"name": "list_api_keys",
"description": "List this account's API keys (id, name, prefix, created). Secrets are not shown. Requires an API key.",
"inputSchema": {
"type": "object",
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"keys",
"limits"
],
"properties": {
"keys": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"key_id",
"name",
"kind",
"key_prefix",
"created_at"
],
"properties": {
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"key_id": {
"type": "string"
},
"created_at": {
"type": "string"
},
"key_prefix": {
"type": "string"
},
"last_used_at": {
"type": [
"null",
"string"
]
}
},
"additionalProperties": false
}
},
"limits": {
"type": "object",
"required": [
"hourly",
"daily",
"max_keys_per_user",
"max_watch_patterns",
"max_inventory",
"allow_account_writes",
"tier"
],
"properties": {
"tier": {
"type": "string"
},
"daily": {
"type": "integer"
},
"hourly": {
"type": "integer"
},
"max_inventory": {
"type": "integer"
},
"max_keys_per_user": {
"type": "integer"
},
"max_watch_patterns": {
"type": "integer"
},
"allow_account_writes": {
"type": "boolean"
}
},
"additionalProperties": false
},
"message": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List this API key's tracked inventory products. Requires an API key.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | number of products to return |
| query | string | optional inventory search |
| offset | integer | number of products to skip |
{
"name": "list_inventory",
"description": "List this API key's tracked inventory products. Requires an API key.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 3,
"maximum": 100,
"minimum": 1,
"description": "number of products to return"
},
"query": {
"type": "string",
"description": "optional inventory search"
},
"offset": {
"type": "integer",
"maximum": 100,
"minimum": 0,
"description": "number of products to skip"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"products",
"offset"
],
"properties": {
"offset": {
"type": "integer"
},
"products": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"id",
"name",
"brand",
"category",
"sku"
],
"properties": {
"id": {
"type": "integer"
},
"sku": {
"type": "string"
},
"name": {
"type": "string"
},
"brand": {
"type": "string"
},
"category": {
"type": "string"
}
},
"additionalProperties": false
}
},
"nextOffset": {
"type": [
"null",
"integer"
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List recall notifications for this API key. unread defaults to true (unread only); pass false for all. New matches show up in Recall Kitchen. Empty for new accounts until a new matching recall is published; not a backfill of check_tracked_products. message is a short plain-text summary. Requires an API key.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | number of notifications to return |
| offset | integer | number of notifications to skip |
| unread | ["null","boolean"] | if true, only unread notifications; if false, include read. Default: true (unread only) |
{
"name": "list_recall_notifications",
"description": "List recall notifications for this API key. unread defaults to true (unread only); pass false for all. New matches show up in Recall Kitchen. Empty for new accounts until a new matching recall is published; not a backfill of check_tracked_products. message is a short plain-text summary. Requires an API key.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 3,
"maximum": 100,
"minimum": 1,
"description": "number of notifications to return"
},
"offset": {
"type": "integer",
"maximum": 100,
"minimum": 0,
"description": "number of notifications to skip"
},
"unread": {
"type": [
"null",
"boolean"
],
"description": "if true, only unread notifications; if false, include read. Default: true (unread only)"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"notifications",
"offset"
],
"properties": {
"offset": {
"type": "integer"
},
"message": {
"type": "string"
},
"nextOffset": {
"type": [
"null",
"integer"
]
},
"notifications": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"recall",
"sentOn",
"read"
],
"properties": {
"read": {
"type": "boolean"
},
"recall": {
"type": "object",
"required": [
"id",
"source",
"title",
"description",
"url",
"publishedOn"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"source": {
"type": "string"
},
"status": {
"type": "string"
},
"extracted": {
"type": [
"null",
"object"
],
"properties": {
"images": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"stores": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"contact": {
"type": [
"null",
"object"
],
"properties": {
"emails": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"phones": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"websites": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"products": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"upcs": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"lotCodes": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"packaging": {
"type": "string"
},
"useByDates": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"productName": {
"type": "string"
},
"modelNumbers": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"locations": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"establishments": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"productsTruncated": {
"type": "boolean"
}
},
"additionalProperties": false
},
"description": {
"type": "string"
},
"publishedOn": {
"type": "string"
},
"descriptionTruncated": {
"type": "boolean"
}
},
"additionalProperties": false
},
"sentOn": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List this API key's recall watch patterns. Requires an API key.
No parameters.
{
"name": "list_watch_patterns",
"description": "List this API key's recall watch patterns. Requires an API key.",
"inputSchema": {
"type": "object",
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"patterns"
],
"properties": {
"patterns": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"pattern",
"weight"
],
"properties": {
"weight": {
"type": "integer"
},
"pattern": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Look up a product by UPC/EAN. Returns found=false when unknown. Does not search recalls.
| Parameter | Type | Description |
|---|---|---|
| upc * | string | UPC or EAN barcode digits |
{
"name": "lookup_product",
"description": "Look up a product by UPC/EAN. Returns found=false when unknown. Does not search recalls.",
"inputSchema": {
"type": "object",
"required": [
"upc"
],
"properties": {
"upc": {
"type": "string",
"description": "UPC or EAN barcode digits"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"upc",
"found"
],
"properties": {
"upc": {
"type": "string"
},
"hint": {
"type": "string"
},
"found": {
"type": "boolean"
},
"product": {
"type": [
"null",
"object"
],
"properties": {
"sku": {
"type": "string"
},
"upc": {
"type": "string"
},
"name": {
"type": "string"
},
"brand": {
"type": "string"
},
"format": {
"type": "string"
},
"category": {
"type": "string"
}
},
"additionalProperties": false
},
"branded_food": {
"type": [
"null",
"object"
],
"properties": {
"category": {
"type": "string"
},
"gtin_upc": {
"type": "string"
},
"brand_name": {
"type": "string"
},
"brand_owner": {
"type": "string"
},
"ingredients": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Mark a recall notification as read (default) or unread. Requires an API key.
| Parameter | Type | Description |
|---|---|---|
| read | ["null","boolean"] | if true, mark read; if false, mark unread. Default true |
| recall_id * | string | recall id from list_recall_notifications |
{
"name": "mark_notification_read",
"description": "Mark a recall notification as read (default) or unread. Requires an API key.",
"inputSchema": {
"type": "object",
"required": [
"recall_id"
],
"properties": {
"read": {
"type": [
"null",
"boolean"
],
"description": "if true, mark read; if false, mark unread. Default true"
},
"recall_id": {
"type": "string",
"description": "recall id from list_recall_notifications"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"recall_id",
"read",
"updated"
],
"properties": {
"read": {
"type": "boolean"
},
"updated": {
"type": "boolean"
},
"recall_id": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Remove a product from this API key's inventory by id. Requires an API key.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | inventory product id from list_inventory |
{
"name": "remove_inventory_product",
"description": "Remove a product from this API key's inventory by id. Requires an API key.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"description": "inventory product id from list_inventory"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"id",
"removed"
],
"properties": {
"id": {
"type": "integer"
},
"removed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Remove a recall watch pattern for this API key. Requires an API key.
| Parameter | Type | Description |
|---|---|---|
| pattern * | string | watch pattern to remove |
{
"name": "remove_watch_pattern",
"description": "Remove a recall watch pattern for this API key. Requires an API key.",
"inputSchema": {
"type": "object",
"required": [
"pattern"
],
"properties": {
"pattern": {
"type": "string",
"description": "watch pattern to remove"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"pattern",
"removed"
],
"properties": {
"pattern": {
"type": "string"
},
"removed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Revoke an API key by key_id from list_api_keys. Requires an API key. Revoking the current key will fail subsequent calls.
| Parameter | Type | Description |
|---|---|---|
| key_id * | string | key_id from list_api_keys |
{
"name": "revoke_api_key",
"description": "Revoke an API key by key_id from list_api_keys. Requires an API key. Revoking the current key will fail subsequent calls.",
"inputSchema": {
"type": "object",
"required": [
"key_id"
],
"properties": {
"key_id": {
"type": "string",
"description": "key_id from list_api_keys"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"key_id",
"revoked"
],
"properties": {
"key_id": {
"type": "string"
},
"revoked": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Search product recalls by query. Query uses websearch syntax: unquoted words are AND, OR is or, -term excludes, quoted phrases match as a unit (example: Generac Generator -Portable). Optional filters: source (cpsc, fdafoodsafety, FDAMedWatch, usda, nhtsa, canada, openfda), since/until (YYYY-MM-DD), location (country, region, or place, ANDed with the query), offset, limit. Descriptions are truncated and extracted products are capped; use get_product_recall for the full text.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | number of recalls to return, 1-100, default 3 |
| query | string | websearch query: unquoted words are AND, OR is or, -term excludes, quoted phrases match as a unit. Example: Generac Generator -Portable |
| since | string | optional published-on start date YYYY-MM-DD |
| until | string | optional published-on end date YYYY-MM-DD |
| years | integer | optional published window in years (1-50). Ignored when since is set |
| offset | integer | number of recalls to skip |
| source | string | optional source filter: cpsc, fdafoodsafety, FDAMedWatch, usda, nhtsa, canada, or openfda. Aliases: FDA and food map to fdafoodsafety; medwatch maps to FDAMedWatch; vehicle, vin, and car map to nhtsa; healthcanada, cfia, and hc-sc map to canada; enforcement, res, and fdaenforcement map to openfda. F… |
| sources |
Search recalls by UPC/EAN or a barcode image URL/data URI/MCP image content. Matches extracted recall UPCs first. Returns found=false when the UPC is unknown.
| Parameter | Type | Description |
|---|---|---|
| upc | string | UPC or EAN barcode digits |
| url | string | alias for image_url |
| limit | integer | number of recalls to return, 1-100, default 3 |
| offset | integer | number of recalls to skip |
| barcode | string | alias for upc |
| image_url | string | optional HTTPS URL or data:image/...;base64 URI of a barcode image |
{
"name": "search_product_recalls_by_upc",
"description": "Search recalls by UPC/EAN or a barcode image URL/data URI/MCP image content. Matches extracted recall UPCs first. Returns found=false when the UPC is unknown.",
"inputSchema": {
"type": "object",
"properties": {
"upc": {
"type": "string",
"description": "UPC or EAN barcode digits"
},
"url": {
"type": "string",
"description": "alias for image_url"
},
"limit": {
"type": "integer",
"default": 3,
"maximum": 100,
"minimum": 1,
"description": "number of recalls to return, 1-100, default 3"
},
"offset": {
"type": "integer",
"maximum": 100,
"minimum": 0,
"description": "number of recalls to skip"
},
"barcode": {
"type": "string",
"description": "alias for upc"
},
"image_url": {
"type": "string",
"description": "optional HTTPS URL or data:image/...;base64 URI of a barcode image"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"upc",
"found",
"recalls",
"offset"
],
"properties": {
"upc": {
"type": "string"
},
"hint": {
"type": "string"
},
"found": {
"type": "boolean"
},
"match": {
"type": "string"
},
"offset": {
"type": "integer"
},
"product": {
"type": [
"null",
"object"
],
"properties": {
"sku": {
"type": "string"
},
"upc": {
"type": "string"
},
"name": {
"type": "string"
},
"brand": {
"type": "string"
},
"format": {
"type": "string"
},
"category": {
"type": "string"
}
},
"additionalProperties": false
},
"recalls": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"id",
"source",
"title",
"description",
"url",
"publishedOn"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"source": {
"type": "string"
},
"status": {
"type": "string"
},
"extracted": {
"type": [
"null",
"object"
],
"properties": {
"images": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"stores": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"contact": {
"type": [
"null",
"object"
],
"properties": {
"emails": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"phones": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"websites": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"products": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"upcs": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"lotCodes": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"packaging": {
"type": "string"
},
"useByDates": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"productName": {
"type": "string"
},
"modelNumbers": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"locations": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"establishments": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"productsTruncated": {
"type": "boolean"
}
},
"additionalProperties": false
},
"description": {
"type": "string"
},
"publishedOn": {
"type": "string"
},
"descriptionTruncated": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "number"
},
"nextOffset": {
"type": [
"null",
"integer"
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Photo (beta): identify products in a public HTTPS image URL, data:image/...;base64 URI, or MCP image content part. Local files are not supported. Each product includes match (upc, model, text, category) and confidence. Category matches omit recalls unless include_category_matches=true. Requires an API key or x402; not included in the free anonymous per-IP quota.
| Parameter | Type | Description |
|---|---|---|
| url | string | alias for image_url |
| limit | integer | number of recalls to return per product, 1-100, default 3 |
| image_url | string | photo (beta). HTTPS URL or data:image/...;base64 URI of a photo containing products. Local file paths are not supported. |
| include_category_matches | boolean | if true, attach keyword recalls for generic items such as cups; default false |
{
"name": "search_product_recalls_from_image",
"description": "Photo (beta): identify products in a public HTTPS image URL, data:image/...;base64 URI, or MCP image content part. Local files are not supported. Each product includes match (upc, model, text, category) and confidence. Category matches omit recalls unless include_category_matches=true. Requires an API key or x402; not included in the free anonymous per-IP quota.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "alias for image_url"
},
"limit": {
"type": "integer",
"default": 3,
"maximum": 100,
"minimum": 1,
"description": "number of recalls to return per product, 1-100, default 3"
},
"image_url": {
"type": "string",
"description": "photo (beta). HTTPS URL or data:image/...;base64 URI of a photo containing products. Local file paths are not supported."
},
"include_category_matches": {
"type": "boolean",
"description": "if true, attach keyword recalls for generic items such as cups; default false"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"products",
"recalls"
],
"properties": {
"recalls": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"id",
"source",
"title",
"description",
"url",
"publishedOn"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"source": {
"type": "string"
},
"status": {
"type": "string"
},
"extracted": {
"type": [
"null",
"object"
],
"properties": {
"images": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"stores": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"contact": {
"type": [
"null",
"object"
],
"properties": {
"emails": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"phones": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"websites": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"products": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"upcs": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"lotCodes": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"packaging": {
"type": "string"
},
"useByDates": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"productName": {
"type": "string"
},
"modelNumbers": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"locations": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"establishments": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"productsTruncated": {
"type": "boolean"
}
},
"additionalProperties": false
},
"description": {
"type": "string"
},
"publishedOn": {
"type": "string"
},
"descriptionTruncated": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"products": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"product",
"match",
"confidence",
"recalls"
],
"properties": {
"match": {
"type": "string"
},
"product": {
"type": "object",
"properties": {
"sku": {
"type": "string"
},
"upc": {
"type": "string"
},
"name": {
"type": "string"
},
"brand": {
"type": "string"
},
"format": {
"type": "string"
},
"category": {
"type": "string"
}
},
"additionalProperties": false
},
"recalls": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"id",
"source",
"title",
"description",
"url",
"publishedOn"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"source": {
"type": "string"
},
"status": {
"type": "string"
},
"extracted": {
"type": [
"null",
"object"
],
"properties": {
"images": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"stores": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"contact": {
"type": [
"null",
"object"
],
"properties": {
"emails": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"phones": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"websites": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"products": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"upcs": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"lotCodes": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"packaging": {
"type": "string"
},
"useByDates": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"productName": {
"type": "string"
},
"modelNumbers": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"locations": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"establishments": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"productsTruncated": {
"type": "boolean"
}
},
"additionalProperties": false
},
"description": {
"type": "string"
},
"publishedOn": {
"type": "string"
},
"descriptionTruncated": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"confidence": {
"type": "number"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Search recalls by extracted UPC, lot code, model number, product name, or VIN. Multiple identifiers are AND-matched on the same product. VIN lookup lists NHTSA campaigns for the decoded year and make; confirm your vehicle on nhtsa.gov/recalls. lot_code: Label prefixes (BB:, Lot#, Best By, Exp, etc.) are ignored. Extracted lots match exactly or as a prefix of at least 4 characters, after normalizing spaces, case, and punctuation. If lots were not extracted, notice title and description search needs at least 4 characters — verify against the notice. product_name falls back to the same full-text search as search_product_recalls when no exact extracted name matches, and returns a hint if still empty.
| Parameter | Type | Description |
|---|---|---|
| upc | string | product UPC or EAN as stored on the recall |
| vin | string | 17-character VIN. Lookup lists NHTSA campaigns for the decoded year and make; confirm your vehicle on nhtsa.gov/recalls. |
| limit | integer | number of recalls to return |
| offset | integer | number of recalls to skip |
| lot_code | string | lot or batch code. Label prefixes (BB:, Lot#, Best By, Exp, etc.) are ignored. Extracted lots match exactly or as a prefix of at least 4 characters, after normalizing spaces, case, and punctuation. Lot-only lookup uses the extracted identifier index and does not search notice title and description. … |
| model_number | string | model number as stored on the recall |
| product_name | string |
Create a Recall Kitchen account and API key from an email. No API key or x402 payment required. Set accept_terms true only after you ask the person and they confirm they are 13 or older and accept the Terms (https://recallkitchen.com/terms), Privacy Policy (https://recallkitchen.com/privacy) and API Terms (https://recallkitchen.com/api-terms); never set it automatically or on the person's behalf. The key is returned once. Unverified accounts have lower rate limits (60 tool calls/hour, 400/day, one key) and can add a few watch patterns. Sign in at https://app.recallkitchen.com with the same email to verify, raise limits, and add inventory. Does not re-issue a key if the email already has an account.
| Parameter | Type | Description |
|---|---|---|
| name | string | optional display name |
| email * | string | email address for the new account |
| accept_terms * | boolean | Set true only after you ask the person and they confirm they are 13 or older and accept the Terms (https://recallkitchen.com/terms), Privacy Policy (https://recallkitchen.com/privacy) and API Terms (https://recallkitchen.com/api-terms). Never set this automatically or on the person's behalf. |
{
"name": "signup",
"description": "Create a Recall Kitchen account and API key from an email. No API key or x402 payment required. Set accept_terms true only after you ask the person and they confirm they are 13 or older and accept the Terms (https://recallkitchen.com/terms), Privacy Policy (https://recallkitchen.com/privacy) and API Terms (https://recallkitchen.com/api-terms); never set it automatically or on the person's behalf. The key is returned once. Unverified accounts have lower rate limits (60 tool calls/hour, 400/day, one key) and can add a few watch patterns. Sign in at https://app.recallkitchen.com with the same email to verify, raise limits, and add inventory. Does not re-issue a key if the email already has an account.",
"inputSchema": {
"type": "object",
"required": [
"email",
"accept_terms"
],
"properties": {
"name": {
"type": "string",
"description": "optional display name"
},
"email": {
"type": "string",
"description": "email address for the new account"
},
"accept_terms": {
"type": "boolean",
"description": "Set true only after you ask the person and they confirm they are 13 or older and accept the Terms (https://recallkitchen.com/terms), Privacy Policy (https://recallkitchen.com/privacy) and API Terms (https://recallkitchen.com/api-terms). Never set this automatically or on the person's behalf."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"user_id",
"email",
"email_verified",
"key_id",
"api_key",
"limits",
"message"
],
"properties": {
"email": {
"type": "string"
},
"key_id": {
"type": "string"
},
"limits": {
"type": "object",
"required": [
"hourly",
"daily",
"max_keys_per_user",
"max_watch_patterns",
"max_inventory",
"allow_account_writes",
"tier"
],
"properties": {
"tier": {
"type": "string"
},
"daily": {
"type": "integer"
},
"hourly": {
"type": "integer"
},
"max_inventory": {
"type": "integer"
},
"max_keys_per_user": {
"type": "integer"
},
"max_watch_patterns": {
"type": "integer"
},
"allow_account_writes": {
"type": "boolean"
}
},
"additionalProperties": false
},
"api_key": {
"type": "string"
},
"message": {
"type": "string"
},
"user_id": {
"type": "string"
},
"email_verified": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Recall Kitchen searches government recall notices from U.S. CPSC, FDA food, FDA MedWatch, openFDA enforcement, USDA FSIS, and NHTSA, plus Health Canada / CFIA recalls and safety alerts. Query syntax for search_product_recalls and watch patterns: unquoted words are AND, OR is or, -term excludes, "quoted words" are a phrase. Example: Generac Generator -Portable. Access: - Free (no key): initialize, tools/list, resources, prompts, signup, and give_feedback. A few search calls per IP (5/hour, 15/day): search_product_recalls, search_recalls_by_identifier, search_product_recalls_by_upc, lookup_product, get_product_recall. - Paid (x402, USDC on Base): anonymous search after the IP quota, and search_product_recalls_from_image (photo (beta)) without a key. Account tools do not work with x402. - Signup (email, no key): mints one API key, shown once. Unverified: 60 tool calls/hour, 400/day, 1 key, up to 3 watch patterns, no inventory. Send X-API-Key: rk_... (Grok) or Authorization: Bearer rk_... (Claude/Cursor). - API key (signup is enough): all search including photo (beta), watch patterns, check_tracked_products, notifications, list/create/revoke keys. - Verification (sign in at https://app.recallkitchen.com with the same email): inventory, and higher limits (600/hour, 3,000/day, 3 keys, 20 patterns, 50 inventory products). Which tool to use: - search_product_recalls: keyword search with that query syntax. Optional source, sources (OR of several), dates (YYYY-MM-DD), years (1-50, ignored if since is set), and location (country, region, or place; ANDed with the query). USA, Canada, Mexico, EU, and Europe match places in that region. CA is California, not Canada. Descriptions are truncated; call get_product_recall for the full text. - search_recalls_by_identifier: UPC, lot, model, product name, or VIN from extracted recall data. Prefer this for barcodes, lot codes, and VINs. VIN lookup lists NHTSA campaigns for the decoded year and make; confirm your vehicle on nhtsa.gov/recalls. lot_code: Label prefixes (BB:, Lot#, Best By, Exp, etc.) are ignored. Extracted lots match exactly or as a prefix of at least 4 characters, after normalizing spaces, case, and punctuation. If lots were not extracted, notice title and description search needs at least 4 characters — verify against the notice. product_name falls back to the same full-text search as search_product_recalls when no exact extracted name matches; if still empty, a hint is returned. - search_product_recalls_by_upc: look up a UPC and search extracted recall UPCs. Returns found=false if the UPC is unknown. - lookup_product: catalog/USDA branded-food info only; does not search recalls. - search_product_recalls_from_image: photo (beta). Public HTTPS image URL, data:image/...;base64 URI, or MCP image content. Local file paths are not supported. Runs the same layered scan pipeline as the signed-in app (barcode, OCR, visual) and returns the final fused products (not a stream). Results include confidence and match (upc, model, text, category). Category matches omit recalls unless include_category_matches=true. Requires an API key or x402 (not in the free anonymous quota). Stored photos can be deleted in the signed-in app (photo, saved details, or both). Email support@recallkitchen.com for a partial or full account deletion. - get_product_recall: full description plus extracted lots, UPCs, models, locations, contacts, and product photo URLs. Each result includes status (active, terminated, completed, correction, deleted, or FDA advisory). FDA Food Alerts & Advisories notices use status "FDA advisory" and keep FDA's own headline; confirm against the linked official notice. Recall data comes from government agencies and may be delayed, incomplete, or inaccurate. - Account: signup (email, no key required; returns an API key once). Set accept_terms true only after you ask the person and they confirm they are 13 or older and accept the Terms (https://recallkitchen.com/terms), Privacy Policy (https
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| array |
| optional sources to include (OR). Same values as source |
| location | string | optional country, region, or place; ANDed with the query. USA, Canada, Mexico, EU, and Europe match places in that region. CA is California, not Canada. |
{
"name": "search_product_recalls",
"description": "Search product recalls by query. Query uses websearch syntax: unquoted words are AND, OR is or, -term excludes, quoted phrases match as a unit (example: Generac Generator -Portable). Optional filters: source (cpsc, fdafoodsafety, FDAMedWatch, usda, nhtsa, canada, openfda), since/until (YYYY-MM-DD), location (country, region, or place, ANDed with the query), offset, limit. Descriptions are truncated and extracted products are capped; use get_product_recall for the full text.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 3,
"maximum": 100,
"minimum": 1,
"description": "number of recalls to return, 1-100, default 3"
},
"query": {
"type": "string",
"description": "websearch query: unquoted words are AND, OR is or, -term excludes, quoted phrases match as a unit. Example: Generac Generator -Portable"
},
"since": {
"type": "string",
"description": "optional published-on start date YYYY-MM-DD"
},
"until": {
"type": "string",
"description": "optional published-on end date YYYY-MM-DD"
},
"years": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "optional published window in years (1-50). Ignored when since is set"
},
"offset": {
"type": "integer",
"maximum": 100,
"minimum": 0,
"description": "number of recalls to skip"
},
"source": {
"enum": [
"cpsc",
"fdafoodsafety",
"FDAMedWatch",
"usda",
"nhtsa",
"canada",
"openfda"
],
"type": "string",
"description": "optional source filter: cpsc, fdafoodsafety, FDAMedWatch, usda, nhtsa, canada, or openfda. Aliases: FDA and food map to fdafoodsafety; medwatch maps to FDAMedWatch; vehicle, vin, and car map to nhtsa; healthcanada, cfia, and hc-sc map to canada; enforcement, res, and fdaenforcement map to openfda. For more than one source, pass sources."
},
"sources": {
"type": "array",
"items": {
"enum": [
"cpsc",
"fdafoodsafety",
"FDAMedWatch",
"usda",
"nhtsa",
"canada",
"openfda"
],
"type": "string"
},
"description": "optional sources to include (OR). Same values as source",
"uniqueItems": true
},
"location": {
"type": "string",
"description": "optional country, region, or place; ANDed with the query. USA, Canada, Mexico, EU, and Europe match places in that region. CA is California, not Canada."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"recalls",
"offset"
],
"properties": {
"offset": {
"type": "integer"
},
"recalls": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"id",
"source",
"title",
"description",
"url",
"publishedOn"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"source": {
"type": "string"
},
"status": {
"type": "string"
},
"extracted": {
"type": [
"null",
"object"
],
"properties": {
"images": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"stores": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"contact": {
"type": [
"null",
"object"
],
"properties": {
"emails": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"phones": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"websites": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"products": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"upcs": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"lotCodes": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"packaging": {
"type": "string"
},
"useByDates": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"productName": {
"type": "string"
},
"modelNumbers": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"locations": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"establishments": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"productsTruncated": {
"type": "boolean"
}
},
"additionalProperties": false
},
"description": {
"type": "string"
},
"publishedOn": {
"type": "string"
},
"descriptionTruncated": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"nextOffset": {
"type": [
"null",
"integer"
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| extracted product name (exact match; if none, falls back to the same full-text search as search_product_recalls) |
{
"name": "search_recalls_by_identifier",
"description": "Search recalls by extracted UPC, lot code, model number, product name, or VIN. Multiple identifiers are AND-matched on the same product. VIN lookup lists NHTSA campaigns for the decoded year and make; confirm your vehicle on nhtsa.gov/recalls. lot_code: Label prefixes (BB:, Lot#, Best By, Exp, etc.) are ignored. Extracted lots match exactly or as a prefix of at least 4 characters, after normalizing spaces, case, and punctuation. If lots were not extracted, notice title and description search needs at least 4 characters — verify against the notice. product_name falls back to the same full-text search as search_product_recalls when no exact extracted name matches, and returns a hint if still empty.",
"inputSchema": {
"type": "object",
"properties": {
"upc": {
"type": "string",
"description": "product UPC or EAN as stored on the recall"
},
"vin": {
"type": "string",
"description": "17-character VIN. Lookup lists NHTSA campaigns for the decoded year and make; confirm your vehicle on nhtsa.gov/recalls."
},
"limit": {
"type": "integer",
"default": 3,
"maximum": 100,
"minimum": 1,
"description": "number of recalls to return"
},
"offset": {
"type": "integer",
"maximum": 100,
"minimum": 0,
"description": "number of recalls to skip"
},
"lot_code": {
"type": "string",
"description": "lot or batch code. Label prefixes (BB:, Lot#, Best By, Exp, etc.) are ignored. Extracted lots match exactly or as a prefix of at least 4 characters, after normalizing spaces, case, and punctuation. Lot-only lookup uses the extracted identifier index and does not search notice title and description. Combined with upc, model_number, or vin, notice text is also searched when no lots were extracted (at least 4 characters). Verify against the notice."
},
"model_number": {
"type": "string",
"description": "model number as stored on the recall"
},
"product_name": {
"type": "string",
"description": "extracted product name (exact match; if none, falls back to the same full-text search as search_product_recalls)"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"recalls",
"offset"
],
"properties": {
"hint": {
"type": "string"
},
"offset": {
"type": "integer"
},
"recalls": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"id",
"source",
"title",
"description",
"url",
"publishedOn"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"source": {
"type": "string"
},
"status": {
"type": "string"
},
"extracted": {
"type": [
"null",
"object"
],
"properties": {
"images": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"stores": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"contact": {
"type": [
"null",
"object"
],
"properties": {
"emails": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"phones": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"websites": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"products": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"upcs": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"lotCodes": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"packaging": {
"type": "string"
},
"useByDates": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"productName": {
"type": "string"
},
"modelNumbers": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"locations": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"establishments": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"productsTruncated": {
"type": "boolean"
}
},
"additionalProperties": false
},
"description": {
"type": "string"
},
"publishedOn": {
"type": "string"
},
"descriptionTruncated": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"nextOffset": {
"type": [
"null",
"integer"
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}