FDA Warning Letters MCP Server

An MCP (Model Context Protocol) server that provides AI assistants with access to FDA medical device warning letters, deficiency analysis, and QMSR/ISO 13485 clause mapping.

Features

🔍 Search & Discovery

• Search warning letters by company name, device type, or keywords
• Filter by device class (I, II, III) and year
• Get detailed deficiency lists for any letter

📊 Analytics & Trends

• View warning letter trends over time
• See most common deficiency categories
• Device class distribution analysis

🔗 QMSR/ISO Mapping

• Automatically map deficiencies to QMSR (21 CFR 820) sections
• ISO 13485:2016 clause cross-references
• ISO 14971 risk management connections

📈 Live Data

• Seed data from 10 real FDA warning letters (2024)
• Live scraping from FDA.gov with caching
• Force refresh capability

Installation

git clone https://github.com/KoalaTai/fda-warning-letters-mcp.git
cd fda-warning-letters-mcp
npm install
npm run build

Usage with Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fda-warning-letters": {
      "command": "node",
      "args": ["/path/to/fda-warning-letters-mcp/dist/index.js"]
    }
  }
}

Then restart Claude Desktop.

Available Tools

| Tool | Description | |------|-------------| | search_warning_letters | Search letters by query, device class, year | | get_letter_details | Get full details for a specific company | | map_to_qmsr | Map any deficiency to QMSR/ISO clauses | | get_qmsr_mapping | Get ISO 13485 equivalent for a CFR section | | analyze_trends | Get trends for 30d, 90d, 1y, or all time | | get_statistics | NEW Comprehensive database stats (severity, device class, year breakdown) | | list_companies | NEW List all companies with warning letters | | get_recent_letters | NEW Get most recent warning letters | | explain_cfr_section | NEW Detailed CFR section explanations with occurrence stats | | refresh_data | Force refresh from FDA.gov |

Available Resources

| URI | Description | |-----|-------------| | fda://warning-letters/all | All cached warning letters | | fda://warning-letters/recent | Letters from last 30 days | | fda://deficiencies/summary | Aggregated deficiency analysis | | fda://qmsr/reference | Complete 21 CFR 820 to ISO 13485 mapping |

Example Queries

Once connected to Claude, you can ask:

• "Search for FDA warning letters related to CAPA failures"
• "What are the most common deficiencies in Class III device warning letters?"
• "Map this deficiency to QMSR: Failure to establish design control procedures"
• "Show me warning letter trends for the past year"
• "Find warning letters for companies making surgical instruments"

QMSR Clause Mapping

The server maps deficiencies to these regulatory frameworks:

| Category | QMSR Section | ISO 13485 Clause | |----------|--------------|------------------| | Design Controls | 820.30 | 7.3 | | CAPA | 820.100 | 8.5.2 | | Complaints | 820.198 | 8.2.2 | | Production | 820.70 | 7.5 | | Documents | 820.40/180 | 4.2 | | Purchasing | 820.50 | 7.4 | | Risk Management | — | ISO 14971 |

Data Sources

• Curated Data: 29 real FDA warning letters (2023-2025) with 59 detailed deficiencies
• Companies include: Hologic, EpiCare, Abbott, Medtronic, Boston Scientific, Stryker, Dexcom, Edwards Lifesciences, Intuitive Surgical, and more
• Coverage: Design Controls (34%), CAPA (20%), Complaints (15%), Production Controls (10%)
• Device Classes: Class I, II, and III devices

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode
npm run dev

# Type check
npm run typecheck

# Run tests
npm test

Testing the Server

# Test MCP handshake
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | node dist/index.js

# List tools
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | node dist/index.js

Project Structure

fda-warning-letters-mcp/
├── src/
│   ├── index.ts        # Main MCP server
│   ├── types.ts        # TypeScript type definitions
│   ├── data.ts         # Warning letter data & scraping
│   └── qmsr-mapping.ts # 21 CFR 820 to ISO 13485 mappings
├── dist/               # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

Contributing

Pull requests welcome! Areas for improvement:

• [ ] Additional warning letter sources
• [ ] More granular QMSR clause mapping
• [ ] Historical trend analysis
• [ ] Full letter content parsing
• [ ] Database persistence

Related Projects

• VirtualBackroom.ai - AI-powered regulatory compliance platform
• Model Context Protocol - The MCP specification
• OpenFDA - FDA open data APIs

License

MIT - KoalaT.ai

Built for the medical device quality community. 🏥