Drug Labeling MCP Server
Integrates with a Databricks-hosted model-serving endpoint to generate LLM-backed summaries and evidence-grounded answers for drug-labeling and FDA PDF retrieval workflows.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Drug Labeling MCP Server Look up the FDA label for oxycodone and summarize its CYP2D6 interactions"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Drug Labeling MCP Server
A drug-labeling research assistant built with Model Context Protocol (MCP), FastMCP, Flask, and Databricks. The project provides structured access to public drug-labeling sources and FDA PDF reference materials, with an emphasis on opioid safety information, CYP-mediated interactions, and evidence-grounded responses.
Hackathon 2026 project: A prototype for exploring FDA drug-labeling information. It is not a clinical decision-support system and should not be used as a substitute for official prescribing information or medical advice.
Features
Drug label lookup: Search for drug-label information by generic or brand name, using openFDA and a DailyMed fallback where supported.
CYP label details : Drug interaction, Enzyme Metabolism: Examine labeling information related to CYP2D6 and CYP3A4 for selected opioids, with effective label dates, summaries, and detailed evidence.
FDA PDF search / RAG: Retrieve relevant content from a curated set of FDA PDF documents and generate evidence-grounded answers using a Databricks-hosted language model.
Flask web interface: Separate pages for drug labeling, CYP label history, and PDF search.
MCP integration: Expose drug-information capabilities as tools callable by MCP-compatible clients and AI assistants.
Evaluation and observability: Compare baseline LLM and baseline LLM given evidence with MCP-assisted responses, using an evaluation dataset, scoring metrics, and Phoenix traces.
Related MCP server: OpenFDA MCP Server
Architecture
User / AI Assistant / Flask UI
|
v
MCP Client / HTTP
|
v
FastMCP Server
|
+------+--------------------+
| | |
v v v
openFDA DailyMed FDA PDF Corpus
| | |
+------+ v
| Retrieval / RAG
+-----------+------------+
|
v
Databricks LLM
|
v
Structured responses + evidenceMain components:
Component | Purpose |
FastMCP | Defines and exposes callable MCP tools |
Flask | Provides a browser-based user interface |
openFDA | Retrieves public FDA drug-labeling records |
DailyMed | Supplies an additional source of drug-label information |
FDA PDFs | Provide curated reference documents for retrieval |
Databricks Model Serving | Hosts the language model used for summarization and answer generation |
Phoenix | Supports tracing and evaluation of model/tool workflows |
MCP Tools
1. get_drug_label
Accepts a drug name and retrieves available labeling information. Brand/generic normalization and DailyMed fallback are supported by the project's retrieval layer.
Example input:
{"drug_name": "Oxycodone"}The returned information depends on the source record and may include warnings, adverse reactions, interactions, and labeling metadata.
2. CYP label details : Drug interaction, Enzyme Metabolism
Presents labeling information for four selected drugs:
Oxycodone
Hydrocodone
Tramadol
Buprenorphine
The interface displays the selected label's effective date, an LLM-generated summary where available, and a details view focused on CYP2D6 and CYP3A4 metabolism and drug-interaction evidence. This module is intended for examining label evidence, not predicting patient-specific interactions.
3. FDA PDF search / RAG
Searches an indexed collection of FDA PDF documents, retrieves relevant passages or tables, and uses the retrieved material to support an answer. Retrieval quality depends on document extraction, indexing, query wording, and evidence coverage.
Tool names and argument schemas other than
get_drug_labelshould be confirmed against the current server implementation before invoking them programmatically.
Getting Started
Prerequisites
Python (use the version specified by the repository's
pyproject.toml, if present)Git
Access to a Databricks workspace and a configured model-serving endpoint for LLM-backed features
Network access to the public APIs used by the application
1. Clone the repository
git clone <REPOSITORY_URL>
cd <REPOSITORY_DIRECTORY>2. Install dependencies
If the repository contains a pyproject.toml and uv.lock:
uv syncIf it instead uses requirements.txt:
uv venv
uv pip install -r requirements.txtOn Windows PowerShell, uv can be installed using the instructions on the official uv installation page.
3. Configure environment variables
Create a local .env file, if the application loads dotenv configuration, or set the variables in your shell or deployment environment:
DATABRICKS_HOST=https://<your-workspace-host>
DATABRICKS_TOKEN=<your-databricks-token>
DATABRICKS_MODEL_ENDPOINT=<your-serving-endpoint>Use the model-serving endpoint configured for the deployment. Ensure the identity used by the application has permission to invoke it.
Security: .env, access tokens, or other secrets are not shared in the files. Need to configure credentials through deployment platform's secret management and access controls.
4. Run the combined application locally
From the repository root, run the combined entry point used by this project:
uv run python -m src.example_server.combined_appThe application has previously been served on 127.0.0.1:8000; verify the host and port in your current configuration. The MCP endpoint is typically:
http://127.0.0.1:8000/mcpNote: A 404 Not Found response at / does not necessarily indicate a failed MCP server. Check the configured Flask routes and the /mcp endpoint. The exact module path and launch command should be verified against the current repository layout.
Test the MCP Server
The test script named test_fda_mcp.py tests the mcp tool function calls. To test the other tools, use the names and argument schemas returned by list_tools(). It discovers tools and calls the drug-label lookup tools using the given inputs defined in the script.
To run the script test_fda_mcp.py, then run:
uv run python test_fda_mcp.pyDeploy to Databricks Apps
The project is deployed as a Databricks App with the combined Flask/MCP application as its runtime.
Make the application source and dependency configuration available to Databricks Apps.
Configure the application start command to launch the combined server and listen on the host/port required by Databricks Apps.
Provide secrets through the supported Databricks configuration rather than hard-coding tokens.
Deploy the app, inspect startup logs, and test both the web UI and the
/mcpendpoint.Validate outbound connectivity to openFDA and DailyMed and access to any packaged PDF resources.
The exact app.yaml configuration and deployment commands depend on the current repository and workspace setup. Confirm these against the checked-in configuration before deploying.
Evaluation
The evaluation workflow compares MCP-assisted responses against baseline LLM responses and baseline LLM responses based on provided evidences on a curated set of drug-labeling questions. The project has used a evaluation dataset with questions from 4 categories, reference answers, scope adherence and associated evidences.
Evaluation dimensions
Metric | What it assesses |
Correctness | Whether an answer matches the reference answer in substance |
Evidence grounding | Whether the answer is supported by retrieved or supplied evidence |
Scope adherence | Whether the response stays within the requested drug, formulation, and source scope |
Uncertainty handling | Whether unsupported or missing information is handled appropriately |
Approval-date boundary | Whether approval and label-effective dates are distinguished correctly |
Latency | Response time |
Tool usage and success | Whether expected MCP tools were invoked and completed successfully |
Source match | Whether the response used the intended evidence source |
Phoenix tracing
Phoenix traces help inspect model calls and, when instrumented, retrieval and tool activity. Traces can support investigation of latency, missing evidence, tool-selection failures, and unexpected answers. Tracing visibility depends on which components are instrumented.
RAG retrieval audit
A separate retrieval audit can be used to inspect whether the PDF search layer retrieves relevant material for targeted queries. Its questions may differ from the main end-to-end evaluation dataset. Retrieval audits and answer-quality evaluations measure different stages of the system and should be reported separately.
No numerical performance claims are included here because results should be taken from the latest verified evaluation report.
Known Limitations
Public labeling sources can differ in coverage, formulation, naming conventions, and update timing.
Brand and generic names do not always uniquely identify a formulation; immediate-release and extended-release labels must not be conflated.
Effective labeling dates are not the same as original approval dates.
PDF extraction can lose table structure or omit relevant passages, affecting RAG accuracy.
An LLM-generated summary can be incomplete or inaccurate and must be checked against cited source evidence.
A tool's availability does not guarantee that an agent will select it for every applicable question.
The prototype does not establish clinical safety or completeness for patient-specific drug interactions.
Suggested Future Improvements
Strengthen formulation-aware label matching and latest-record selection.
Improve PDF table extraction, indexing, and retrieval diagnostics.
Display clearer source citations, document dates, and retrieval provenance.
Expand regression tests for brand/generic matching and tool invocation.
Automate evaluation runs and compare performance across revisions.
Add deployment health checks and more comprehensive MCP/tool tracing.
Data Sources and References
Disclaimer
This repository is a research and hackathon prototype. Drug information should be verified against current official labeling. Outputs are not medical advice, and this project is not an official FDA service or endorsement.
License
See the repository's LICENSE file, if provided. No license is implied by this README.
Available Tools
5 toolsget_drug_cyp_label_detailsGet Drug Cyp Label DetailsC
Retrieve CYP evidence for one FDA labeling record.
Inputs: record_id (required), cyp_targets (required). Returns: object
get_drug_cyp_label_historyHistorical CYP Drug Label TimelineBRead-onlyIdempotent
Retrieve available label revisions and passages mentioning target CYP enzymes.
Inputs: drug_name (required), cyp_targets (required). Returns: object
get_drug_labelSearch FDA Drug LabelsDRead-onlyIdempotent
Inputs: drug_name (required). Returns: object
get_latest_four_opioid_labelsGet Latest Four Opioid LabelsBRead-only
Latest available openFDA record for four configured opioids, with LLM summary.
Inputs: no named parameters. Returns: object
search_opioid_label_updatesSearch Opioid Label UpdatesB
Search FDA opioid label updates PDF.
Returns relevant passages, similarity scores, and FDA PDF page references.
Inputs: query (required), top_k. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Most tools target distinct operations, but get_drug_label has no description and may overlap with get_latest_four_opioid_labels and the CYP label tools. get_drug_cyp_label_history and get_drug_cyp_label_details also have a subtle boundary that may confuse an agent.
All tools use snake_case and begin with get_ or search_, which is mostly consistent. The name get_latest_four_opioid_labels embeds a specific count and differs slightly in style, but the overall convention is predictable.
Five tools is a well-scoped set for a focused drug-labeling server. Each tool appears to cover a distinct lookup or retrieval use case without excessive surface area.
The surface covers opioid label updates, latest opioid records, general drug label retrieval, and CYP evidence/history, but it lacks broader drug-label search or listing operations outside the opioid/CYP focus. The missing description on get_drug_label also leaves a notable usability gap.
Maintenance
Related MCP Connectors
Unofficial DrugBank MCP — wraps the DrugBank Clinical API (api.drugbank.com)
ClinicalTrials.gov v2 studies, OpenFDA FAERS adverse events & recalls, and PubMed evidence.
Pharmacogenomics for AI agents: cited drug–gene, gene and rsID lookups plus a medication screen.
Test healthcare AI agents' medication claims against cited FDA label text. Not for clinical use.
Related MCP Servers
- FlicenseBqualityDmaintenanceA comprehensive MCP server that provides access to U.S. FDA public datasets via the openFDA API, enabling querying of drug adverse events, labeling, recalls, approvals, shortages, NDC directory, and medical device regulatory data.1026-
- AlicenseAqualityDmaintenanceAn MCP server that enables AI assistants to query U.S. FDA public datasets, including drug adverse events, labeling, recalls, approvals, shortages, NDC directory, and medical device regulatory information.10MIT
- AlicenseNot gradedqualityCmaintenanceEnables any MCP client to search and read 127 FDA guidance documents on clinical research, with tools for ranked passage search, document retrieval, and metadata lookup.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants and MCP clients to query FDA drug labels, FAERS adverse-event reports, recalls, and label-documented drug interactions, returning structured, cited results.MIT