`fda_drug_recalls`

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

Search FDA drug recalls and enforcement actions by drug name or reason — returns recall classification, date, reason and enforcement status. A multi-word search is tried as ALL terms first and falls back to ANY term when nothing matches all of them; the response says which happened in match_mode, so a loose match is never mistaken for a precise one. Recall reasons are free narrative text and often name the contaminant rather than the harm (“NDMA impurity”, not “cancer”), so search the substance when a symptom finds nothing.

Parameters

Name	Type	Required	Description
`query`	string	yes	OpenFDA search query. Examples: ‘openfda.brand_name:“VALSARTAN”’, ‘classification:“Class I”’, ‘reason_for_recall:“contamination“‘
`limit`	number	no	Number of results (1-100, default 10)
`skip`	number	no	Pagination offset (default 0) — the reported total can exceed one page of 100.

Example call

Arguments

{
  "query": "metformin contamination",
  "limit": 10
}

curl

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

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('fda_drug_recalls', {
  "query": "metformin contamination",
  "limit": 10
});

More examples

{
  "query": "openfda.brand_name:\"VALSARTAN\""
}

{
  "query": "classification:\"Class I\"+AND+reason_for_recall:\"contamination\"",
  "limit": 25
}

Response shape

Always returns: total, results

Field	Type	Description
`total`	number	Total count of matching drug recalls
`results`	array	Array of drug recall/enforcement objects

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "Total count of matching drug recalls"
    },
    "results": {
      "type": "array",
      "description": "Array of drug recall/enforcement objects",
      "items": {
        "type": "object"
      }
    }
  },
  "required": [
    "total",
    "results"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

fda_drug_recalls