Certus

A production-ready Model Context Protocol (MCP) server for real-time, authoritative medical and medication information. Certus integrates with Claude Desktop and provides live access to FDA drug data, including shortages, recalls, and labeling, via openFDA APIs.

This project supports bothPythonandJavaScriptimplementations of the MCP servers. You can use either version depending on your environment and preferences.

- Python version:inPY_version/(feature-complete)
- JavaScript version:inJS_version/(Node.js, feature parity for enhanced medication info)

# Clone and enter the project directory $ git clone <your_repository_url> $ cd med_info_mcp_project

cd PY_version pip install -r ../requirements.txt touch __init__.py

Create a.envfile for your OpenFDA API key (optional, improves rate limits):

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

{ "mcpServers": { "enhanced-medication-info": { "command": "python3", "args": ["/full/path/to/PY_version/enhanced_mcp_server.py"] }, "drug-features": { "command": "python3", "args": ["/full/path/to/PY_version/drug_server.py"] } } }

JavaScript Version Setup (JS_version/)

Set your OpenFDA API key (optional, improves rate limits):

export OPENFDA_API_KEY="your_api_key_here"

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

{ "mcpServers": { "enhanced-medication-info": { "command": "node", "args": ["/full/path/to/JS_version/enhanced-mcp-server.js"], "env": { "OPENFDA_API_KEY": "your_openfda_api_key_here" } } } }

- Comprehensive Drug Profiles: FDA labeling, shortage status, manufacturer, and more
- Real-Time Shortage Search: Live shortage data from openFDA (1,900+ records)
- Recall Information: Current and historical drug recalls from FDA enforcement database
- Label-Only Lookup: Retrieve only FDA-approved drug labeling
- Shortage Search Guidance: Tips and strategies for finding shortage data
- Market Trend Analysis: Analyze shortage patterns and risk for a drug
- Batch Analysis: Assess shortages, recalls, and risk for up to 25 drugs at once

med_info_mcp_project/ ├── JS_version/ # JavaScript/Node.js implementation │ ├── enhanced-mcp-server.js │ ├── openfda-client.js │ ├── package.json │ ├── test-client.js │ └── ... ├── PY_version/ # Python implementation │ ├── enhanced_mcp_server.py │ ├── drug_server.py │ ├── drug_features.py │ ├── ... ├── data/ # Data files (e.g., images for testing) ├── requirements.txt # Python dependencies ├── README.md # This file └── ...

All endpoints are exposed as MCP tools and callable via Claude Desktop or programmatically. Below is a summary of each endpoint for both Python and JavaScript versions:

- openFDA Drug Label API(docs)
Endpoint:https://api.fda.gov/drug/label.json
- openFDA Drug Shortages API(docs)
Endpoint:https://api.fda.gov/drug/shortages.json
- openFDA Drug Enforcement/Recalls API(docs)
Endpoint:https://api.fda.gov/drug/enforcement.json
- openFDA FAERS (Adverse Events) API(docs)
Endpoint:https://api.fda.gov/drug/event.json
- RxNorm API(docs)
Endpoint:https://rxnav.nlm.nih.gov/REST

Free oncology data (research, clinical trials, FDA approvals, news) plus IBM MAMMAL biomedical predictions, exposed as MCP tools.