{"id":"caa5cf1e-3ac9-4f0f-b9f1-8852315e618f","slug":"pharmaguard","kind":"mcp","name":"pharmaguard","summary":"A Model Context Protocol (MCP) server providing real-time openFDA drug adverse event analytics, active recall tracking, and label warnings.","owner":"0xh1tesh","repoUrl":"https://github.com/0xh1tesh/pharmaguard","license":"MIT","licenseTier":"permissive","trust":"community","stars":1,"match":null,"fewStars":true,"format":"mcp","createdAt":"2026-07-25T20:03:48.000Z","addedAt":"2026-10-21T21:36:04.422Z","logoUrl":"https://avatars.githubusercontent.com/u/216839102?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["cloud-infra","data-analytics","memory-knowledge"],"tags":[],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-26T04:19:22.949Z","sample":false,"url":"https://conduits.dev/tools/pharmaguard","language":"TypeScript","transports":["stdio"],"install":{"npm":"pharmaguard-mcp"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# PharmaGuard MCP\n\n## Project Overview\nPharmaGuard MCP is an advanced Model Context Protocol (MCP) server built with NitroStack. It provides AI agents (like Claude Desktop or Cursor IDE) with direct access to official FDA open data. The server enables AI to look up drug details, retrieve adverse event reports (FAERS), check active FDA enforcement recalls, and compare drug safety profiles side-by-side.\n\n## Features\n- **NDC Lookup:** Retrieve detailed National Drug Code (NDC) information for generic and brand name drugs.\n- **Adverse Events Search:** Analyze top adverse reactions (FAERS) associated with a specific medication.\n- **FDA Label Cross-Reference:** Automatically compares reported adverse reactions against the official FDA Drug Label to determine if a reaction is a known warning or potentially unlisted.\n- **Historical Trends & Seriousness:** Visualizes the timeline of adverse event reports and provides a clinical seriousness breakdown (Death, Hospitalization, etc.).\n- **Enforcement Recalls:** Checks the FDA enforcement database for active, ongoing recalls related to a drug.\n- **Drug Comparison:** Compare two medications side-by-side for their adverse event profiles and recall statuses.\n- **Dynamic Widgets:** Renders interactive, highly-visual React widgets directly within supported MCP clients (like NitroStudio), featuring Recharts data visualizations.\n  \n## Pipeline Diagram\n<img width=\"1155\" height=\"772\" alt=\"image\" src=\"https://github.com/user-attachments/assets/75f70fc6-d43a-4625-8cc1-4cfc2a2fc947\" />\n\n## Installation\n\n1. **Clone the repository:**\n   ```bash\n   git clone <your-repo-url>\n   cd pharmaguard-mcp\n   ```\n\n2. **Install dependencies:**\n   ```bash\n   npm install\n   ```\n\n## Environment Variables\n\nCopy the provided `.env.example` file to create your own `.env`:\n\n```bash\ncp .env.example .env\n```\n\nEnsure the following variables are set in your `.env` file:\n- `OPENFDA_API_KEY`: Your openFDA API key. Get one at [https://open.fda.gov/apis/authentication/](https://open.fda.gov/apis/authentication/) to increase your rate limits from 240/min to 240,000/day.\n- `PORT`: The port the server will run on (default is 3000).\n\n*Note: Do not commit your `.env` file to version control.*\n\n## Build Commands\n\nTo build the MCP server and compile the React widgets for production:\n\n```bash\nnpm run build\n```\n*(This compiles the TypeScript code into `dist/` and bundles the widgets into `src/widgets/out/`)*\n\nFor development with hot-reloading:\n```bash\nnpm run dev\n```\n\nTo run smoke tests to verify the tools are functioning correctly:\n```bash\nnpm run test:smoke\n```\n\n## Deployment Instructions\n\n### Running the Server\nYou can start the production server using:\n```bash\nnpm start\n```\n\n### Integrating with MCP Clients\n\n**For NitroStudio:**\n1. Open NitroStudio.\n2. Select \"Add Project\" and point it to the `pharmaguard-mcp` directory.\n3. The server will automatically start and render the custom React widgets.\n\n**For Claude Desktop:**\nUpdate your `claude_desktop_config.json` with the following configuration:\n```json\n{\n  \"mcpServers\": {\n    \"pharmaguard\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/pharmaguard-mcp/dist/index.js\"],\n      \"env\": {\n        \"OPENFDA_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n**For Cursor IDE:**\n1. Navigate to Settings -> MCP Settings.\n2. Add a new MCP server.\n3. Select \"Command\" and use: `node /absolute/path/to/pharmaguard-mcp/dist/index.js`.\n4. Ensure your environment variables are configured within the Cursor environment if necessary.\n"}