# MCP Connector for Sam's Club

An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that exposes Sam's Club product search, store locator, and membership information as tools for AI assistants.

## Tools

### `search_products`

Search Sam's Club products by keyword, with optional category filtering and result count control.

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Search term (e.g. "olive oil", "TV", "laundry detergent") |
| `category` | string | No | Filter by category: `Electronics`, `Grocery`, `Household`, `Meat & Seafood`, `Appliances`, `Outdoor` |
| `maxResults` | number | No | Max results to return (default: 10, max: 15) |

**Example response fields:** `id`, `name`, `category`, `price`, `unit`, `availability`, `rating`, `reviews`

---

### `find_clubs`

Find Sam's Club warehouse locations near a zip code or city.

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `location` | string | Yes | Zip code (e.g. `"72712"`) or city/state (e.g. `"Bentonville, AR"`) |
| `radius` | number | No | Search radius in miles (default: 25) |

**Example response fields:** club `id`, `name`, `address`, `phone`, `hours`, `services`, `distanceMiles`

---

### `get_membership_info`

Returns Sam's Club membership tiers, annual fees, and benefits. Takes no parameters.

**Response includes:** membership types (standard and Plus), annual fees, benefits lists, add-on pricing, free trial details, and contact information.

---

## Installation

```bash
npm install
npm run build
```

## Usage

### Run directly

```bash
node dist/index.js
```

### Configure in Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "samsclub": {
      "command": "node",
      "args": ["/path/to/mcp-samsclub/dist/index.js"]
    }
  }
}
```

Or if installed globally via npm:

```json
{
  "mcpServers": {
    "samsclub": {
      "command": "mcp-samsclub"
    }
  }
}
```

## Development

```bash
# Install dependencies
npm install

# Build
npm run build

# Pack for distribution
npm pack
```

## Notes

This connector uses realistic mock data and does not make live requests to Sam's Club servers. It is intended for development, testing, and demonstration purposes.

## License

MIT