# Grocery Delivery (mein-aldi.de) (npm · grocery-delivery-mcp)

Unofficial read-only client for the mein-aldi.de (ALDI Süd) grocery-delivery catalog.

- Trust score: 62/100 (medium)
- Change this week: +16
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `grocery-delivery-mcp`: 62/100 (this document), [markdown](https://verifymcp.io/servers/rayncooper-grocery-delivery-mcp/grocery-delivery-mcp.md), [page](https://verifymcp.io/servers/rayncooper-grocery-delivery-mcp/grocery-delivery-mcp)

## Channel facts

- Registry: `npm`
- Package: `grocery-delivery-mcp`
- Version: `0.2.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 19/100
  - Repository check failed: the declared repository URL returned HTTP 404.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (GPL-3.0-or-later).
  - Actively maintained (last published 23 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 87/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1514 tokens (~116/item across 13 items; 11 tools + 2 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (82% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add rayncooper-grocery-delivery-mcp -- npx -y grocery-delivery-mcp
```

### Codex

```bash
codex mcp add rayncooper-grocery-delivery-mcp -- npx -y grocery-delivery-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "rayncooper-grocery-delivery-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "grocery-delivery-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add rayncooper-grocery-delivery-mcp --command npx --arg -y --arg grocery-delivery-mcp
```

### Hermes

```yaml
mcp_servers:
  rayncooper-grocery-delivery-mcp:
    command: "npx"
    args: ["-y", "grocery-delivery-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "rayncooper-grocery-delivery-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "grocery-delivery-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 62, +47)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] License: unverified → pass
- [functional improvement] Schema quality: unverified → 100
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] Tool coverage: unverified → 100
- [functional] Licence: GPL-3.0-or-later

### 2026-08-02 (score 15, −6)

- [security improvement] Malware scan: unverified → pass
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Schema quality: 100 → unverified

### 2026-07-31 (score 21, −25)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-27 (score 46)

First indexed and scored.

## MCP tools (11)

### `search_products` (~233 tokens)

Search ALDI products

Free-text search of the mein-aldi.de (ALDI Süd grocery delivery) catalog. Returns products with price and availability, plus `facets` (available brands, diet types, labels — feed a value back through label/diet/brand/country to refine). Supports sorting and offset paging. Public data — no login required.

Input parameters:

- `brand` (string): Brand name, e.g. 'MILSANI'
- `country` (string): Country of origin, e.g. 'DE'
- `diet` (string): Diet type, e.g. 'Vegan' or 'Vegetarisch'
- `force_refresh` (boolean): Bypass the cache and fetch fresh
- `label` (string): Product label badge: Bio, Neu, or Aktion (on offer)
- `limit` (integer): Max results (1–30)
- `offset` (integer): Skip this many results (paging)
- `query` (string, required): Free-text query, e.g. 'milch' or 'bio bananen'
- `sort` (string): Sort order (e.g. price_asc for cheapest first)

Output parameters:

- `cacheState` (string)
- `count` (number)
- `degraded` (boolean)
- `facets` (array)
- `fetchedAt` (string)
- `offset` (number)
- `products` (array)
- `query` (string)
- `servicePoint` (string)
- `serviceType` (string)
- `totalCount`

### `get_products` (~101 tokens)

Get ALDI products by SKU

Look up exact products by SKU (numeric, 1–18 digits; short forms are zero-padded). Returns price and availability — this is how you 'check stock' for known items. Invalid or unknown SKUs come back under `missing`.

Input parameters:

- `force_refresh` (boolean): Bypass the cache and fetch fresh
- `skus` (array, required): SKUs to look up, e.g. ['229396', '000000000000228798']

Output parameters:

- `cacheState` (string)
- `degraded` (boolean)
- `fetchedAt` (string)
- `found` (array)
- `missing` (array)
- `requested` (array)
- `servicePoint` (string)
- `serviceType` (string)

### `check_availability` (~84 tokens)

Check availability of a product

One-shot 'is X available right now?'. Searches by text, takes the top match, and re-checks its live availability + price. Returns the match, an available flag, and a few alternatives.

Input parameters:

- `force_refresh` (boolean): Bypass the cache and fetch fresh
- `query` (string, required): What to check, e.g. 'bio bananen'

Output parameters:

- `alternatives` (array)
- `available`
- `cacheState` (string)
- `degraded` (boolean)
- `fetchedAt` (string)
- `match`
- `query` (string)
- `servicePoint` (string)
- `serviceType` (string)

### `list_categories` (~86 tokens)

List ALDI categories

Browse the product category tree. Returns categories with their numeric keys (use a key with browse_category). Optionally start from a parent key and limit the depth.

Input parameters:

- `depth` (integer): How many levels to return (1–5)
- `force_refresh` (boolean): Bypass the cache and fetch fresh
- `parent_key` (string): Start from this category key's children

### `browse_category` (~205 tokens)

Browse products in a category

List products in a category by its numeric key (from list_categories). Supports sorting, offset paging, and the same label/diet/brand/country filters as search_products; returns `facets` for refinement.

Input parameters:

- `brand` (string): Brand name, e.g. 'MILSANI'
- `category_key` (string, required): Numeric category key, e.g. '19000000'
- `country` (string): Country of origin, e.g. 'DE'
- `diet` (string): Diet type, e.g. 'Vegan' or 'Vegetarisch'
- `force_refresh` (boolean): Bypass the cache and fetch fresh
- `label` (string): Product label badge: Bio, Neu, or Aktion (on offer)
- `limit` (integer): Max results (1–30)
- `offset` (integer): Skip this many results (paging)
- `sort` (string): Sort order (e.g. price_asc for cheapest first)

Output parameters:

- `cacheState` (string)
- `categoryKey` (string)
- `count` (number)
- `degraded` (boolean)
- `facets` (array)
- `fetchedAt` (string)
- `offset` (number)
- `products` (array)
- `servicePoint` (string)
- `serviceType` (string)
- `totalCount`

### `list_offers` (~107 tokens)

List current ALDI offers

Current promotional products ('Aktion') across the whole mein-aldi.de catalog — the 'what's on sale right now' list, with price and availability. Supports sorting and offset paging.

Input parameters:

- `force_refresh` (boolean): Bypass the cache and fetch fresh
- `limit` (integer): Max results (1–30)
- `offset` (integer): Skip this many results (paging)
- `sort` (string): Sort order (e.g. price_asc for cheapest first)

Output parameters:

- `cacheState` (string)
- `count` (number)
- `degraded` (boolean)
- `fetchedAt` (string)
- `offset` (number)
- `products` (array)
- `servicePoint` (string)
- `serviceType` (string)
- `totalCount`

### `get_product_details` (~101 tokens)

Get full product details

Full detail for one product by SKU: description, ingredients, allergens, nutrition table (kcal/fat/carbs/…), storage & usage instructions, origin, supplier, unit price, and categories. Richer than get_products, which only returns price + availability.

Input parameters:

- `force_refresh` (boolean): Bypass the cache and fetch fresh
- `sku` (string, required): Product SKU (numeric, 1–18 digits), e.g. '434365'

Output parameters:

- `cacheState` (string)
- `degraded` (boolean)
- `fetchedAt` (string)
- `found` (boolean)
- `product`
- `servicePoint` (string)
- `serviceType` (string)
- `sku` (string)

### `get_delivery_slots` (~95 tokens)

Get delivery slots (experimental)

Delivery time-slot availability for the service point. NOTE: no public endpoint is confirmed yet, so this currently reports supported=false with a reason. Wired for a Phase 2 implementation.

Input parameters:

- `date_from` (string): ISO date (YYYY-MM-DD) — earliest slot
- `date_to` (string): ISO date (YYYY-MM-DD) — latest slot
- `postal_code` (string): German postal code (5 digits)

Output parameters:

- `cacheState` (string)
- `degraded` (boolean)
- `fetchedAt` (string)
- `note` (string)
- `reason` (string)
- `servicePoint` (string)
- `slots` (array)
- `supported` (boolean)

### `get_service_status` (~94 tokens)

Service status

Diagnostics: configured service point, cache stats, circuit-breaker state, and rate-limit knobs — plus store metadata (merchant, available service types, currency, timezone) from /v1/stores. The store info is cached ~24h and degrades to null if the API is unreachable; everything else is local (no network).

Input parameters:

- `force_refresh` (boolean): Bypass the cache and refetch the store metadata

### `connect_aldi_account` (~83 tokens)

Connect my ALDI account

Open ALDI's login in a browser so the user can sign in, then remember the session for cart prefill. Call this when the user wants cart features and isn't connected yet (prefill_cart will say so). A real browser window opens and the user logs in themselves; nothing is automated, and no order is placed. The session refreshes automatically afterward.

Output parameters:

- `connected` (boolean)
- `cookies` (number)
- `sessionFile` (string)

### `prefill_cart` (~154 tokens)

Prefill my ALDI cart

Add products to the user's own mein-aldi.de cart so it is ready to check out in the browser (they still pay and pick a slot — this never places an order). Each item is a product name (resolved to the top public-search hit) or an 18-digit SKU, plus a quantity. If the account isn't connected yet, this returns a note to call connect_aldi_account first. Set dry_run to preview name→SKU resolution without modifying the cart.

Input parameters:

- `dry_run` (boolean): Resolve + preview only; do not modify the cart
- `items` (array, required): Products to add to the cart (max 50)
- `slots` (boolean): Also report how many delivery slots are available

Output parameters:

- `added` (array)
- `cartId`
- `dryRun` (boolean)
- `misses` (array)
- `needsConnect` (boolean)
- `refreshed` (boolean)
- `slots`
- `unconfirmed` (array)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/rayncooper-grocery-delivery-mcp/grocery-delivery-mcp#diagnostics

## Score history

- 2026-08-03: 62
- 2026-08-02: 15
- 2026-08-01: 21
- 2026-07-31: 21
- 2026-07-30: 46
- 2026-07-28: 46
- 2026-07-27: 46

## Links

- npm package: https://www.npmjs.com/package/grocery-delivery-mcp
- Socket report: https://socket.dev/npm/package/grocery-delivery-mcp
- Changelog RSS feed: https://verifymcp.io/servers/rayncooper-grocery-delivery-mcp/grocery-delivery-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/rayncooper-grocery-delivery-mcp/grocery-delivery-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/rayncooper-grocery-delivery-mcp/grocery-delivery-mcp