CellarTracker
NPM · CELLARTRACKER-MCP · SCANNED AUG 3
Read-only access to your CellarTracker wine cellar: inventory, drinking windows, purchases, notes.
Available components
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. How we score →
Supply Chain Security87
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to slavins-co/cellartracker-mcp). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 20 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability85
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Tool/resource definitions use about 1564 tokens (~71/item across 22 items; 13 tools + 9 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management23
- Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · cellartracker-mcp
claude mcp add slavins-co-cellartracker-mcp -- npx -y cellartracker-mcp
codex mcp add slavins-co-cellartracker-mcp -- npx -y cellartracker-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"slavins-co-cellartracker-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"cellartracker-mcp"
],
"enabled": true
}
}
} openclaw mcp add slavins-co-cellartracker-mcp --command npx --arg -y --arg cellartracker-mcp
mcp_servers:
slavins-co-cellartracker-mcp:
command: "npx"
args: ["-y", "cellartracker-mcp"] {
"mcpServers": {
"slavins-co-cellartracker-mcp": {
"command": "npx",
"args": [
"-y",
"cellartracker-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 +61
- Install scripts: unverified → pass ▲ security
- Provenance: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- The attested source repository moved: slavins-co/cellartracker-mcp security
- Schema quality: unverified → excellent ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- License: unverified → pass ▲ functional
- Schema quality: unverified → 100 ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Stability: unverified → 0.23 ▲ functional
- Licence: MIT functional
- 2 Aug 26 −6
- Malware scan: unverified → pass ▲ security
- Schema quality: 100 → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- 1 Aug 26 +19
- Dependency health: partial → unverified ▼ functional
- Tool coverage: unverified → 100 ▲ functional
- Schema quality: unverified → 100 ▲ functional
- 31 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 −47
- Malware scan: pass → unverified ▼ security
- Tool coverage: 100 → unverified ▼ functional
- Schema quality: 100 → unverified ▼ functional
- 27 Jul 26 53
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/[email protected]
Provenance verified
Ecosystem: npm · Outcome: verified
Reason: verified
- Source repo:
- slavins-co/cellartracker-mcp
- Certificate issuer:
- https://token.actions.githubusercontent.com
- Certificate SAN:
- https://github.com/slavins-co/cellartracker-mcp/.github/workflows/publish.yml@refs/tags/v0.5.0
- Rekor log index:
- 2158848831
- Predicate type:
- https://slsa.dev/provenance/v1
- Subject digest:
- sha512:a8be7b5650551cf887475d010e388aff467498708f6f2a92e75d2d63a4ee2142095405ff28419e88ec267857fbccdb3a6783ba2233bdee90a82a11412
- Discovery method:
- attestation_endpoint
Dependencies 95 packages
95 packages in the resolved dependency tree · 95 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
bottle-details ~304
Look up individual bottles from the Bottles table — the per-bottle view spanning both in-cellar and consumed bottles, with barcode, exact location/bin, and size. Filter by wine name, location, bin, size, or barcode; set state to 'cellar' (default 'all' includes consumed). If the user attaches a photo of a bottle or its barcode, read the barcode digits from the image and pass them as the barcode filter. Location and Bin are account-specific labels, not physical descriptions — if a location/bin filter finds nothing, use cellar-stats with group_by=location or group_by=bin to see the actual values in use. Returns up to max_results per page (default 25) — pass offset to page through more.
| Name | Type | Req | Description |
|---|---|---|---|
| barcode | string | — | Bottle barcode — e.g. read from a photo |
| bin | string | — | Specific bin/position (e.g. 'Drawer 2', '1-3') |
| location | string | — | Storage location (e.g. 'Wine Fridge') |
| max_results | number | — | Maximum results (default 25) |
| offset | number | — | Result offset for pagination (default 0) |
| query | string | — | Wine name search term |
| size | string | — | Bottle format (e.g. '750ml', '1500ml') |
| state | string | — | Which bottles: 'cellar', 'consumed', or 'all' (default) |
| Name | Type | Req | Description |
|---|---|---|---|
| bottles | array | yes | — |
| count | number | yes | — |
| offset | number | yes | — |
| total | number | yes | — |
No examples provided.
cellar-stats ~56
Get cellar statistics: total bottles, value, unique wines, and optional breakdowns. Valid group_by options: color, country, region, varietal, location, bin, category.
| Name | Type | Req | Description |
|---|---|---|---|
| group_by | string | — | Breakdown dimension |
| Name | Type | Req | Description |
|---|---|---|---|
| avgPerWine | number | yes | — |
| breakdown | object | — | — |
| totalBottles | number | yes | — |
| totalValue | number | yes | — |
| uniqueWines | number | yes | — |
No examples provided.
clear-user-data ~65
Remove stored CellarTracker credentials and cached wine data from this machine. Use this to fully disconnect your account or free up disk space.
| Name | Type | Req | Description |
|---|---|---|---|
| clear_cache | boolean | — | Delete cached CSV exports (default true) |
| clear_credentials | boolean | — | Delete saved credentials (default true) |
| Name | Type | Req | Description |
|---|---|---|---|
| cacheFilesRemoved | number | yes | — |
| credentials | string | yes | — |
No examples provided.
consumption-history ~144
Search your consumption history — wines you've opened and drunk. Filter by wine name, color, or date range. Returns most recent consumptions first with tasting context, up to max_results per page (default 25) — pass offset to page through more.
| Name | Type | Req | Description |
|---|---|---|---|
| color | string | — | Filter by color (Red, White, Rosé) |
| date_from | string | — | Start date (YYYY-MM-DD) |
| date_to | string | — | End date (YYYY-MM-DD) |
| max_results | number | — | Maximum results (default 25) |
| offset | number | — | Result offset for pagination (default 0) |
| query | string | — | Wine name search term |
| Name | Type | Req | Description |
|---|---|---|---|
| count | number | yes | — |
| offset | number | yes | — |
| rows | array | yes | — |
| total | number | yes | — |
No examples provided.
drinking-recommendations ~80
Get wine drinking recommendations sorted by urgency. Prioritizes wines that are past peak, then those with closing windows, then wines currently in their drinking window. Optionally filter by color.
| Name | Type | Req | Description |
|---|---|---|---|
| color | string | — | Filter by color |
| max_results | number | — | Maximum results (default 10) |
| occasion | string | — | Occasion description |
| Name | Type | Req | Description |
|---|---|---|---|
| recommendations | array | yes | — |
No examples provided.
get-wishlist ~39
View your CellarTracker wishlist wines. Optionally search by wine name, region, or varietal.
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | — | Search term |
| Name | Type | Req | Description |
|---|---|---|---|
| count | number | yes | — |
| wines | array | yes | — |
No examples provided.
incoming-orders ~58
List wines ordered but not yet received, from the Pending table. Sorted oldest order first. Use this for 'what's on the way', unlike recent-deliveries which shows what has already arrived.
| Name | Type | Req | Description |
|---|---|---|---|
| store | string | — | Store name filter |
| Name | Type | Req | Description |
|---|---|---|---|
| rows | array | yes | — |
| total | number | yes | — |
No examples provided.
purchase-history ~94
Search purchase history with spending summary. Filter by wine name, store, or date range (YYYY-MM-DD format). Shows total spent, average price, per-store breakdown, and recent purchases.
| Name | Type | Req | Description |
|---|---|---|---|
| date_from | string | — | Start date (YYYY-MM-DD) |
| date_to | string | — | End date (YYYY-MM-DD) |
| query | string | — | Wine name search |
| store | string | — | Store name filter |
| Name | Type | Req | Description |
|---|---|---|---|
| avgPrice | number | yes | — |
| bottleCount | number | yes | — |
| byStore | array | yes | — |
| recent | array | yes | — |
| totalSpent | number | yes | — |
No examples provided.
recent-deliveries ~103
List wines actually delivered (received) in a date range, keyed on DeliveryDate. Defaults to the last 30 days. Use this for 'what just landed', unlike purchase-history which keys on order date.
| Name | Type | Req | Description |
|---|---|---|---|
| date_from | string | — | Start delivery date (YYYY-MM-DD). Defaults to 30 days ago. |
| date_to | string | — | End delivery date (YYYY-MM-DD). Defaults to today. |
| store | string | — | Store name filter |
| Name | Type | Req | Description |
|---|---|---|---|
| mostRecentDelivery | string | — | — |
| rows | array | yes | — |
| total | number | yes | — |
No examples provided.
refresh-data ~33
Force refresh all CellarTracker data from the server. Downloads fresh CSV exports for all 8 tables regardless of cache age.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| refreshedAt | string | yes | — |
| serverVersion | string | yes | — |
| tables | array | yes | — |
No examples provided.
search-cellar ~168
Search your wine cellar by name, color, region, varietal, location, or vintage range. The region parameter searches across Country, Region, SubRegion, Appellation, and Locale fields. Returns matching wines with details, up to 25 per page — pass offset to page through more.
| Name | Type | Req | Description |
|---|---|---|---|
| color | string | — | Filter by color (Red, White, Rosé) |
| location | string | — | Storage location |
| offset | number | — | Result offset for pagination (default 0) |
| query | string | — | Wine name search term |
| region | string | — | Region, country, or appellation |
| varietal | string | — | Grape varietal |
| vintage_max | number | — | Maximum vintage year |
| vintage_min | number | — | Minimum vintage year |
| Name | Type | Req | Description |
|---|---|---|---|
| count | number | yes | — |
| offset | number | yes | — |
| total | number | yes | — |
| wines | array | yes | — |
No examples provided.
setup-credentials ~69
Set up or update your CellarTracker login credentials. Validates credentials against CellarTracker before saving. Use this if you just installed the plugin or need to change your login.
| Name | Type | Req | Description |
|---|---|---|---|
| password | string | yes | Your CellarTracker password |
| username | string | yes | Your CellarTracker username |
| Name | Type | Req | Description |
|---|---|---|---|
| envOverrideActive | boolean | yes | — |
| status | string | yes | — |
No examples provided.
tasting-notes ~125
Search your tasting notes and reviews. Filter by wine name, color, or minimum rating. Returns notes with ratings, scores, and tasting details, up to max_results per page (default 25) — pass offset to page through more.
| Name | Type | Req | Description |
|---|---|---|---|
| color | string | — | Filter by color (Red, White, Rosé) |
| max_results | number | — | Maximum results (default 25) |
| min_rating | number | — | Minimum rating filter |
| offset | number | — | Result offset for pagination (default 0) |
| query | string | — | Wine name search term |
| Name | Type | Req | Description |
|---|---|---|---|
| count | number | yes | — |
| offset | number | yes | — |
| rows | array | yes | — |
| total | number | yes | — |
No examples provided.