Recall Kitchen

Official19 toolsLive

by Recall-Kitchen · Go

US recalls MCP: free API key/signup or x402 $0.025 Base; some tools need key; verify↑limits

io.github.adamdecaf/recall-kitchen MCP Server

This MCP server provides a Go client and examples for “Recall Kitchen,” an MCP that searches U.S. recalls across CPSC, FDA food, FDA MedWatch, USDA, and NHTSA vehicle sources. It also exposes a hosted, streamable HTTP endpoint with client configuration via .mcp.json.

🛠️ Key Features

Searches U.S. recalls for: CPSC, FDA food, FDA MedWatch, USDA, NHTSA vehicle recalls
Hosted streamable HTTP endpoint: https://app.recallkitchen.com/mcp
Client configuration supported via .mcp.json
Total tools: 19
Topics: mcp, products, recalls, x402

🚀 Use Cases

Look up recall information across multiple U.S. agencies and categories
Retrieve and integrate recall data using MCP tools for developer workflows

⚡ Developer Benefits

Go client and examples included
Clear hosted access model (streamable HTTP) and documented endpoint
API key support: send X-API-Key: rk_... or Authorization: Bearer rk_...
Signup available via MCP signup or Integrations

⚠️ Limitations

Some tools require an API key (free key/signup flow referenced)
Base cost note: “x402 $0.025 Base” (limits and pricing mentioned, specific tool limits not included)

Topics

mcpproductsrecallsx402

Captured live from the server via tools/list.

add_inventory_product

Add a product to this API key's inventory. Requires a verified account (sign in at https://app.recallkitchen.com with the signup email). Unverified signup keys cannot add inventory.

Parameters4

name	string	required	product name
brand	string	optional	optional brand
category	string	optional	optional category
sku	string	optional	optional SKU or UPC

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "product name"
    },
    "brand": {
      "type": "string",
      "description": "optional brand"
    },
    "category": {
      "type": "string",
      "description": "optional category"
    },
    "sku": {
      "type": "string",
      "description": "optional SKU or UPC"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

add_watch_pattern

Add a recall watch pattern for this API key. Same websearch syntax as search_product_recalls (AND, OR, -exclude, quoted phrases). Requires an API key.

Parameters2

pattern	string	required	websearch pattern: unquoted words are AND, OR is or, -term excludes, quoted phrases match as a unit
weight	integer	optional	optional weight 0-8, default 4

Raw schema

{
  "type": "object",
  "properties": {
    "pattern": {
      "type": "string",
      "description": "websearch pattern: unquoted words are AND, OR is or, -term excludes, quoted phrases match as a unit"
    },
    "weight": {
      "type": "integer",
      "description": "optional weight 0-8, default 4",
      "minimum": 0,
      "maximum": 8
    }
  },
  "required": [
    "pattern"
  ],
  "additionalProperties": false
}

check_tracked_products

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.

Parameters2

limit	integer	optional	maximum matches to return
offset	integer	optional	number of matches to skip

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "maximum matches to return",
      "default": 3,
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "type": "integer",
      "description": "number of matches to skip",
      "minimum": 0,
      "maximum": 100
    }
  },
  "additionalProperties": false
}

create_api_key

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.

Parameters2

name	string	optional	optional key name
kind	string	optional	optional kind: user or agent, default agent

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "optional key name"
    },
    "kind": {
      "type": "string",
      "description": "optional kind: user or agent, default agent",
      "enum": [
        "user",
        "agent"
      ]
    }
  },
  "additionalProperties": false
}

get_product_recall

Get a recall by id, including extracted lots, UPCs, model numbers, locations, contact info, and product photo URLs

Parameters2

recall_id	string	optional	recall id returned by search tools
id	string	optional	alias for recall_id

Raw schema

{
  "type": "object",
  "properties": {
    "recall_id": {
      "type": "string",
      "description": "recall id returned by search tools"
    },
    "id": {
      "type": "string",
      "description": "alias for recall_id"
    }
  },
  "additionalProperties": false
}

list_api_keys

List this account's API keys (id, name, prefix, created). Secrets are not shown. Requires an API key.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "additionalProperties": false
}

list_inventory

List this API key's tracked inventory products. Requires an API key.

Parameters3

query	string	optional	optional inventory search
limit	integer	optional	number of products to return
offset	integer	optional	number of products to skip

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "optional inventory search"
    },
    "limit": {
      "type": "integer",
      "description": "number of products to return",
      "default": 3,
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "type": "integer",
      "description": "number of products to skip",
      "minimum": 0,
      "maximum": 100
    }
  },
  "additionalProperties": false
}

list_recall_notifications

List recall notifications for this API key. unread defaults to true (unread only); pass false for all. 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.

Parameters3

unread	null \| boolean	optional	if true, only unread notifications; if false, include read. Default: true (unread only)
limit	integer	optional	number of notifications to return
offset	integer	optional	number of notifications to skip

Raw schema

{
  "type": "object",
  "properties": {
    "unread": {
      "type": [
        "null",
        "boolean"
      ],
      "description": "if true, only unread notifications; if false, include read. Default: true (unread only)"
    },
    "limit": {
      "type": "integer",
      "description": "number of notifications to return",
      "default": 3,
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "type": "integer",
      "description": "number of notifications to skip",
      "minimum": 0,
      "maximum": 100
    }
  },
  "additionalProperties": false
}

list_watch_patterns

List this API key's recall watch patterns. Requires an API key.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "additionalProperties": false
}

lookup_product

Look up a product by UPC/EAN. Returns found=false when unknown. Does not search recalls.

Parameters1

upc

string

required

UPC or EAN barcode digits

Raw schema

{
  "type": "object",
  "properties": {
    "upc": {
      "type": "string",
      "description": "UPC or EAN barcode digits"
    }
  },
  "required": [
    "upc"
  ],
  "additionalProperties": false
}

mark_notification_read

Mark a recall notification as read (default) or unread. Requires an API key.

Parameters2

recall_id	string	required	recall id from list_recall_notifications
read	null \| boolean	optional	if true, mark read; if false, mark unread. Default true

Raw schema

{
  "type": "object",
  "properties": {
    "recall_id": {
      "type": "string",
      "description": "recall id from list_recall_notifications"
    },
    "read": {
      "type": [
        "null",
        "boolean"
      ],
      "description": "if true, mark read; if false, mark unread. Default true"
    }
  },
  "required": [
    "recall_id"
  ],
  "additionalProperties": false
}

remove_inventory_product

Remove a product from this API key's inventory by id. Requires an API key.

Parameters1

integer

required

inventory product id from list_inventory

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "inventory product id from list_inventory"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

remove_watch_pattern

Remove a recall watch pattern for this API key. Requires an API key.

Parameters1

pattern

string

required

watch pattern to remove

Raw schema

{
  "type": "object",
  "properties": {
    "pattern": {
      "type": "string",
      "description": "watch pattern to remove"
    }
  },
  "required": [
    "pattern"
  ],
  "additionalProperties": false
}

revoke_api_key

Revoke an API key by key_id from list_api_keys. Requires an API key. Revoking the current key will fail subsequent calls.

Parameters1

key_id

string

required

key_id from list_api_keys

Raw schema

{
  "type": "object",
  "properties": {
    "key_id": {
      "type": "string",
      "description": "key_id from list_api_keys"
    }
  },
  "required": [
    "key_id"
  ],
  "additionalProperties": false
}

search_product_recalls

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, costco, target, walmart), 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.

Parameters7

query	string	optional	websearch query: unquoted words are AND, OR is or, -term excludes, quoted phrases match as a unit. Example: Generac Generator -Portable
source	string	optional	optional source filter: cpsc, fdafoodsafety, FDAMedWatch, usda, nhtsa, costco, target, or walmart. Aliases: FDA and food map to fdafoodsafety; medwatch maps to FDAMedWatch; vehicle, vin, and car map to nhtsa; sams maps to walmart.
since	string	optional	optional published-on start date YYYY-MM-DD
until	string	optional	optional published-on end date YYYY-MM-DD
location	string	optional	optional country, region, or place; ANDed with the query. US aliases such as CA and California still apply
offset	integer	optional	number of recalls to skip
limit	integer	optional	number of recalls to return, 1-100, default 3

Raw schema

{
  "type": "object",
  "properties": {
    "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"
    },
    "source": {
      "type": "string",
      "description": "optional source filter: cpsc, fdafoodsafety, FDAMedWatch, usda, nhtsa, costco, target, or walmart. Aliases: FDA and food map to fdafoodsafety; medwatch maps to FDAMedWatch; vehicle, vin, and car map to nhtsa; sams maps to walmart.",
      "enum": [
        "cpsc",
        "fdafoodsafety",
        "FDAMedWatch",
        "usda",
        "nhtsa",
        "costco",
        "target",
        "walmart"
      ]
    },
    "since": {
      "type": "string",
      "description": "optional published-on start date YYYY-MM-DD"
    },
    "until": {
      "type": "string",
      "description": "optional published-on end date YYYY-MM-DD"
    },
    "location": {
      "type": "string",
      "description": "optional country, region, or place; ANDed with the query. US aliases such as CA and California still apply"
    },
    "offset": {
      "type": "integer",
      "description": "number of recalls to skip",
      "minimum": 0,
      "maximum": 100
    },
    "limit": {
      "type": "integer",
      "description": "number of recalls to return, 1-100, default 3",
      "default": 3,
      "minimum": 1,
      "maximum": 100
    }
  },
  "additionalProperties": false
}

search_product_recalls_by_upc

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.

Parameters6

upc	string	optional	UPC or EAN barcode digits
barcode	string	optional	alias for upc
image_url	string	optional	optional HTTPS URL or data:image/...;base64 URI of a barcode image
url	string	optional	alias for image_url
limit	integer	optional	number of recalls to return, 1-100, default 3
offset	integer	optional	number of recalls to skip

Raw schema

{
  "type": "object",
  "properties": {
    "upc": {
      "type": "string",
      "description": "UPC or EAN barcode digits"
    },
    "barcode": {
      "type": "string",
      "description": "alias for upc"
    },
    "image_url": {
      "type": "string",
      "description": "optional HTTPS URL or data:image/...;base64 URI of a barcode image"
    },
    "url": {
      "type": "string",
      "description": "alias for image_url"
    },
    "limit": {
      "type": "integer",
      "description": "number of recalls to return, 1-100, default 3",
      "default": 3,
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "type": "integer",
      "description": "number of recalls to skip",
      "minimum": 0,
      "maximum": 100
    }
  },
  "additionalProperties": false
}

search_product_recalls_from_image

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.

Parameters4

image_url	string	optional	HTTPS URL or data:image/...;base64 URI of a photo containing products. Local file paths are not supported.
url	string	optional	alias for image_url
limit	integer	optional	number of recalls to return per product, 1-100, default 3
include_category_matches	boolean	optional	if true, attach keyword recalls for generic items such as cups; default false

Raw schema

{
  "type": "object",
  "properties": {
    "image_url": {
      "type": "string",
      "description": "HTTPS URL or data:image/...;base64 URI of a photo containing products. Local file paths are not supported."
    },
    "url": {
      "type": "string",
      "description": "alias for image_url"
    },
    "limit": {
      "type": "integer",
      "description": "number of recalls to return per product, 1-100, default 3",
      "default": 3,
      "minimum": 1,
      "maximum": 100
    },
    "include_category_matches": {
      "type": "boolean",
      "description": "if true, attach keyword recalls for generic items such as cups; default false"
    }
  },
  "additionalProperties": false
}

search_recalls_by_identifier

Search recalls by extracted UPC, lot code, model number, product name, or VIN. VIN is decoded locally to year and make and matched against NHTSA campaigns (not a live NHTSA VIN API). Multiple identifiers are AND-matched on the same product.

Parameters7

upc	string	optional	product UPC or EAN as stored on the recall
lot_code	string	optional	lot or batch code as stored on the recall
model_number	string	optional	model number as stored on the recall
product_name	string	optional	extracted product name (exact match)
vin	string	optional	17-character vehicle identification number. Decoded locally to year and make, then matched against NHTSA campaigns. Does not call NHTSA live.
limit	integer	optional	number of recalls to return
offset	integer	optional	number of recalls to skip

Raw schema

{
  "type": "object",
  "properties": {
    "upc": {
      "type": "string",
      "description": "product UPC or EAN as stored on the recall"
    },
    "lot_code": {
      "type": "string",
      "description": "lot or batch code as stored on the recall"
    },
    "model_number": {
      "type": "string",
      "description": "model number as stored on the recall"
    },
    "product_name": {
      "type": "string",
      "description": "extracted product name (exact match)"
    },
    "vin": {
      "type": "string",
      "description": "17-character vehicle identification number. Decoded locally to year and make, then matched against NHTSA campaigns. Does not call NHTSA live."
    },
    "limit": {
      "type": "integer",
      "description": "number of recalls to return",
      "default": 3,
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "type": "integer",
      "description": "number of recalls to skip",
      "minimum": 0,
      "maximum": 100
    }
  },
  "additionalProperties": false
}

signup

Create a Recall Kitchen account and API key from an email. No API key or x402 payment required. 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.

Parameters2

email	string	required	email address for the new account
name	string	optional	optional display name

Raw schema

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "email address for the new account"
    },
    "name": {
      "type": "string",
      "description": "optional display name"
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false
}

README.md5 KBView on GitHub

rk-mcp

Go client and examples for Recall Kitchen MCP.

Recall Kitchen searches U.S. CPSC, FDA food, FDA MedWatch, USDA, and NHTSA vehicle recalls.

Hosted MCP

Public streamable HTTP: https://app.recallkitchen.com/mcp. Client config: .mcp.json. Docs: recallkitchen.com/docs.

Free with API key — mint a key via MCP signup or Integrations. Send X-API-Key: rk_... (required for Grok) or Authorization: Bearer rk_... (Claude/Cursor). Env placeholder: RECALL_KITCHEN_API_KEY.
Anonymous x402 — USDC on Base at $0.025/call, no signup.
Account tools (watches, inventory, notifications) need a key.
Rate limits — about 60 tool calls/hour unverified vs about 600/hour after verified sign-in at app.recallkitchen.com.

Local: http://localhost:8080/mcp. Server card: https://app.recallkitchen.com/.well-known/mcp/server-card.json.

Tool reference: recallkitchen.com/docs/#mcp. Implementation notes: docs/mcp.md.

Auth

Two ways to call tools:

API key (recommended) — free, higher limits. Create a key in the app under Integrations. Send X-API-Key: rk_... (required for Grok) or Authorization: Bearer rk_... (Claude Code, Cursor).
x402 — anonymous USDC on Base (~$0.025 / call). Set X402_EVM_PRIVATE_KEY. Watch, inventory, and notification tools still need an API key.

Grok's HTTP MCP client treats Authorization: Bearer as OAuth. Use X-API-Key for Grok.

toml

# ~/.grok/config.toml
[mcp_servers.recall-kitchen]
url = "https://app.recallkitchen.com/mcp"
enabled = true

[mcp_servers.recall-kitchen.headers]
X-API-Key = "rk_..."

bash

export RK_API_KEY=rk_...

Tools

Public (API key or x402)

Tool	Use
`search_product_recalls`	Keyword search. Optional `source`, `since`/`until` (`YYYY-MM-DD`), `location`, `offset`, `limit` (1–100, default 3).
`search_recalls_by_identifier`	Exact UPC, lot, model, extracted product name, or VIN (local year/make decode for NHTSA).
`search_product_recalls_by_upc`	Look up a UPC and match extracted recall UPCs. `found=false` if unknown.
`lookup_product`	Catalog / USDA branded-food info. Does not search recalls.
`search_product_recalls_from_image`	Public HTTPS URL, `data:image/...;base64` URI, or MCP image content. No local file paths.
`get_product_recall`	Full description and extracted lots, UPCs, models, locations, contacts, image URLs.

Search results truncate descriptions and cap extracted products at 5. Call get_product_recall for the full notice.

location is ANDed with the query. CA matches California / "northern california". United States matches U.S. notices, not Canada/Ontario.

Account (API key required)

list_watch_patterns, add_watch_pattern, remove_watch_pattern, list_inventory, add_inventory_product, remove_inventory_product, check_tracked_products, list_recall_notifications.

Watch patterns use the same syntax as the search box: words are AND, OR is or, -term excludes, "quoted phrase" is a phrase.

Prompts: check_product, check_upc, scan_image, check_vin. Resources: recall://docs/tools, recall://docs/sources.

Go client

cc, err := rkmcp.NewClient(rkmcp.Config{
    ServerURL: "https://app.recallkitchen.com/mcp",
    APIKey:    os.Getenv("RK_API_KEY"),
})
recalls, err := cc.SearchProductRecalls(ctx, "contamination", 3)
detail, err := cc.GetProductRecall(ctx, recalls[0].ID)
hits, err := cc.SearchRecallsByIdentifier(ctx, rkmcp.IdentifierOptions{LotCode: "I31C"})

APIKey is also read from RK_API_KEY or RECALL_KITCHEN_API_KEY. The client sends X-API-Key. Anonymous clients can set EVMPrivateKey / X402_EVM_PRIVATE_KEY instead.

Module: github.com/Recall-Kitchen/rk-mcp/go.

Examples

bash

git clone https://github.com/Recall-Kitchen/rk-mcp.git
cd rk-mcp/examples/go
export RK_API_KEY=rk_...
go run ./search_product_recalls -query "spinach" -location Iowa
go run ./get_product_recall            # searches, then fetches full text
go run ./search_by_identifier -name "infant formula"

See examples/go.

Other clients

Grok: X-API-Key header (see above).
Claude Code: claude mcp add --transport http recall-kitchen https://app.recallkitchen.com/mcp --header "Authorization: Bearer ${RK_API_KEY}"
Cursor: copy .mcp.json (X-API-Key + RECALL_KITCHEN_API_KEY). Authorization: Bearer also works.

Support

support@recallkitchen.com

Install

Tools (19)

add_inventory_productadd_watch_patterncheck_tracked_productscreate_api_keyget_product_recalllist_api_keyslist_inventorylist_recall_notifications

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://app.recallkitchen.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "recall-kitchen": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.recallkitchen.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.adamdecaf/recall-kitchen MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

add_inventory_product

add_watch_pattern

check_tracked_products

create_api_key

get_product_recall

list_api_keys

list_inventory

list_recall_notifications

list_watch_patterns

lookup_product

mark_notification_read

remove_inventory_product

remove_watch_pattern

revoke_api_key

search_product_recalls

search_product_recalls_by_upc

search_product_recalls_from_image

search_recalls_by_identifier

signup

rk-mcp

Hosted MCP

Auth

Tools

Go client

Examples

Other clients

Support

Install

Remote endpoint

Related servers