io.github.cyanheads/openfda-mcp-server MCP Server

io.github.cyanheads/openfda-mcp-server

Repository Registry

What is the io.github.cyanheads/openfda-mcp-server MCP server?

Query FDA data on drugs, food, devices, and recalls via openFDA. STDIO or Streamable HTTP.

How to install io.github.cyanheads/openfda-mcp-server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

OPENFDA_API_KEY
Free API key from open.fda.gov — increases daily limit from 1K to 120K requests.
OPENFDA_MIRROR_ENABLED
Serve exact-key lookups for drug/label, drug/ndc, drug/enforcement, and drug/drugsfda from a local bulk mirror instead of the API. Off by default; the initial harvest runs out-of-band via the mirror:init script.
OPENFDA_MIRROR_PATH
Directory holding one SQLite file per mirrored dataset.
OPENFDA_MIRROR_REFRESH_CRON
Cron expression for the in-process mirror refresh. HTTP transport only; stdio operators run mirror:refresh from the host. Requires the optional node-cron peer dependency.
OPENFDA_MIRROR_FALLBACK_LIVE
Fall back to the live API when the mirror is cold, missing the record, or failing. Disable to fail loudly instead.
OPENFDA_MIRROR_REFRESH_TIMEOUT_MS
Wall-clock budget for one scheduled refresh before it is aborted. Raise it for drug/label, the only multi-partition dataset.
OPENFDA_MIRROR_BASE_URL
Host serving the openFDA bulk download manifest. Override only to harvest from a private mirror of the dumps.
MCP_LOG_LEVEL
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
MCP_TRANSPORT_TYPE
required
Must be set to 'http' for streamable HTTP transport.
MCP_HTTP_HOST
The hostname for the HTTP server.
MCP_HTTP_PORT
The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATH
The endpoint path for the MCP server.
MCP_AUTH_MODE
Authentication mode to use: 'none', 'jwt', or 'oauth'.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "openfda-mcp-server": {
      "command": "bun",
      "args": [
        "-y",
        "@cyanheads/openfda-mcp-server"
      ],
      "env": {
        "OPENFDA_API_KEY": "<YOUR_OPENFDA_API_KEY>",
        "OPENFDA_MIRROR_ENABLED": "<YOUR_OPENFDA_MIRROR_ENABLED>",
        "OPENFDA_MIRROR_PATH": "<YOUR_OPENFDA_MIRROR_PATH>",
        "OPENFDA_MIRROR_REFRESH_CRON": "<YOUR_OPENFDA_MIRROR_REFRESH_CRON>",
        "OPENFDA_MIRROR_FALLBACK_LIVE": "<YOUR_OPENFDA_MIRROR_FALLBACK_LIVE>",
        "OPENFDA_MIRROR_REFRESH_TIMEOUT_MS": "<YOUR_OPENFDA_MIRROR_REFRESH_TIMEOUT_MS>",
        "OPENFDA_MIRROR_BASE_URL": "<YOUR_OPENFDA_MIRROR_BASE_URL>",
        "MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
        "MCP_TRANSPORT_TYPE": "<YOUR_MCP_TRANSPORT_TYPE>",
        "MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_HTTP_ENDPOINT_PATH": "<YOUR_MCP_HTTP_ENDPOINT_PATH>",
        "MCP_AUTH_MODE": "<YOUR_MCP_AUTH_MODE>"
      }
    }
  }
}

Related MCP servers

io.github.cyanheads/openfec-mcp-server

Active

Access FEC campaign finance data. Query data about candidates, money trails, and election filings.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/openfoodfacts-mcp-server

Active

Barcode lookup, nutrition search, and product comparison for 3M+ crowd-sourced food products.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/openlibrary-mcp-server

Active

Search books and authors, fetch editions, browse subjects, and resolve cover images.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/openstates-mcp-server

Active

Search bills, legislators, committees, and events across all 50 US states, DC, and 5 US territories.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/openstreetmap-mcp-server

Active

Geocode, reverse geocode, and run Overpass spatial queries on OpenStreetMap data.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/orcid-mcp-server

Active

Researcher profiles, works, affiliations, funding, and peer reviews from the ORCID registry.

TypeScript

View repository →