Percolate

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Percolate": {
      "url": "https://mcp.percolateapp.com/?src=registry",
      "transport": "streamable-http"
    }
  }
}

Measured tools (8)

• search_coffees read-only

  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).

  Parameters:

  • limit — integer — Max results (default 10, max 10)
  • query — string — Free-text search: coffee or roaster name
  • category — string — Coffee category to filter by; omit to search all
  • price_max — number — Maximum price in USD
  • price_min — number — Minimum price in USD
  • brew_method — string — e.g. 'espresso', 'pourover', 'french press', 'drip'
  • roast_level — string — Roast level to filter by; omit to include all roasts

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_coffee read-only

  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.

  Parameters:

  • id_or_name (required) — string — Coffee id or a name like 'Bean Box Taste of New York City'

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• find_similar read-only

  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.

  Parameters:

  • coffee (required) — string — Coffee id or name
  • limit — integer — Max results (default 5)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_recommendations read-only

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

  Parameters:

  • preferences (required) — array — Flavors the drinker enjoys, e.g. ['chocolate','caramel','nutty']
  • limit — integer — Max results (default 5)
  • budget — number — Max price in USD per bag
  • brew_method — string — What you brew with, e.g. 'espresso', 'pourover'
  • roast_level — string — Roast level to filter by; omit to include all roasts

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• compare_coffees read-only

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

  Parameters:

  • coffee_a (required) — string — First coffee — id or name
  • coffee_b (required) — string — Second coffee — id or name

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• trending_coffees read-only

  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.

  Parameters:

  • limit — integer — Max results (default 10, max 10)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• dial_in_suggestion read-only

  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.

  Parameters:

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

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• what_to_brew read-only

  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.

  Parameters:

  • mood — string — e.g. 'need focus', 'lazy weekend', 'something comforting', 'adventurous'
  • brew_method — string — What you're brewing with
  • time_of_day — string — When the coffee will be drunk — shifts the pick toward lighter or lower-caffeine options later in the day

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.