Content
# 🏥 Israel Drugs MCP Server
[](https://creativecommons.org/licenses/by-nc-sa/4.0/)
[](https://modelcontextprotocol.io/)
[](https://www.typescriptlang.org/)
> **Revolutionary Model Context Protocol server providing AI agents with comprehensive access to Israel's complete pharmaceutical database from the Ministry of Health.**
The first MCP server to bridge Israel's healthcare data with AI, enabling Claude and other AI agents to provide evidence-based medication guidance, safety assessments, and therapeutic recommendations using real-time Israeli pharmaceutical data.
---
## 🌟 What Makes This Special
### **The World's First Israeli Pharmaceutical AI Integration**
- **Complete Database Access**: Every medication registered with Israel's Ministry of Health
- **Real-Time Data**: Current pricing, health basket coverage, and availability
- **Clinical Intelligence**: Advanced therapeutic comparison and safety assessment
- **Israeli Context**: Tailored for Israel's healthcare system, regulations, and population
### **Revolutionary Pre-Built Clinical Information Templates** 🧠
Unlike basic MCP servers, this includes **3 professional-grade information templates** that help organize pharmaceutical data from the Ministry of Health:
1. **🔬 `compare_therapeutic_options`** - Structured medication comparison using official data
2. **⚠️ `drug_safety_verification`** - Organized safety information from regulatory sources
3. **🏥 `symptom_to_treatment_workflow`** - Information discovery based on medical categories
---
## 🚀 Key Features
### **📊 Comprehensive Drug Information**
- **1,172+ therapeutic categories** (ATC classification system)
- **Complete medication profiles** including indications, contraindications, dosing
- **Visual identification** with official product images
- **Health basket status** and pricing information
- **Generic alternatives** and therapeutic equivalents
### **🔍 Advanced Search Capabilities**
- Drug name search (Hebrew/English with fuzzy matching)
- Symptom-based treatment discovery
- Therapeutic category exploration
- Administration route filtering
- Safety and interaction screening
### **🧠 Clinical Intelligence Features**
- **Data organization templates** with structured information presentation
- **Information discovery frameworks** for pharmaceutical research
- **Educational content optimization** for Israeli healthcare context
- **Research-based information** with clinical context
### **🇮🇱 Israeli Healthcare Integration**
- Ministry of Health approval status
- Health fund coverage (Clalit, Maccabi, Meuhedet, Leumit)
- Kupat Cholim formulary alignment
- Hebrew/Arabic/Russian patient education materials
- Cultural and religious medication considerations
---
## 📖 Table of Contents
- [Installation](#-installation)
- [Quick Start](#-quick-start)
- [Core Tools](#-core-tools)
- [Clinical Prompts](#-clinical-prompts)
- [Usage Examples](#-usage-examples)
- [Advanced Features](#-advanced-features)
- [API Reference](#-api-reference)
- [Contributing](#-contributing)
- [License](#-license)
---
## 🛠 Installation
### **Prerequisites**
- Node.js 18+
- Claude Desktop app or MCP-compatible client
- Internet connection for real-time data access
### **Development Setup**
```bash
# Clone repository
git clone https://github.com/DavidOsherDevDev/israel-drugs-mcp-server.git
cd israel-drugs-mcp-server
# Install dependencies
npm install
# Build project
npm run build
# Start server
npm start
```
### **Claude Desktop Configuration**
Add to your Claude Desktop settings (`~/.claude.json` or `%APPDATA%\Claude\claude.json`):
```json
{
"mcpServers": {
"israel-drugs": {
"command": "node",
"args": ["/path/to/israel-drugs-mcp-server/dist/index.js"],
"env": {},
"disabled": false,
"autoApprove": []
}
}
}
```
---
## 🚀 Quick Start
### **1. Basic Medication Search**
```plaintext
"Find information about Paracetamol for children"
```
### **2. Professional Drug Comparison**
```plaintext
"Use the therapeutic comparison tool to compare Nurofen vs Advil for children ages 3-5 with headaches"
```
### **3. Safety Assessment**
```plaintext
"Run a safety check for Warfarin in an elderly patient with diabetes and hypertension"
```
### **4. Symptom-Based Treatment**
```plaintext
"What treatments are available for fever and headache in a 35-year-old patient?"
```
---
## 🔧 Core Tools
### **🔍 `discover_drug_by_name`**
**Purpose**: Comprehensive medication search and information retrieval
**Parameters**:
- `medication_query` (required): Drug name or partial name
- `patient_preferences`: Budget, prescription access, availability preferences
- `search_scope`: Search breadth (exact, similar, broad)
**Use Case**: Primary tool for medication identification and detailed information access.
**Example**:
```javascript
discover_drug_by_name({
medication_query: "אדויל לילדים",
patient_preferences: { budget_conscious: true },
search_scope: "similar_names"
})
```
### **🏥 `find_drugs_for_symptom`**
**Purpose**: Evidence-based treatment discovery for specific symptoms
**Parameters**:
- `primary_category` (required): Main symptom category
- `specific_symptom` (required): Targeted symptom
- `treatment_preferences`: OTC preference, health basket priority, result limits
**Use Case**: Clinical decision support for symptom-based treatment selection.
### **🔬 `explore_generic_alternatives`**
**Purpose**: Therapeutic alternatives and generic options discovery
**Parameters**:
- `search_criteria`: Active ingredient, ATC code, administration route, or reference drug
- `comparison_criteria`: Health basket priority, price comparison, strength matching
**Use Case**: Cost-effective prescribing and formulary management.
### **📋 `browse_available_symptoms`**
**Purpose**: Systematic exploration of treatable conditions
**Parameters**:
- `category_filter`: Specific medical specialty
- `include_popular_symptoms`: Show frequently searched conditions
- `clinical_priority_order`: Organize by urgency
**Use Case**: Treatment pathway discovery and clinical education.
### **💊 `get_comprehensive_drug_info`**
**Purpose**: Complete medication monograph with regulatory details
**Parameters**:
- `drug_registration_number` (required): Official registration number
- `info_depth`: Basic, detailed, or comprehensive information level
- `language_preference`: Hebrew, English, or both
**Use Case**: Detailed clinical review and regulatory compliance verification.
### **📸 `verify_drug_visual_identity`**
**Purpose**: Visual medication identification and verification
**Parameters**:
- `drug_registration_number` (required): Drug registration number
- `image_purpose`: Identification, verification, or patient education
**Use Case**: Medication safety and error prevention.
### **📝 `suggest_drug_names`**
**Purpose**: Intelligent spelling correction and name completion
**Parameters**:
- `partial_name` (required): Partial or misspelled drug name
- `search_type`: Trade names, active ingredients, or both
- `max_suggestions`: Number of suggestions to return
**Use Case**: Accurate medication identification with error correction.
### **🗺 `list_administration_routes`**
**Purpose**: Comprehensive administration pathway information
**Parameters**:
- `complexity_level`: Simple, moderate, complex, or all routes
- `patient_age_group`: Age-appropriate administration methods
- `onset_requirements`: Desired therapeutic onset timing
**Use Case**: Route selection optimization and patient-appropriate delivery methods.
### **🧬 `explore_therapeutic_categories`**
**Purpose**: ATC classification system exploration and drug discovery
**Parameters**:
- `level`: Classification depth (main groups, subgroups, all)
- `therapeutic_area`: Medical specialty or anatomical system
- `include_usage_patterns`: Prescribing frequency and clinical patterns
**Use Case**: Systematic therapeutic exploration and formulary development.
---
## 🧠 Information Templates (Educational & Research Use)
### **🔬 `compare_therapeutic_options`**
**Educational Drug Information Comparison**
Organize pharmaceutical data from the Ministry of Health for educational comparison purposes.
**Input Parameters**:
- `drug_list` (required): Comma-separated medications
- `clinical_context`: Medical indication for information context
- `target_population`: Patient demographic for educational purposes
- `comparison_focus`: Primary information area (safety data, regulatory status, etc.)
- `decision_framework`: Information organization approach
**What It Provides**:
- **Structured Information Matrix**: Organized pharmaceutical data comparison
- **Regulatory Information**: Ministry of Health approval and status data
- **Educational Safety Information**: Official safety profile data
- **Health System Information**: Israeli healthcare system context
- **Research Organization**: Structured information for educational use
- **Information Summary**: Organized data presentation
**Example Usage**:
```plaintext
Use the information comparison template:
- drug_list: "Nurofen,Advil,Tylenol"
- clinical_context: "pediatric pain relief information"
- target_population: "children ages 3-5"
- comparison_focus: "safety information and regulatory status"
```
**Output**: Organized educational information based on Ministry of Health data for research and learning purposes.
### **⚠️ `drug_safety_verification`**
**Educational Safety Information Organization**
Access and organize official safety information from regulatory sources for educational purposes.
**Input Parameters**:
- `drug_identifier` (required): Medication name or registration number
- `patient_age_group`: Age category for population-specific information
- `medical_conditions`: Relevant medical conditions for information context
- `current_medications`: Concurrent medications for interaction information
- `allergies`: Known sensitivities for contraindication information
- `safety_concerns`: Specific information focus areas
- `risk_tolerance`: Information detail level
**What It Provides**:
- **Regulatory Safety Information**: Current approval and regulatory status
- **Official Safety Profile**: Ministry of Health safety data
- **Educational Risk Information**: Population-specific safety information
- **Interaction Information**: Official drug interaction data
- **Monitoring Information**: Regulatory monitoring guidelines
- **Educational Resources**: Safety information for learning purposes
### **🏥 `symptom_to_treatment_workflow`**
**Educational Information Discovery by Medical Categories**
Explore pharmaceutical information organized by medical categories and symptoms for educational purposes.
**Input Parameters**:
- `presenting_symptoms` (required): Symptom categories for information discovery
- `patient_age`: Age group for population-specific information
- `medical_history`: Medical conditions for information context
- `severity_assessment`: Information detail level
- `treatment_goals`: Educational information focus
- `resource_constraints`: Information scope limitations
**What It Provides**:
- **Systematic Information Organization**: Structured medical category information
- **Educational Disease Information**: Condition-based information from official sources
- **Information Discovery Pathways**: Organized pharmaceutical information flow
- **Israeli Healthcare Information**: System-specific educational content
- **Research Framework**: Information organization for educational use
- **Learning Resources**: Educational material organization
---
## 💡 Usage Examples
### **Example 1: Basic Medication Lookup**
```plaintext
Human: "What is the health basket status of Symbicort?"
AI Response: Using discover_drug_by_name for "Symbicort"...
Found: SYMBICORT TURBUHALER 160/4.5 MCG
- Health Basket: ✅ Included
- Prescription Required: Yes
- Price: 89.45 NIS
- Manufacturer: AstraZeneca
- Indication: Asthma and COPD maintenance therapy
```
### **Example 2: Professional Drug Comparison**
```plaintext
Human: "Compare Lipitor vs Crestor for a 65-year-old with diabetes using the comparison tool"
AI: Using compare_therapeutic_options...
[Generates complete 12-page clinical analysis including:]
WEIGHTED SCORING MATRIX:
| Criteria | Weight | Lipitor | Crestor | Winner |
|----------|--------|---------|---------|---------|
| Clinical Efficacy | 30% | 4.2 | 4.5 | Crestor |
| Safety Profile | 25% | 4.0 | 4.3 | Crestor |
| Economic Impact | 20% | 3.8 | 3.2 | Lipitor |
| Patient Experience | 15% | 4.1 | 4.0 | Lipitor |
| Implementation | 10% | 4.2 | 3.9 | Lipitor |
FINAL RECOMMENDATION: Crestor (4.18) vs Lipitor (4.02)
Primary choice: Crestor with enhanced monitoring for diabetes interactions
```
### **Example 3: Safety Assessment**
```plaintext
Human: "Safety check for Metformin in elderly patient with kidney disease"
AI: Using drug_safety_verification...
[Generates comprehensive safety analysis:]
🔴 MODERATE RISK IDENTIFIED
- Renal impairment contraindication (eGFR <30)
- Lactic acidosis risk in elderly
- Dose reduction required for eGFR 30-45
- Enhanced monitoring protocol recommended
- Alternative: DPP-4 inhibitors may be safer
```
### **Example 4: Symptom-Based Treatment**
```plaintext
Human: "Treatment options for persistent cough in smoker"
AI: Using symptom_to_treatment_workflow...
[Generates structured treatment pathway:]
IMMEDIATE ASSESSMENT:
- Smoking cessation counseling (Priority 1)
- Chest X-ray evaluation recommended
- Differentiate productive vs dry cough
TREATMENT ALGORITHM:
Step 1: Conservative management (1-2 weeks)
- Dextromethorphan for dry cough
- Guaifenesin for productive cough
- Honey and warm liquids
Step 2: Medical evaluation if persistent
- Clinical examination
- Consider antibiotics if bacterial
- Bronchodilator trial if wheezing
ISRAELI HEALTH SYSTEM:
- Available in health basket: Yes
- Family physician consultation: Recommended
- Pulmonology referral: If >3 weeks persistent
```
---
## 🏗 Advanced Features
### **🤖 AI-Powered Clinical Intelligence**
- **Natural Language Processing**: Understands medical terminology in Hebrew and English
- **Context-Aware Responses**: Maintains clinical context throughout conversations
- **Evidence Integration**: Real-time connection to Israeli regulatory data
- **Population Health Insights**: Israeli-specific epidemiological considerations
### **🔐 Enterprise-Grade Security**
- **Data Privacy**: No patient data stored or transmitted
- **API Rate Limiting**: Respectful usage of Ministry of Health resources
- **Error Handling**: Graceful degradation and comprehensive error reporting
- **Audit Logging**: Complete interaction history for quality assurance
### **🌐 Multi-Language Support**
- **Hebrew**: Native support for Hebrew drug names and clinical terms
- **English**: International drug names and clinical terminology
- **Arabic**: Basic support for Arabic clinical communication
- **Russian**: Limited support for Russian-speaking population
### **📊 Analytics and Monitoring**
- **Usage Statistics**: Aggregate usage patterns (anonymized)
- **Performance Metrics**: Response times and error rates
- **Clinical Impact**: Treatment recommendation tracking
- **System Health**: Real-time monitoring and alerting
---
## 🛡 Safety and Disclaimers
### **⚠️ CRITICAL MEDICAL AND LEGAL DISCLAIMERS**
**This MCP server is designed EXCLUSIVELY for informational, educational, and research purposes:**
- ❌ **NOT for medical diagnosis, treatment, or clinical decision-making**
- ❌ **NOT a substitute for professional medical advice, diagnosis, or treatment**
- ❌ **NOT for emergency medical situations**
- ❌ **NOT validated or approved for clinical use**
- ❌ **NOT intended to replace healthcare providers or medical consultations**
- ✅ **ONLY for educational and research purposes**
- ✅ **Information sourced from public Ministry of Health databases**
- ✅ **Designed for learning about pharmaceutical information systems**
### **🚨 IMPORTANT LEGAL NOTICES**
1. **Always consult licensed healthcare professionals** for any medical decisions
2. **This system does not provide medical advice** - it only organizes publicly available information
3. **All medical decisions must be made by qualified healthcare providers**
4. **Verify all information** with current Israeli prescribing guidelines and healthcare providers
5. **In case of medical emergency, contact emergency services immediately**
6. **The creators assume no liability** for any medical decisions or actions taken based on this information
### **📚 Educational and Research Use Only**
1. **This system organizes publicly available information** from Israeli Ministry of Health databases
2. **All information is for educational and research purposes only**
3. **Users must verify all information** with healthcare professionals and official sources
4. **No medical advice or recommendations are provided** - only information organization
5. **Healthcare decisions must be made by qualified professionals** with appropriate medical training and licensing
### **📋 Data Accuracy**
- Information sourced from Israel Ministry of Health official databases
- Data updated regularly but may not reflect real-time changes
- Cross-reference critical information with official sources
- Report data discrepancies to maintain system accuracy
---
## 🤝 Contributing
We welcome contributions to improve Israeli healthcare AI!
### **How to Contribute**
1. **🍴 Fork the Repository**
```bash
git fork https://github.com/DavidOsherDevDev/israel-drugs-mcp-server.git
```
2. **🌿 Create Feature Branch**
```bash
git checkout -b feature/amazing-new-feature
```
3. **✨ Make Your Changes**
- Add new clinical prompts
- Improve data accuracy
- Enhance Hebrew/Arabic support
- Add new therapeutic categories
4. **🧪 Test Thoroughly**
```bash
npm test
npm run integration-test
```
5. **📝 Submit Pull Request**
- Clear description of changes
- Clinical rationale for modifications
- Test cases and validation
### **🎯 Priority Contribution Areas**
- **Clinical Prompts**: Additional specialized prompt templates
- **Hebrew Localization**: Improved Hebrew clinical terminology
- **Safety Features**: Enhanced patient safety checks
- **Data Validation**: Improved accuracy and error detection
- **Performance**: Optimization for large-scale usage
### **📧 Contact & Support**
- **LinkedIn**: [@DavidOsher](https://linkedin.com/in/david-osher)
- **GitHub Issues**: Use repository issue tracker
---
## 📄 License
**Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)**
### **✅ You are free to:**
- **Share** — copy and redistribute in any medium or format
- **Adapt** — remix, transform, and build upon the material
### **🔒 Under the following terms:**
- **Attribution** — Give appropriate credit to David Osher and this project
- **NonCommercial** — Not for commercial purposes without explicit permission
- **ShareAlike** — Distribute contributions under same license
### **💼 Commercial Licensing**
For commercial use or enterprise deployment, please contact via LinkedIn or GitHub.
**Full License**: [Creative Commons BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)
---
## 🙏 Acknowledgments
### **Data Sources**
- **Israel Ministry of Health**: Official pharmaceutical database
- **Israeli Clinical Guidelines**: Professional medical recommendations
### **Technology**
- **Anthropic**: Model Context Protocol framework
- **Open Source Community**: Development tools and libraries
---
*Made with ❤️ for Israeli Healthcare*
*Building bridges between AI and medicine, one prescription at a time.*
---
**⚡ Ready to get started?**
**[Clone Repository](https://github.com/DavidOsherDevDev/israel-drugs-mcp-server) | [View Installation Guide](#-installation)**
