Grind settings for 200+ home coffee grinders, conversion between them, and help choosing one.
Scored across 6 tools
The six tools target mostly distinct actions: buying advice (find_grinder), chart lookup (get_grinder_chart), taste-driven adjustment (dial_in), cross-grinder conversion (convert_grind_setting), BrewMark code decoding (translate_recipe), and catalog listing (list_grinders). Two boundaries are soft: get_grinder_chart advertises 'how do I dial in my <grinder>' which overlaps with dial_in, and convert_grind_setting vs translate_recipe differ only in input format (another grinder's setting vs a BrewMark code/BGI/OBP), though the descriptions explicitly cross-reference each other to resolve this.
All names are snake_case and verb-first (convert_, find_, get_, list_, translate_), which is predictable. The only deviation is dial_in, a phrasal verb with no object noun, making it the odd one out in an otherwise verb_noun pattern.
Six tools is well-scoped for a grinder advisory service, and each one covers a genuinely different user question rather than restating another. No filler or redundant tools are present.
The surface covers the core lifecycle: discover a grinder (find_grinder/list_grinders), get its settings (get_grinder_chart), adjust from taste (dial_in), and consume external recipes (convert_grind_setting/translate_recipe), with dial_in doubling as the write path for anonymous reports. Minor gap: there is no tool to fetch detailed specs or buying-guide content for a specific grinder outside the finder ranking, so follow-up questions like 'tell me more about the Encore' have no direct route.
Translate a grind setting from one coffee grinder to another. Use whenever a recipe quotes a setting for a grinder the user does not own — "the recipe says 18 clicks on a Comandante, what is that on my Encore?". Grinder names can be written however the user said them ("Fellow Ode", "1Zpresso J-Max"); exact slugs are not required.
Inputs: to (required), from (required), setting (required).
The next grind setting to try after the user brewed and tasted: "I used 18 on my Encore and it was sour", "my espresso is bitter at 4.5 on the Ode". Sour, weak or fast means grind finer; bitter, harsh or slow means coarser. Returns one move on that grinder's own dial. Call again after each cup, and with result "good" once it tastes right, which also adds an anonymous report (grinder, method, setting, taste, coffee) to BrewMark's per-coffee data.
Inputs: result (required), grinder (required), setting (required), roast, +2 more.
Shortlist coffee grinders for someone deciding which one to buy: "which grinder should I get for pour over under $200?", "a quiet grinder for espresso", "best hand grinder for travel". Ranks BrewMark's grinder finder by how they brew, budget, hand or electric, and must-haves, and returns each pick with an approximate US price, why it fits, and a link to its BrewMark buying guide. BrewMark does not sell grinders: do not use this to place an order, and for a grinder the user already owns use get_grinder_chart instead.
Inputs: power, budget, methods, must_have.
Grind settings for one grinder across every brew method. Use this for any question of the form "what grind should I use for my ", "what setting for French press on a ", or "how do I dial in my ". Returns the recommended setting and usable range for espresso, moka pot, AeroPress, pour over, siphon, steep-and-release (Clever Dripper, Hario Switch), drip, cupping, Chemex, French press and cold brew. When the user names a brew method, pass it as method: the answer then leads with that method, plus a starting recipe (ratio, dose, water temperature, time). The grinder can be named however the user said it.
Inputs: grinder (required), roast, method.
Every grinder BrewMark supports. Use this to check whether a grinder is covered, or to disambiguate when another tool reports more than one match. Not needed just to look up a name — the other tools accept ordinary names directly.
Inputs: search.
Turn a recipe written in the open BrewMark Protocol into a setting on the user's own grinder. Use when a coffee bag or roaster gives a BrewMark code or link ("7H2KQ9", "brewmark.io/p/7H2KQ9"), or a recipe gives its grind as a BrewMark Grind Index ("BGI 38") or as an Open Brew Profile (JSON with "spec": "brewmark.obp/0.1"). Pass one of code, bgi or profile. Spec: https://github.com/jeffreygluck/brewmark-protocol. For a recipe that quotes a setting on another grinder, use convert_grind_setting instead.
Inputs: grinder (required), bgi, code, profile.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Espresso dialing: log a shot, say how it tasted, get one change in your grinder's own clicks.
Espresso gear price history: live Amazon prices, 2+ years of daily data, BUY calls at verified lows.
What fits, with live prices: specs, fit verdicts with rule ids and stock for home espresso.
Specialty coffee roaster prices, stock, price/100g, change events and store profiles (30 roasters).
Add one secure layer between your agents and this server.