Percolate

io.github.bguillow-rgbPublished by GitHub account bguillow-rgbv1.0.2Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableLocation & LifestyleData & Analytics

Overview

AI-generated overview

Percolate lets an assistant search a curated specialty coffee catalog and get brew recipes, pairings, comparisons and recommendations.

What you can do
Search the catalog by category, roast level, brew method and price, and fetch a full record for one coffee with tasting profile, pairings and retailers. Find similar coffees by flavor overlap and roast/body/acidity proximity, and compare two coffees side by side. Get recommendations from flavor preferences, budget, roast and brew gear, plus trending coffees. Ask for brew guidance (ratio, temperature, grind) or a suggestion of what to brew right now.
When to use it
Useful when you want an assistant to answer coffee questions: picking a bag to buy, dialing in a brew method, comparing two coffees, or finding something similar to one you like.
Requirements
Either the remote streamable HTTP endpoint or the npm package percolate-mcp run locally with Node.js 18+. No API key or configuration is needed for public read-only access. Optional environment variables SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY override defaults.
Before you install
The optional SUPABASE_SERVICE_ROLE_KEY is described as internal use only and must not be distributed; without it, trending results fall back to catalog popularity. Each tool call logs the tool name, arguments, client name/version, duration and outcome to a write-only table kept 90 days. Retailer links may be affiliate links. All tools are read-only.

Installation

In SourceWeft

  1. Open Percolate in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.bguillow-rgb%2Fpercolate/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Percolate MCP Server

Query the Percolate specialty coffee database from Claude, or any MCP-compatible AI client. Read-only access to 1,100+ curated coffees with tasting profiles, brew recipes, pairings, and where-to-buy links.

Percolate is the specialty coffee journal for iOS — get it on the App Store.

Tools

ToolWhat it does
search_coffeesCatalog search with category, roast level, brew method, and price filters
get_coffeeFull record for one coffee: roast, body/acidity/sweetness, flavors, pairings, retailers
find_similarSimilar coffees by flavor overlap and roast/body/acidity proximity
get_recommendationsPicks from flavor preferences + budget + roast + your brew gear
compare_coffeesSide-by-side: profiles, shared/distinct flavors, price delta
trending_coffeesWhat Percolate users are adding to their collections right now
dial_in_suggestionBrew guidance for a specific coffee — curated recipes (ratio, temp, grind) from the catalog, or a roast-based starting point
what_to_brewA coffee for right now — evening picks lean decaf, mornings lean bright

Every response includes source attribution, a citation-ready summary line, links, and data freshness dates. All scoring is deterministic — no AI calls happen inside the server. All tools are annotated read-only/idempotent.

Install (Claude Desktop)

Requires Node.js 18+.

Add to your claude_desktop_config.json (Claude Desktop → Settings → Developer → Edit Config):

json
{  "mcpServers": {    "percolate": {      "command": "npx",      "args": ["-y", "percolate-mcp"]    }  }}

Restart Claude Desktop. No API key or configuration needed — the server ships with public read-only access.

Configuration (optional)

Environment variables override the defaults (explicit env vars only — this package never reads .env files):

VariablePurpose
SUPABASE_URLOverride the database URL
SUPABASE_SERVICE_ROLE_KEYInternal use only — unlocks live 30-day collection-add trending. Never distribute this key.

Without the service key, trending_coffees falls back to catalog popularity and labels the method in its response.

Remote endpoint (no install)

Streamable HTTP for web agents and MCP clients that take a URL:

https://wmpiabzlcaqyrzxvfihi.supabase.co/functions/v1/mcp

Also listed on Smithery and the official MCP registry as io.github.bguillow-rgb/percolate.

Example agent requests

Questions an agent can answer with these tools:

  • "Recommend a medium roast with chocolate and nutty notes." → get_recommendations with preferences: ["chocolate","nutty"], roast_level: "medium"
  • "How should I brew this Onyx Monarch on a V60?" → dial_in_suggestion (curated recipes: ratio, temperature, grind)
  • "What coffee works for espresso under $20?" → search_coffees with brew_method: "espresso", price_max: 20
  • "What should I brew tonight?" → what_to_brew (evening picks lean decaf automatically)
  • "Find me something similar to this Ethiopian natural." → find_similar
  • "Compare these two bags." → compare_coffees

Example response shape (truncated):

json
{  "method": "curated_pairing",  "recipes": [    { "recipe": "Pour-over (V60), 1:16, 205°F",      "why": "clarity that lets the delicate, high-acid notes open up" }  ],  "attribution": {    "source": "Percolate — Specialty Coffee Journal",    "links": { "website": "https://percolateapp.com/" }  }}

Development

bash
npm installnpm run dev     # run from TypeScript via tsxnpm run build   # compile to dist/npm start       # run compiled server

The server speaks MCP over stdio. Catalog access is read-only by construction: every query path issues SELECTs against tables that are publicly readable under row-level security, and it is rate-limited to 60 calls/minute.

Usage telemetry: each tool call logs the tool name, its arguments, client name/version, duration, and success/failure to a write-only log table (insert-only under RLS; contents are not publicly readable; purged after 90 days). No user identity, account data, or conversation content is collected. Logging is fire-and-forget and never affects responses.

Data & attribution

Coffee data, tasting profiles, brew recipes, and pairings are curated by Percolate. Retailer links may be affiliate links. Quote freely with attribution:

Source: Percolate — Specialty Coffee Journal (percolateapp.com)

Freshness dates on each coffee reflect the last data update.

Source: README.md at commit ada7f3e

Tools

0
SourceWeft has not read this server's tools yet.

Version history

2
  1. v1.0.2LatestSep 17, 2026
  2. v1.0.1Sep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts