# io.github.bguillow-rgb/percolate (npm · percolate-mcp)

Search the Percolate specialty coffee database: 1,100+ coffees with brew recipes and pairings.

- Trust score: 69/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-17

## Components

- npm · `percolate-mcp`: 69/100 (this document), [markdown](https://verifymcp.io/servers/bguillow-rgb-percolate/percolate-mcp.md), [page](https://verifymcp.io/servers/bguillow-rgb-percolate/percolate-mcp)

## Channel facts

- Registry: `npm`
- Package: `percolate-mcp`
- Version: `1.0.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-17.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 30 of 98 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 3 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 80/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 749 tokens (~93/item across 8 items; 8 tools + 0 resources), lean.
  - 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**: 94/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 83% of tool parameters carry a description.
- **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 bguillow-rgb-percolate -- npx -y percolate-mcp
```

### Codex

```bash
codex mcp add bguillow-rgb-percolate -- npx -y percolate-mcp
```

### opencode

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

### OpenClaw

```bash
openclaw mcp add bguillow-rgb-percolate --command npx --arg -y --arg percolate-mcp
```

### Hermes

```yaml
mcp_servers:
  bguillow-rgb-percolate:
    command: "npx"
    args: ["-y", "percolate-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "bguillow-rgb-percolate": {
      "command": "npx",
      "args": [
        "-y",
        "percolate-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-13 (score 69)

First indexed and scored.

## MCP tools (8)

### `search_coffees` (~161 tokens)

Search the Percolate catalog

Search 1,100+ curated specialty coffees in the Percolate database. Filter by category (espresso, single_origin, blend, decaf, dark), roast level, brew method, and price (USD). Returns tasting profiles, brew methods, and where-to-buy links.

Input parameters:

- `brew_method` (string): e.g. 'espresso', 'pourover', 'french press', 'drip'
- `category` (string)
- `limit` (integer): Max results (default 10)
- `price_max` (number): Maximum price in USD
- `price_min` (number): Minimum price in USD
- `query` (string): Free-text search: coffee or roaster name
- `roast_level` (string)

### `get_coffee` (~79 tokens)

Get coffee details

Detailed record for one coffee: roast level, body/acidity/sweetness profile, flavor notes, suited brew methods, food and brew pairings, price, and retailer links. Accepts a Percolate id or a name.

Input parameters:

- `id_or_name` (string, required): Coffee id or a name like 'Bean Box Taste of New York City'

### `find_similar` (~72 tokens)

Find similar coffees

Coffees with a similar profile to a given one, ranked by shared flavor notes and roast/body/acidity/sweetness proximity. Deterministic scoring over Percolate's structured tasting data.

Input parameters:

- `coffee` (string, required): Coffee id or name
- `limit` (integer): Max results (default 5)

### `get_recommendations` (~129 tokens)

Get personalized recommendations

Personalized coffee picks from flavor preferences (e.g. 'chocolate', 'berry', 'caramel'), a budget in USD, roast preference, and the brew gear you own.

Input parameters:

- `brew_method` (string): What you brew with, e.g. 'espresso', 'pourover'
- `budget` (number): Max price in USD per bag
- `limit` (integer): Max results (default 5)
- `preferences` (array, required): Flavors the drinker enjoys, e.g. ['chocolate','caramel','nutty']
- `roast_level` (string)

### `compare_coffees` (~64 tokens)

Compare two coffees

Side-by-side comparison: roast, body/acidity/sweetness, shared and distinct flavors, brew methods, and price difference.

Input parameters:

- `coffee_a` (string, required): First coffee — id or name
- `coffee_b` (string, required): Second coffee — id or name

### `trending_coffees` (~63 tokens)

Trending coffees

Coffees Percolate users are adding to their collections most over the last 30 days (falls back to catalog popularity when live activity data is unavailable). The method used is labeled in the response.

Input parameters:

- `limit` (integer): Max results (default 10)

### `dial_in_suggestion` (~86 tokens)

Dial in this coffee

Brew guidance for a specific coffee: curated recipes from the Percolate catalog (ratio, temperature, grind) when available, or a roast-based starting point. Optionally scoped to your brew method.

Input parameters:

- `brew_method` (string): Your brewer, e.g. 'V60', 'espresso', 'french press'
- `coffee` (string, required): Coffee id or name

### `what_to_brew` (~95 tokens)

What should I brew?

A coffee suggestion for right now, based on time of day (evening picks lean decaf), mood, and the brew method you're using — scored over Percolate's tasting profiles.

Input parameters:

- `brew_method` (string): What you're brewing with
- `mood` (string): e.g. 'need focus', 'lazy weekend', 'something comforting', 'adventurous'
- `time_of_day` (string)

## Diagnostics

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

## Score history

- 2026-08-17: 69
- 2026-08-16: 69
- 2026-08-15: 69
- 2026-08-14: 69
- 2026-08-13: 69

## Links

- npm package: https://www.npmjs.com/package/percolate-mcp
- Socket report: https://socket.dev/npm/package/percolate-mcp
- Repository: https://github.com/bguillow-rgb/percolate-mcp
- Changelog RSS feed: https://verifymcp.io/servers/bguillow-rgb-percolate/percolate-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/bguillow-rgb-percolate/percolate-mcp.json
- HTML version of this page: https://verifymcp.io/servers/bguillow-rgb-percolate/percolate-mcp