Skip to main content
Glama

OpenFDA MCP Server

An MCP (Model Context Protocol) server that provides access to U.S. FDA public datasets including drugs, medical devices, adverse events, recalls, and more.

Features

  • 10 FDA Tools: Query drug and device databases through a standardized MCP interface

  • Drug Tools: Adverse events (FAERS), labels, NDC directory, recalls, Drugs@FDA, shortages

  • Device Tools: 510(k) clearances, classifications, adverse events (MDR), recalls

  • Individual Record Lookup: Retrieve specific reports by ID (safety report ID, set ID, MDR report number)

  • Advanced Filtering: Filter drug labels by boxed warnings, request specific label sections

  • Rate Limit Aware: Supports authenticated requests for higher rate limits (120k/hour vs 1k/hour)

  • TypeScript: Fully typed with Zod schema validation

Related MCP server: OpenFDA MCP Server

Installation

# Install globally
npm install -g openfda-mcp-server

# Or use with npx
npx openfda-mcp-server

Configuration

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "openfda": {
      "command": "npx",
      "args": ["-y", "openfda-mcp-server"],
      "env": {
        "OPENFDA_API_KEY": "your-api-key-optional"
      }
    }
  }
}

Environment Variables

Variable

Description

Default

OPENFDA_API_KEY

FDA API key for higher rate limits

None (uses public limits)

Get a free API key at: https://open.fda.gov/apis/authentication/

Available Tools

Drug Tools

Tool

Description

search_drug_adverse_events

Search FAERS for drug safety reports. Retrieve specific report by safetyReportId.

search_drug_labels

Search drug labeling/prescribing info. Get by setId, filter by hasBoxedWarning, select sections.

search_drug_ndc

Search the National Drug Code directory

search_drug_recalls

Search drug recall enforcement reports

search_drugs_at_fda

Search approved drug applications

search_drug_shortages

Search current and resolved drug shortages

Device Tools

Tool

Description

search_device_510k

Search 510(k) premarket notifications

search_device_classifications

Search device classification database

search_device_adverse_events

Search MDR adverse event reports. Retrieve specific report by reportNumber.

search_device_recalls

Search device recall enforcement reports

Built-in Tools

Tool

Description

info

Server name, version, build and capability counts. Registered automatically by SomaMCP.

Tool Parameters

search_drug_labels

Parameter

Type

Description

setId

string

Retrieve a specific label by its unique set_id

drugName

string

Drug brand or generic name (matches either)

indication

string

Medical indication or use case

activeIngredient

string

Active ingredient/substance name

route

string

Route of administration (e.g., 'oral', 'intravenous')

hasBoxedWarning

boolean

Filter for drugs with boxed warnings (most serious warnings)

sections

string[]

Specific label sections to return (see below)

fullText

boolean

Return section text in full (see below)

limit

number

Maximum results (1-100)

skip

number

Number of results to skip for pagination

Available sections: indications_and_usage, dosage_and_administration, contraindications, warnings, warnings_and_cautions, adverse_reactions, drug_interactions, clinical_pharmacology, mechanism_of_action, pharmacokinetics, overdosage, description, how_supplied, storage_and_handling, boxed_warning

Sections are cut at 200 characters (the boxed warning at 500), and each label's truncated lists the ones that were cut. Set fullText: true to get them whole; full sections can be long, so pair it with sections. Drug and device recalls, shortages and device classifications mark cut text the same way. Each device MDR text has its own truncated flag, true when it was cut at 300 characters.

search_drug_adverse_events

Parameter

Type

Description

safetyReportId

string

Retrieve a specific FAERS report by its 8-digit ID

drugName

string

Drug or product name to search

reaction

string

Adverse reaction (e.g., 'headache', 'nausea')

manufacturer

string

Drug manufacturer name

serious

boolean

Filter for serious adverse events only

dateFrom

string

Start date (YYYY-MM-DD)

dateTo

string

End date (YYYY-MM-DD)

limit

number

Maximum results (1-100)

skip

number

Number of results to skip for pagination

search_device_adverse_events

Parameter

Type

Description

reportNumber

string

Retrieve a specific MDR report by report number

deviceName

string

Device generic name

brandName

string

Device brand name

manufacturerName

string

Device manufacturer name

eventType

string

Type: 'Injury', 'Malfunction', 'Death', 'Other'

dateFrom

string

Start date (YYYY-MM-DD)

dateTo

string

End date (YYYY-MM-DD)

limit

number

Maximum results (1-100)

skip

number

Number of results to skip for pagination

Usage Examples

Search for drug adverse events

Find adverse events for aspirin in the last year that were serious

Get a specific adverse event report

Retrieve FAERS report with safety report ID 10003641

Search for drugs with boxed warnings

Find all drugs with boxed warnings related to cardiovascular risks

Get specific label sections

Get the boxed_warning and contraindications sections for warfarin

Search for drug recalls

Search for Class I drug recalls from Pfizer

Search for device clearances

Find 510(k) clearances for cardiac pacemakers

Get a specific device adverse event report

Retrieve MDR report number 2649622-2020-08294

Search for device adverse events

Search device adverse events for insulin pumps that resulted in injury

CLI Usage

# Start with stdio transport (default)
openfda-mcp-server

# Start with HTTP transport
openfda-mcp-server --transport http --port 3000

Docker

Quick Start

# Build and run with docker-compose
docker-compose up -d

# Or build manually
docker build -t openfda-mcp-server .
docker run -p 3000:3000 -e OPENFDA_API_KEY=your-key openfda-mcp-server

Docker Compose

services:
  openfda-mcp:
    image: openfda-mcp-server:latest
    ports:
      - "3000:3000"
    environment:
      - OPENFDA_API_KEY=${OPENFDA_API_KEY:-}

Environment Variables

Pass environment variables to the container:

docker run -p 3000:3000 \
  -e OPENFDA_API_KEY=your-api-key \
  -e DEBUG=openfda-mcp:* \
  openfda-mcp-server

Development

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Test locally
pnpm serve:test

# Run full validation (format, lint, test, build)
pnpm validate

# What CI runs: the same steps, checking format and lint without fixing them
pnpm run ci

# Build for production
pnpm build

Serving the Tools from a Worker

openfda-mcp-server/tools registers the 14 tools on a somamcp server without anything Node-only, so it runs on Cloudflare Workers without nodejs_compat. A hosted server can send each caller's own openFDA key: client gets the call's session and returns a client made for that call.

import { createServer, getRequestHeader } from "somamcp"
import { createFDAAPIClient, registerOpenFDATools, VERSION } from "openfda-mcp-server/tools"

type Env = { OPENFDA_API_KEY: string }

const serverFor = (env: Env) => {
  const server = createServer<{ apiKey?: string }>({
    authenticate: async (request) => ({ apiKey: getRequestHeader(request, "x-openfda-api-key")?.trim() || undefined }),
    name: "openfda",
    version: VERSION, // the installed openfda-mcp-server version
  })
  registerOpenFDATools(server, {
    // The caller's own key, else the server's.
    client: (session) => createFDAAPIClient({ apiKey: session?.apiKey ?? env.OPENFDA_API_KEY }),
  })
  return server
}

export default { fetch: (request: Request, env: Env) => serverFor(env).fetch(request) }

Build a client per call, never one shared and changed: one Worker serves many callers at once. Import everything from openfda-mcp-server/tools: openfda-mcp-server/lib also loads the Node-only server. Without client, the tools use one client that reads OPENFDA_API_KEY from process.env, as the CLI does. A Worker has no process, so that client sends no key: pass client there. Build the server once per isolate in real code rather than per request.

Programmatic Usage

import { createOpenFDAServer, handleSearchDrugAdverseEvents, handleSearchDrugLabels } from "openfda-mcp-server/lib"

// Create a custom server
const server = createOpenFDAServer({
  name: "my-fda-server",
  version: "1.0.0",
})

// Search for adverse events
const adverseEvents = await handleSearchDrugAdverseEvents({
  drugName: "aspirin",
  serious: true,
  limit: 10,
})

// Get a specific adverse event by ID
const specificReport = await handleSearchDrugAdverseEvents({
  safetyReportId: "10003641",
})

// Search for drugs with boxed warnings
const boxedWarningDrugs = await handleSearchDrugLabels({
  hasBoxedWarning: true,
  limit: 10,
})

// Get specific sections of a drug label
const warfarinLabel = await handleSearchDrugLabels({
  setId: "0cbce382-9c88-4f58-ae0f-532a841e8f95",
  sections: ["boxed_warning", "contraindications", "adverse_reactions"],
})

API Rate Limits

From https://open.fda.gov/apis/authentication/:

Authentication

Per Minute

Per Day

Counted per

Without API Key

240

1,000

IP address

With API Key

240

120,000

key

License

MIT

Acknowledgments


Sponsored by SapientsAI — Building agentic AI for businesses

Available Tools

15 tools
infoA
Read-only

Returns identity and build information for this server (name, version, build commit, runtime, capability counts)

Inputs: no named parameters.

search_device_510kB

Search FDA 510(k) premarket notification database for medical device clearances. Find device clearances by device name, applicant, product code, clearance type, or decision date. Returns clearance decisions and device classification details.

Inputs: skip, limit, applicant, deviceName, +4 more.

search_device_adverse_eventsA

Search FDA Medical Device Report (MDR) database for device adverse events. Find adverse events by device name, brand, manufacturer, event type (Injury/Death/Malfunction), and date. Retrieve a specific MDR report by reportNumber. Returns device details, event descriptions, and patient outcomes.

Inputs: skip, limit, dateTo, dateFrom, +5 more.

search_device_classificationsA

Search FDA medical device classification database. Find devices by name, class (1-3), medical specialty, product code, or regulation number. Class 1 is lowest risk, Class 3 is highest risk (implants, life-sustaining).

Inputs: skip, limit, deviceName, deviceClass, +3 more.

search_device_recallsA

Search FDA medical device recall and enforcement reports. Find recalls by company, product description, classification (I-III), status, and date. Class I is most serious (may cause death), Class III is least serious.

Inputs: skip, limit, dateTo, status, +4 more.

search_drug_adverse_eventsA

Search FDA Adverse Event Reporting System (FAERS) for drug safety reports. Find adverse events by drug name, reaction type, manufacturer, date range, and seriousness. Retrieve a specific report by safetyReportId. Returns patient demographics, drug details, and reported reactions.

Inputs: skip, limit, dateTo, serious, +5 more.

search_drug_labelsA

Search FDA drug labeling (SPL) information including prescribing information, indications, warnings, boxed warnings, dosage, and active ingredients. Retrieve a specific label by setId. Filter for drugs with boxed warnings using hasBoxedWarning. Request specific sections (e.g., indications_and_usage, adverse_reactions, boxed_warning) to limit response.

Inputs: skip, limit, route, setId, +6 more.

search_drug_ndcA

Search the National Drug Code (NDC) Directory for drug product identification. Find drugs by NDC, brand name, generic name, labeler, dosage form, or route. Returns product details, active ingredients, and packaging information.

Inputs: skip, limit, route, brandName, +4 more.

search_drug_recallsB

Search FDA drug recall and enforcement reports. Find recalls by company, classification (I-III), status, state, and date range. Class I is most serious (may cause death), Class III is least serious.

Inputs: skip, limit, state, dateTo, +4 more.

search_drugs_at_fdaA

Search the Drugs@FDA database for approved drug applications. Find approved drugs by sponsor, application number, brand name, or marketing status. Returns application details, products, and submission history.

Inputs: skip, limit, brandName, sponsorName, +2 more.

search_drug_shortagesA

Search the FDA Drug Shortage Database for current and resolved drug shortages. Find shortages by generic drug name or status (Current/Resolved). Returns shortage details, posting dates, and resolution information.

Inputs: skip, limit, status, genericName.

search_fda_drug_patent_expiryA

Unified patent expiry and exclusivity view across FDA Orange Book and optionally Purple Book. Search by drug name or application number. Returns patents sorted by earliest expiry date with associated exclusivity data. Set includePurpleBook=true to also include biologics data.

Inputs: skip, limit, applNo, drugName, +2 more.

search_fda_orange_bookA

Search FDA Orange Book for approved drug products with therapeutic equivalence evaluations. Find drugs by trade name, ingredient, applicant, application number, or TE code. Returns product details, patent counts, and exclusivity counts. Data is downloaded from FDA bulk files and cached for 24 hours.

Inputs: skip, limit, applNo, teCode, +2 more.

search_fda_orange_book_patentsA

Search FDA Orange Book patent data for drug products. Find patents by drug name, application number, or patent number. Returns patent details including expiry dates, substance/product/use flags, and associated exclusivities.

Inputs: skip, limit, applNo, drugName, +1 more.

search_fda_purple_bookA

Search FDA Purple Book for licensed biological products. Find biologics by product name, applicant, BLA number, license type (351(a)/351(k)), biosimilar status, or interchangeability. Returns product details, licensing status, and reference product information.

Inputs: skip, limit, applicant, blaNumber, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 15 tools

    Disambiguation4/5

    Each tool maps to a distinct FDA dataset (labels, adverse events, NDC, 510(k), MDR, shortages, Purple Book), so selection is mostly clear. The only real overlap is search_fda_orange_book vs search_fda_orange_book_patents vs search_fda_drug_patent_expiry, where the unified patent-expiry view partially duplicates the other two — descriptions mitigate but don't erase this.

    Naming Consistency4/5

    Nearly all tools follow a search_<domain>_<resource> snake_case pattern (search_drug_labels, search_device_510k, search_fda_purple_book). Minor deviations exist: bare 'info' and 'search_drugs_at_fda' (plural) break the pattern, and the prefix ordering alternates between drug-first, device-first, and fda-first.

    Tool Count5/5

    Fifteen tools is well within a reasonable range and each corresponds to a real, distinct OpenFDA endpoint. Nothing feels padded — the count is justified by the breadth of FDA datasets (drugs, devices, biologics, patents).

    Completeness4/5

    Strong coverage of drugs, devices, biologics, patents, recalls, and adverse events with both search and retrieve-by-ID paths. Gaps remain: no food/dietary-supplement/cosmetic/tobacco endpoints that OpenFDA offers, and no generic cross-endpoint query, but core drug/device workflows are covered.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers