MCP-Server

Percolate

io.github.bguillow-rgb/percolate
Commerce & Retail Öffentlich und erreichbar MCP 2026-07-28

Was dieses MCP kann

Searches and compares specialty coffees, provides tasting and brewing details, recommends products, and links to retailers.

compare_coffees
Side-by-side comparison: roast, body/acidity/sweetness, shared and distinct flavors, brew methods, and price difference.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['coffee_a', 'coffee_b'], 'properties': {'coffee_a': {'type': 'string', 'maxLength': 200, 'description': 'First coffee â\x80\x94 id or name'}, 'coffee_b': {'type': 'string', 'maxLength': 200, 'description': 'Second coffee â\x80\x94 id or name'}}, 'additionalProperties': False}
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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['coffee'], 'properties': {'coffee': {'type': 'string', 'maxLength': 200, 'description': 'Coffee id or name'}, 'brew_method': {'type': 'string', 'maxLength': 120, 'description': "Your brewer, e.g. 'V60', 'espresso', 'french press'"}}, 'additionalProperties': False}
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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['coffee'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 5)'}, 'coffee': {'type': 'string', 'maxLength': 200, 'description': 'Coffee id or name'}}, 'additionalProperties': False}
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 links. Accepts a Percolate id or a name.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id_or_name'], 'properties': {'id_or_name': {'type': 'string', 'maxLength': 120, 'description': "Coffee id or a name like 'Bean Box Taste of New York City'"}}, 'additionalProperties': False}
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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['preferences'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 5)'}, 'budget': {'type': 'number', 'minimum': 0, 'description': 'Max price in USD per bag'}, 'brew_method': {'type': 'string', 'maxLength': 120, 'description': "What you brew with, e.g. 'espresso', 'pourover'"}, 'preferences': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60}, 'maxItems': 20, 'minItems': 1, 'description': "Flavors the drinker enjoys, e.g. ['chocolate','caramel','nutty']"}, 'roast_level': {'enum': ['light', 'medium-light', 'medium', 'medium-dark', 'dark'], 'type': 'string', 'description': 'Roast level to filter by; omit to include all roasts'}}, 'additionalProperties': False}
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 where-to-buy links.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 10, max 10)'}, 'query': {'type': 'string', 'maxLength': 120, 'description': 'Free-text search: coffee or roaster name'}, 'category': {'enum': ['espresso', 'single_origin', 'blend', 'decaf', 'dark'], 'type': 'string', 'description': 'Coffee category to filter by; omit to search all'}, 'price_max': {'type': 'number', 'minimum': 0, 'description': 'Maximum price in USD'}, 'price_min': {'type': 'number', 'minimum': 0, 'description': 'Minimum price in USD'}, 'brew_method': {'type': 'string', 'maxLength': 120, 'description': "e.g. 'espresso', 'pourover', 'french press', 'drip'"}, 'roast_level': {'enum': ['light', 'medium-light', 'medium', 'medium-dark', 'dark'], 'type': 'string', 'description': 'Roast level to filter by; omit to include all roasts'}}, 'additionalProperties': False}
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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 10, max 10)'}}, 'additionalProperties': False}
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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'mood': {'type': 'string', 'maxLength': 120, 'description': "e.g. 'need focus', 'lazy weekend', 'something comforting', 'adventurous'"}, 'brew_method': {'type': 'string', 'maxLength': 120, 'description': "What you're brewing with"}, 'time_of_day': {'enum': ['morning', 'afternoon', 'evening'], 'type': 'string', 'description': 'When the coffee will be drunk â\x80\x94 shifts the pick toward lighter or lower-caffeine options later in the day'}}, 'additionalProperties': False}
Hinzugefügt
what_to_brew
17. September 2026 12:40
Hinzugefügt
dial_in_suggestion
17. September 2026 12:40
Hinzugefügt
trending_coffees
17. September 2026 12:40
Hinzugefügt
compare_coffees
17. September 2026 12:40
Hinzugefügt
get_recommendations
17. September 2026 12:40
Hinzugefügt
find_similar
17. September 2026 12:40
Hinzugefügt
get_coffee
17. September 2026 12:40
Hinzugefügt
search_coffees
17. September 2026 12:40