
Percolate MCP server
online · 100% uptimeSearch the Percolate specialty coffee database: 1,100+ coffees with brew recipes and pairings.
0 stars40 downloads/wk
Reviews
Write oneNobody has reviewed Percolate yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Percolate tools (8)
write = sends, deletes, buys or postscompare_coffeesFreeSide-by-side comparison: roast, body/acidity/sweetness, shared and distinct flavors, brew methods, and price difference.
dial_in_suggestionFreeBrew 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_similarFreeCoffees 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_coffeeFreeDetailed 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.
get_recommendationsFreePersonalized coffee picks from flavor preferences (e.g. 'chocolate', 'berry', 'caramel'), a budget in USD, roast preference, and the brew gear you own.
search_coffeesFreeSearch 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.
trending_coffeesFreeCoffees 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_brewFreeA 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.
Public scan report
scanner v0.1.10 · 2026-10-03 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned25/25
- Live reliabilityremote reachable in 2352ms17/20
- Tool poisoning8 tool descriptions checked15/15
- Auth qualityopen endpoint, read-only tools10/15
- Maintenancelast push 26 days ago15/15
- Maintainer identityregistry namespace matches repository owner6/10
How Percolate compares
Against every graded Databases MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 88/100
- higher than 75% of 802 Databases servers
- Tools
- 8
- the typical Databases server has 8
- Tools that change things
- 0%
- typical: 10%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote Databases server answers 100%
- Response time
- 727 ms
- faster than 12% of 292 Databases servers
- Downloads a week
- 40
- more than 27% of 328 Databases servers with a package
What its tools let an agent do: 8 read
Install Percolate in Claude Code, Cursor or VS Code
claude mcp add --transport http percolate https://mcp.percolateapp.com/?src=registry
What the publisher says
From the Percolate repository's README, as published. We do not edit it. Read it on GitHub
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
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 claudedesktopconfig.json (Claude Desktop → Settings → Developer → Edit Config):
{
"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):
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/mcpAlso 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." → getrecommendations with preferences: ["chocolate","nutty"], roastlevel: "medium"
- "How should I brew this Onyx Monarch on a V60?" → dialinsuggestion (curated recipes: ratio, temperature, grind)
- "What coffee works for espresso under $20?" → searchcoffees with brewmethod: "espresso", price_max: 20
- "What should I brew tonight?" → whattobrew (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):
{
"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
npm install
npm run dev # run from TypeScript via tsx
npm run build # compile to dist/
npm start # run compiled serverShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Percolate: common questions
- Is Percolate MCP server safe?
- Yes, by our scan: it is graded A (88/100). Read the Percolate safety report
- How do I install Percolate?
- It runs remotely at mcp.percolateapp.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Percolate need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Percolate maintained?
- The last commit was 58 days ago (2026-09-07). The latest release is v1.0.2.
- Is Percolate up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of Percolate?
- Servers from other publishers that do the same job: CogniCore MCP server, DBHub MCP server and Neo4j Cypher MCP server.
- How does Percolate compare with other Databases MCP servers?
- safety score 88/100 (higher than 75% of 802 Databases servers); tools 8 (the typical Databases server has 8); tools that change things 0% (typical: 10%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Percolate
Same job from other publishers: the closest match first, then the best rated.
- CogniCoreMemory, reflection and safety for AI agents. Hosted or local, no vector database.5.0(1)GrowingA
- DBHubToken-efficient database MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLitenot reviewedWidely usedA
- Neo4j CypherA simple Neo4j MCP server that allows you to run Cypher queries against a Neo4j database.not reviewedEstablishedA
- AppwriteBuild and deploy backends: auth, Postgres/MySQL/vector databases, storage, functions, hosting, CDNnot reviewedEstablishedA
AirtableRead and write access to Airtable database schemas, tables, and records.not reviewedEstablishedB