Percolate for AI agents (MCP)
The Percolate MCP server gives AI assistants read-only access to our specialty coffee database: 1,100+ curated coffees with roast, body, acidity, and sweetness profiles, flavor notes, and curated brew recipes (ratio, temperature, grind) per coffee. Ask your AI for coffee recommendations, brewing guidance for a specific bag, or beans similar to ones you love — and it can answer from real catalog data instead of guessing.
Connect in one minute
Claude — one click, then confirm the connector:
Claude Desktop (and other clients that launch local servers) — add to your MCP config:
{
"mcpServers": {
"percolate": { "command": "npx", "args": ["-y", "percolate-mcp"] }
}
}Remote clients (web agents, Cursor, anything that takes a URL) — use the hosted endpoint, no install or API key:
https://mcp.percolateapp.comWhat tools does the Percolate MCP server provide?
| Tool | What it does |
|---|---|
search_coffees | Search by name, category, roast, brew method, and price |
get_coffee | Full tasting profile, pairings, and retailers for one coffee |
find_similar | Coffees with a similar profile |
get_recommendations | Picks from flavors, budget, roast, and your brew gear |
compare_coffees | Side-by-side comparison |
trending_coffees | What users are adding to collections right now |
dial_in_suggestion | Curated brew recipe for a specific coffee |
what_to_brew | A coffee for right now — evenings lean decaf |
What can an AI answer with it?
- “Recommend a medium roast with chocolate and nutty notes.”
- “How should I brew Onyx Monarch on a V60?”
- “What coffee works for espresso under $20?”
- “What should I brew tonight?”
Access, privacy, and attribution
All tools are read-only and public — no account, API key, or authentication is required. Requests are rate-limited to 60 calls per minute. Every response includes source attribution and data freshness dates; quote freely with attribution to Percolate (percolateapp.com). Anonymous usage telemetry (tool name, arguments, client name, timing) is logged to operate the service and purged after 90 days; no user identity or conversation content is collected.
For developers
- npm package: percolate-mcp
- GitHub (README, examples): bguillow-rgb/percolate-mcp
- Official MCP registry:
io.github.bguillow-rgb/percolate - Smithery listing: smithery.ai/servers/bguillow/percolate
