Cost Plus Drugs MCP Server

A Model Context Protocol (MCP) server that provides AI agents with affordable access to Cost Plus Drugs pharmacy services, offering transparent medication pricing and comprehensive drug information.

🌟 Features

The Cost Plus Drugs MCP server empowers AI agents with:

• 🔍 Smart Medication Search: Find medications by name, active ingredient, or related terms
• 📂 Category Navigation: Browse 95+ medication categories including specialized health areas
• 💊 Comprehensive Drug Database: Access detailed medication information with transparent pricing
• 📄 Advanced Pagination: Navigate through large result sets efficiently with smart filtering
• 🏥 Healthcare Integration: Support for women's health, chronic conditions, and specialized treatments

🚀 Quick Start

For AI Agents & Developers:

1. Install & Setup:

git clone https://github.com/your-username/cost-plus-drugs-mcp-server.git
   cd cost-plus-drugs-mcp-server
   npm install && npm run build

2. Start the Server:

# Stdio mode (recommended for AI agents)
   npm start

   # HTTP mode (port 3000)
   npm run start:http

🛠️ Available Tools

`search_medicines`

Find medications by exact name (generic or brand)

{
  "tool": "search_medicines",
  "arguments": {
    "query": "metformin"
  }
}

`get_collections`

Browse all medication categories or search for specific ones

{
  "tool": "get_collections",
  "arguments": {}
}

`get_all_products`

Retrieve medications with filtering by category and pagination (always sorted alphabetically by name)

{
  "tool": "get_all_products",
  "arguments": {
    "first": 10,
    "collection": 31
  }
}

📚 Available Resources

`cost_plus_drugs_collections`

Complete medication category database

• URI: `cost-plus-drugs://collections`
• Categories: 95 specialized health categories
• Filtering: Search by name or slug with `?query=diabetes`

⚙️ Configuration

Customize with environment variables:

• `API_BASE_URL`: GraphQL API endpoint (default: https://www.costplusdrugs.com)
• `API_TIMEOUT_MS`: Request timeout in milliseconds (default: 30000)
• `API_RETRY_ATTEMPTS`: Retry attempts for failed requests (default: 3)
• `MCP_SERVER_NAME`: Server identifier (default: cost-plus-drugs-mcp-server)

💡 Sample Use Cases

Healthcare AI Assistant:

• Compare medication prices across categories
• Find affordable alternatives for expensive treatments
• Provide transparent pricing information to patients
• Navigate complex medication categories efficiently

Research Applications:

• Analyze medication pricing trends
• Study category-specific treatment options
• Generate comprehensive drug information reports

📖 Development Guidelines

For comprehensive development instructions and AI agent integration guidelines, see `AGENTS.md`.

📋 API Response Format

All tools return structured responses with:

• Complete medication data (pricing, forms, availability)
• Clinical context and safety information
• Pagination support for large datasets
• Error handling with recovery suggestions

🔒 License

Licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)

For commercial licensing inquiries, please contact the author.

Medical Disclaimer: This software provides informational purposes only and is not intended for medical diagnosis or treatment decisions. Always consult qualified healthcare professionals for medical advice and verify information with official sources.