`search_food_recalls`

Pack: fda · Endpoint: https://gateway.pipeworx.io/fda/mcp

Search FDA food recall records for product recalls, reasons, distribution areas, and status. Returns recall details and enforcement information. Use to check product safety or recall history.

Parameters

Name	Type	Required	Description
`query`	string	no	Search query (e.g., a product name, company, or reason for recall). Omit to get recent recalls.
`limit`	number	no	Number of results to return (default 10, max 100)

Example call

Arguments

{
  "query": "spinach",
  "limit": 20
}

curl

curl -X POST https://gateway.pipeworx.io/fda/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_food_recalls","arguments":{"query":"spinach","limit":20}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search_food_recalls', {
  "query": "spinach",
  "limit": 20
});

More examples

{}

Response shape

Always returns: query, total, limit, results

Field	Type	Description
`query`	string \| null	The search query used (null if no query provided)
`total`	number	Total number of matching recall records
`limit`	number	Maximum results returned
`results`	array	Array of food recall enforcement records

Full JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": [
        "string",
        "null"
      ],
      "description": "The search query used (null if no query provided)"
    },
    "total": {
      "type": "number",
      "description": "Total number of matching recall records"
    },
    "limit": {
      "type": "number",
      "description": "Maximum results returned"
    },
    "results": {
      "type": "array",
      "description": "Array of food recall enforcement records",
      "items": {
        "type": "object",
        "properties": {
          "recall_number": {
            "type": "string",
            "description": "Unique recall number"
          },
          "status": {
            "type": "string",
            "description": "Recall status"
          },
          "classification": {
            "type": "string",
            "description": "Recall classification level"
          },
          "voluntary_mandated": {
            "type": "string",
            "description": "Voluntary or mandated recall"
          },
          "recalling_firm": {
            "type": "string",
            "description": "Name of recalling firm"
          },
          "product_description": {
            "type": "string",
            "description": "Description of recalled product"
          },
          "reason_for_recall": {
            "type": "string",
            "description": "Reason for the recall"
          },
          "product_quantity": {
            "type": "string",
            "description": "Quantity of product recalled"
          },
          "distribution_pattern": {
            "type": "string",
            "description": "Geographic distribution pattern"
          },
          "recall_initiation_date": {
            "type": "string",
            "description": "Date recall was initiated"
          },
          "report_date": {
            "type": "string",
            "description": "Date report was made"
          },
          "state": {
            "type": "string",
            "description": "State involved in recall"
          },
          "country": {
            "type": "string",
            "description": "Country involved in recall"
          }
        },
        "required": [
          "recall_number",
          "status",
          "classification",
          "voluntary_mandated",
          "recalling_firm",
          "product_description",
          "reason_for_recall",
          "product_quantity",
          "distribution_pattern",
          "recall_initiation_date",
          "report_date",
          "state",
          "country"
        ]
      }
    }
  },
  "required": [
    "query",
    "total",
    "limit",
    "results"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "fda": {
      "url": "https://gateway.pipeworx.io/fda/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_food_recalls