`fda_drug_events`

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

Search FAERS adverse event reports by drug name, MedDRA reaction term, or date range. Returns report counts, reaction types, seriousness levels, and dates. Natural multi-word reaction phrasing is retried against MedDRA preferred-term word order before an empty result is reported. FAERS reports do not establish incidence or causality.

Parameters

Name	Type	Required	Description
`query`	string	yes	OpenFDA search query. Filter drugs on patient.drug.medicinalproduct — the report’s own drug-name field, present on every record and matching brand or generic. The patient.drug.openfda.* fields are enrichment that is missing for many newer drugs (semaglutide/OZEMPIC among them) and silently match nothing; this tool retries them against medicinalproduct, but naming it directly costs one call instead of two. Examples: ‘patient.drug.medicinalproduct:“OZEMPIC”’, ‘patient.drug.medicinalproduct:“semaglutide”+AND+serious:1’, ‘receivedate:[20240101+TO+20241231]‘
`limit`	number	no	Number of results (1-100, default 10)
`skip`	number	no	Offset for pagination (default 0)

Example call

Arguments

{
  "query": "patient.drug.medicinalproduct:\"OZEMPIC\""
}

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_events","arguments":{"query":"patient.drug.medicinalproduct:\"OZEMPIC\""}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('fda_drug_events', {
  "query": "patient.drug.medicinalproduct:\"OZEMPIC\""
});

More examples

{
  "query": "patient.drug.medicinalproduct:\"semaglutide\"+AND+serious:1",
  "limit": 50
}

{
  "query": "patient.drug.medicinalproduct:\"semaglutide\"+AND+patient.reaction.reactionmeddrapt.exact:\"OPTIC ISCHAEMIC NEUROPATHY\"",
  "limit": 10
}

Response shape

Always returns: total, skip, limit, results

Field	Type	Description
`total`	number	Total count of matching adverse event reports
`skip`	number	Offset used in pagination
`limit`	number	Number of results returned
`results`	array	Array of adverse event report objects
`reaction_requested`	string	The reaction term as the caller supplied it, uppercased
`reaction_resolved`	string	The MedDRA preferred term actually used for the filter
`reaction_resolution`	string	How the supplied reaction term mapped onto a MedDRA preferred term. not_a_meddra_preferred_term means the filter matched nothing — counts are zero because the term missed, not because no reports exist
`reaction_resolution_note`	string	Present when word order was corrected; states the substitution made
`reaction_resolution_hint`	string	Present when the term matched nothing; names a working way to discover the real preferred terms

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "Total count of matching adverse event reports"
    },
    "skip": {
      "type": "number",
      "description": "Offset used in pagination"
    },
    "limit": {
      "type": "number",
      "description": "Number of results returned"
    },
    "results": {
      "type": "array",
      "description": "Array of adverse event report objects",
      "items": {
        "type": "object"
      }
    },
    "reaction_requested": {
      "type": "string",
      "description": "The reaction term as the caller supplied it, uppercased"
    },
    "reaction_resolved": {
      "type": "string",
      "description": "The MedDRA preferred term actually used for the filter"
    },
    "reaction_resolution": {
      "type": "string",
      "enum": [
        "exact_match",
        "word_order_corrected",
        "not_a_meddra_preferred_term"
      ],
      "description": "How the supplied reaction term mapped onto a MedDRA preferred term. not_a_meddra_preferred_term means the filter matched nothing — counts are zero because the term missed, not because no reports exist"
    },
    "reaction_resolution_note": {
      "type": "string",
      "description": "Present when word order was corrected; states the substitution made"
    },
    "reaction_resolution_hint": {
      "type": "string",
      "description": "Present when the term matched nothing; names a working way to discover the real preferred terms"
    }
  },
  "required": [
    "total",
    "skip",
    "limit",
    "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_events