npm package: @striderlabs/mcp-riteaid
Description: MCP server for Rite Aid pharmacy services - search products, manage prescriptions, find stores, schedule vaccines
Author: StrikerLabs
Latest version: 1.0.0

# @striderlabs/mcp-riteaid

MCP (Model Context Protocol) server for Rite Aid pharmacy services. Enables AI assistants to search products, manage prescriptions, find stores, check inventory, and schedule vaccines at riteaid.com.

## Tools

| Tool | Description |
|------|-------------|
| `search_products` | Search Rite Aid's product catalog |
| `refill_prescription` | Request a prescription refill by Rx number |
| `get_prescriptions` | List active prescriptions (requires login) |
| `find_stores` | Find nearby Rite Aid locations by zip code |
| `check_availability` | Check product availability at a specific store |
| `schedule_vaccine` | Schedule a vaccination appointment |

## Installation

```bash
npm install @striderlabs/mcp-riteaid
```

## Usage

### With Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "riteaid": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-riteaid"],
      "env": {
        "BROWSERBASE_CDP_URL": "your-browserbase-cdp-url"
      }
    }
  }
}
```

### With Browserbase

Set the `BROWSERBASE_CDP_URL` environment variable to connect via Browserbase for reliable cloud browser automation:

```bash
BROWSERBASE_CDP_URL="wss://connect.browserbase.com?apiKey=YOUR_KEY" npx @striderlabs/mcp-riteaid
```

### Without Browserbase (local browser)

The server runs with a local Chromium instance when `BROWSERBASE_CDP_URL` is not set:

```bash
npx @striderlabs/mcp-riteaid
```

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `BROWSERBASE_CDP_URL` | No | Browserbase CDP WebSocket URL for cloud browser automation. Falls back to local Chromium if not set. |

## Tool Reference

### `search_products`

Search for products on Rite Aid's website.

**Parameters:**
- `query` (required): Search term (e.g., "ibuprofen", "shampoo")
- `category` (optional): Product category to filter results

**Example:**
```json
{ "query": "vitamin c 1000mg", "category": "vitamins" }
```

---

### `refill_prescription`

Request a prescription refill using an Rx number.

**Parameters:**
- `rx_number` (required): Prescription number from the label
- `date_of_birth` (required): Patient DOB in MM/DD/YYYY format

**Example:**
```json
{ "rx_number": "1234567", "date_of_birth": "01/15/1980" }
```

---

### `get_prescriptions`

List all active prescriptions for a Rite Aid account.

**Parameters:**
- `username` (required): Rite Aid account email
- `password` (required): Rite Aid account password

**Example:**
```json
{ "username": "user@example.com", "password": "mypassword" }
```

> ⚠️ Credentials are used only to authenticate with riteaid.com and are not stored.

---

### `find_stores`

Find Rite Aid stores near a zip code.

**Parameters:**
- `zip_code` (required): US zip code
- `radius` (optional): Search radius in miles (default: 10)

**Example:**
```json
{ "zip_code": "10001", "radius": 5 }
```

---

### `check_availability`

Check if a product is available at a specific Rite Aid store.

**Parameters:**
- `product_name` (required): Product name or description
- `store_id` (required): Store ID from `find_stores`

**Example:**
```json
{ "product_name": "Tylenol Extra Strength", "store_id": "4832" }
```

---

### `schedule_vaccine`

Schedule a vaccination appointment at a Rite Aid pharmacy.

**Parameters:**
- `vaccine_type` (required): Type of vaccine (flu, COVID-19, shingles, etc.)
- `zip_code` (required): Zip code to find nearby locations
- `preferred_date` (required): Date in YYYY-MM-DD format
- `first_name` (required): Patient first name
- `last_name` (required): Patient last name
- `date_of_birth` (required): Patient DOB in MM/DD/YYYY format
- `email` (required): Confirmation email
- `phone` (optional): Reminder phone number

**Example:**
```json
{
  "vaccine_type": "flu",
  "zip_code": "10001",
  "preferred_date": "2025-10-15",
  "first_name": "Jane",
  "last_name": "Doe",
  "date_of_birth": "01/15/1980",
  "email": "jane@example.com",
  "phone": "555-123-4567"
}
```

## Development

```bash
# Install dependencies
npm install

# Build TypeScript
npm run build

# Run directly
node dist/index.js
```

## License

MIT