# @striderlabs/mcp-aldi

MCP (Model Context Protocol) connector for Aldi grocery. Provides tools for searching products, finding stores, browsing weekly specials, and more.

## Installation

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

## Usage

### With Claude Desktop

Add to your `claude_desktop_config.json`:

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

### Run directly

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

## Available Tools

### `search_products`
Search the Aldi product catalog by keyword or category.

**Parameters:**
- `query` (required) — search term (e.g. "organic milk", "pasta")
- `category` (optional) — filter by category: `dairy`, `produce`, `bakery`, `frozen`, `meat`, `snacks`, `beverages`, `dry-goods`, `breakfast`
- `limit` (optional) — max results (default 10, max 50)

### `find_stores`
Find Aldi store locations near an address, city, or zip code.

**Parameters:**
- `location` (required) — address, city, or zip code
- `radius_miles` (optional) — search radius in miles (default 10, max 50)
- `limit` (optional) — max stores to return (default 5, max 20)

### `get_weekly_specials`
Get current weekly deals and ALDI Finds.

**Parameters:**
- `store_id` (optional) — store-specific specials
- `category` (optional) — filter by category (e.g. `produce`, `meat`, `aldi-finds`)

### `get_product_details`
Get detailed product info including nutrition facts, ingredients, and price.

**Parameters:**
- `product_id` (required) — product ID from `search_products`

### `get_store_hours`
Get hours and contact info for a specific store.

**Parameters:**
- `store_id` (required) — store ID from `find_stores`

### `check_product_availability`
Check if a product is available at a specific store.

**Parameters:**
- `product_id` (required)
- `store_id` (required)

## Development

```bash
# Install dependencies
npm install

# Build
npm run build

# Run dev (requires tsx)
npm run dev
```

## License

MIT