OpenFDA MCP Server

A Model Context Protocol (MCP) server for querying drug information from the OpenFDA API.

Features

• Retrieve drug label information by brand name
• Retrieve drug information by generic (active ingredient) name
• Get all brand versions of a generic drug
• Get adverse event (side effect) reports for a drug (by brand or generic name)
• Retrieve all drugs manufactured by a specific company
• Get comprehensive drug safety information (warnings, contraindications, interactions, precautions, etc.)
• Normalize and validate NDC (National Drug Code) formats
• Helpful error messages and suggestions for failed queries

1. Set up your OpenFDA API Key

   The MCP server requires an OpenFDA API key to access the OpenFDA API.
   Create a .env file in the root of your project and add the following line:

   OPENFDA_API_KEY=your_openfda_api_key_here
   

   Note: Never commit your real API key to version control.
   You can obtain an API key from OpenFDA API Key Registration.

2. Example MCP Server Configuration

   If you are integrating this server with a larger MCP system, your configuration might look like:

    {
      "mcpServers": {
          "openfda": {
              "command": "npx",
              "args": [
                  "@ythalorossy/openfda"
              ],
              "env": {
                  "OPENFDA_API_KEY": "*****************************************"
              },
              "timeout": 60000,
              "autoApprove": [
                  "get-drug-by-name",
                  "get-drug-by-generic-name",
                  "get-drug-adverse-events",
                  "get-drugs-by-manufacturer",
                  "get-drug-safety-info",
                  "get-drug-by-ndc",
                  "get-drug-by-product-ndc"
              ]
          }
      }
    }
   

   Replace the asterisks with your actual API key, or ensure it is loaded from your .env file.

Want to run it locally?

git clone https://github.com/ythalorossy/openfda.git
cd openfda
npm install
npm run build

Then start the server:

node bin/index.js

Or use it directly with npx:

npx @ythalorossy/openfda

Configuration

Create a .env file for any required environment variables.

License

MIT

Buy me a Coffee