# Percolate

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

- name: io.github.bguillow-rgb/percolate
- version: 1.0.2
- connection class: R0 (autonomous)
- trust: 94/100
- quality: 82/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.bguillow-rgb%2Fpercolate
- tools: https://api.protogrid.dev/v1/servers/io.github.bguillow-rgb%2Fpercolate/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "percolate": {
      "type": "http",
      "url": "https://mcp.percolateapp.com/?src=registry"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 100
- freshness: 85
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-100% ~updated-34d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 82/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-03-26; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 8 of 8 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 1,557 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 8 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: 67 (weight 15)

- pass `deps.known_vulns`: no known advisory in 100 resolved packages
- fail `deps.mcp_sdk_version`: @modelcontextprotocol/sdk 1.30.1 has 1 known advisory (GHSA-6qxp-vccf-f47h); update @modelcontextprotocol/sdk to 1.31.0 or later
- pass `deps.resolvable`: percolate-mcp@1.0.2 resolved: 100 packages

- tools: 8, about 1,557 tokens to load them all
- tool set hash: 769c01a9e8e931620a6e6a950623168c
- tools last changed: 2026-10-03T23:08:22.903Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.bguillow-rgb/percolate.svg)](https://protogrid.dev/servers/io.github.bguillow-rgb/percolate)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-03 `what_to_brew` changed (annotations)
- 2026-10-03 `dial_in_suggestion` changed (annotations)
- 2026-10-03 `trending_coffees` changed (annotations)
- 2026-10-03 `compare_coffees` changed (annotations)
- 2026-10-03 `get_recommendations` changed (annotations)
- 2026-10-03 `find_similar` changed (annotations)
- 2026-10-03 `get_coffee` changed (description, annotations)
  - before: 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.
  - after: Detailed record for one coffee: roast level, body/acidity/sweetness profile, flavor notes, suited brew methods, food and brew pairings, price, and retailer names with prices (no purchase links). Accepts a Percolate id or a name.
- 2026-10-03 `search_coffees` changed (description, annotations)
  - before: 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.
  - after: 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 retailer names with prices (no purchase links).

Full history: https://api.protogrid.dev/v1/servers/io.github.bguillow-rgb%2Fpercolate/changes

## Dependencies

- npm percolate-mcp@1.0.2: resolved, 99 dependencies, MCP SDK @modelcontextprotocol/sdk 1.30.1
  - GHSA-6qxp-vccf-f47h (high) in `` @modelcontextprotocol/sdk@1.30.1 ``, direct, fixed in `` 1.31.0 ``, advisory summary: "MCP TypeScript SDK: OAuth client could send credentials to an authorization server chosen by the MCP server" https://osv.dev/vulnerability/GHSA-6qxp-vccf-f47h

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0.

## Remotes

- https://mcp.percolateapp.com/?src=registry (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

- npm percolate-mcp@1.0.2

## Tools (8)

- `compare_coffees`: Side-by-side comparison: roast, body/acidity/sweetness, shared and distinct flavors, brew methods, and price difference.
- `dial_in_suggestion`: 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.
- `find_similar`: 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.
- `get_coffee`: Detailed record for one coffee: roast level, body/acidity/sweetness profile, flavor notes, suited brew methods, food and brew pairings, price, and retailer names with prices (no purchase links). Accepts a Percolate id or a name.
- `get_recommendations`: Personalized coffee picks from flavor preferences (e.g. 'chocolate', 'berry', 'caramel'), a budget in USD, roast preference, and the brew gear you own.
- `search_coffees`: 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 retailer names with prices (no purchase links).
- `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.
- `what_to_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.