npm package: @striderlabs/mcp-rei
Description: MCP server for REI — let AI agents search outdoor gear, check inventory, manage cart, track orders, and find stores
Author: Strider Labs
Latest version: 0.1.0

# @striderlabs/mcp-rei

[![npm version](https://img.shields.io/npm/v/@striderlabs/mcp-rei.svg)](https://www.npmjs.com/package/@striderlabs/mcp-rei)
[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

REI outdoor retail connector for personal AI agents. Lets Claude and other MCP-compatible AI assistants search gear, manage your cart, track orders, find stores, and more — all powered by browser automation.

Built by [Strider Labs](https://striderlabs.ai) — AI agents for everyday life.

## Features

- **Product Search** — Search camping, hiking, cycling, climbing, and all outdoor gear
- **Product Details & Reviews** — Full specs, features, and customer reviews
- **Store Inventory** — Check which REI stores near you have an item in stock
- **Cart Management** — Add items to cart and view cart contents
- **Member Rewards** — Check your REI dividend balance and year-to-date earnings
- **Store Finder** — Locate REI stores near any zip code or city
- **Classes & Events** — Find outdoor classes, workshops, and adventures
- **Gear Rentals** — Check rental availability (tents, bikes, kayaks, and more)
- **Re/Supply Used Gear** — Search REI's used/refurbished gear marketplace
- **Order Tracking** — Track order status and shipping

## Installation

```bash
npm install -g @striderlabs/mcp-rei
```

Or use directly via npx (no install needed):

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

## Prerequisites

Install Chrome (required for browser automation):

```bash
npx patchright install chrome
```

## MCP Client Configuration

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "rei": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-rei"]
    }
  }
}
```

### Claude Code

```bash
claude mcp add rei -- npx -y @striderlabs/mcp-rei
```

### Generic MCP Client

```json
{
  "mcpServers": {
    "rei": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-rei"],
      "transport": "stdio"
    }
  }
}
```

## Available Tools

### Authentication

| Tool | Description |
|------|-------------|
| `rei_status` | Check login status and member info |
| `rei_login` | Get REI login URL |
| `rei_logout` | Log out and clear session |

### Shopping

| Tool | Description | Parameters |
|------|-------------|------------|
| `rei_search` | Search products | `query`, `maxResults`, `category` |
| `rei_product_details` | Full product info + specs | `productUrl` |
| `rei_product_reviews` | Customer reviews | `productUrl`, `maxReviews` |
| `rei_store_inventory` | Check nearby store stock | `productUrl`, `zipCode` |
| `rei_used_gear` | Search Re/Supply used gear | `query`, `maxResults` |

### Cart

| Tool | Description | Parameters |
|------|-------------|------------|
| `rei_add_to_cart` | Add product to cart | `productUrl`, `quantity`, `size`, `color` |
| `rei_view_cart` | View cart contents | — |

### Member & Account

| Tool | Description | Parameters |
|------|-------------|------------|
| `rei_member_dividend` | Check dividend balance | — |
| `rei_track_order` | Track order status | `orderId` (optional) |

### Stores & Experiences

| Tool | Description | Parameters |
|------|-------------|------------|
| `rei_find_stores` | Find nearby REI stores | `location`, `radius` |
| `rei_find_classes` | Find classes & events | `query`, `location` |
| `rei_gear_rentals` | Check rental availability | `query`, `location` |

## Usage Examples

**Search for a tent:**
> "Search for 2-person backpacking tents under $300"

**Check gear specs:**
> "Get the full specs and reviews for that MSR Hubba Hubba tent"

**Check local stock:**
> "Is the Black Diamond Momentum harness in stock at stores near 98109?"

**Shop used gear:**
> "Search Re/Supply for used hiking boots, size 11"

**Find classes:**
> "Find rock climbing classes in Seattle"

**Check your rewards:**
> "What's my REI dividend balance?"

**Track an order:**
> "Track my recent REI orders"

## Authentication

REI uses account-based login. To access cart, orders, and member features:

1. Call `rei_login` to get the login URL
2. Open the URL in your browser and sign in
3. Call `rei_status` to confirm — your session is saved to `~/.strider/rei/`
4. Your session persists across future conversations

Session data is stored in `~/.strider/rei/` (cookies + session metadata).

## Technical Details

- Uses [Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright) (stealth-patched Playwright) for browser automation
- Headless Chrome — no visible browser window
- Session cookies persisted locally for convenience
- Node.js 18+ required
- Bundled with esbuild for fast startup

## Limitations

- Checkout/order placement is not automated (intentional — use the cart/checkout yourself)
- REI's website structure can change and may require selector updates
- Some features (dividend, order tracking) require authentication
- Rental availability depends on REI's rental program at your local store

## Troubleshooting

**"Add to Cart button not found"**
— Product may require size/color selection. Specify `size` and `color` parameters.

**"Must be logged in"**
— Use `rei_login` to get the URL, sign in via browser, then call `rei_status`.

**No results returned**
— REI's page structure may have changed. Open an issue on GitHub.

**Browser launch fails**
— Run `npx patchright install chrome` to install Chrome.

## Development

```bash
git clone https://github.com/striderlabs/mcp-rei
cd mcp-rei
npm install
npm run build
npm start
```

## Links

- [Strider Labs](https://striderlabs.ai)
- [Model Context Protocol](https://modelcontextprotocol.io)
- [GitHub Issues](https://github.com/striderlabs/mcp-rei/issues)
- [REI](https://www.rei.com)