# Examples — BrewLogica MCP

Last Updated: March 2026

Real-world examples of how to interact with BrewLogica through your AI assistant. These demonstrate the natural language prompts you can use and the tool calls they trigger.

***

## Log a Quick Espresso

**You:** Log an espresso: 18g in, 36g out, 28 seconds, tasted a bit sour

**BrewLogica:** Created brew:

* Method: Espresso

* Dose: 18g

* Yield: 36g

* Time: 28 seconds

* Notes: "Tasted a bit sour - might try grinding finer next time"

Tool called: `create_brew(method: "espresso", dose_grams: 18, yield_grams: 36, time_seconds: 28, notes: "tasted a bit sour")`

***

## Add a New Coffee

**You:** Add a new coffee: Onyx Coffee Lab, Tropical Weather blend, natural process, notes of blueberry and chocolate

**BrewLogica:** Added to your collection:

* Name: Tropical Weather

* Roaster: Onyx Coffee Lab

* Process: Natural

* Tasting notes: Blueberry, chocolate

Tool called: `create_bean(name: "Tropical Weather", roaster: "Onyx Coffee Lab", process: "natural", tasting_notes: "blueberry, chocolate")`

***

## Get Brewing Suggestions

**You:** I just opened a new bag of Ethiopian natural. What brew parameters should I try for V60?

**BrewLogica:** For Ethiopian naturals on V60, based on your history:

Suggested starting point:

* Dose: 15g

* Water: 250g (1:16.7 ratio)

* Grind: Medium-fine

* Technique: Single pour after bloom

Your past brews with similar beans averaged 1:16 ratio with 3:30 brew time.

Tool called: `get_suggestions(method: "v60", bean_id: "...")`

***

## Review Your Week

**You:** What coffees did I drink this week? How many espressos?

**BrewLogica:** This week (Jan 6-12):

* Total brews: 14

* Espressos: 9

* V60: 5

Beans used:

1. Onyx Tropical Weather (8 brews)
2. Sey Coffee Worka (6 brews)

Average espresso ratio: 1:2.1
Average rating: 4.2/5

Tool called: `get_stats(period: "week")` + `list_brews(limit: 50)`

***

## Track a Bag Purchase

**You:** I just bought another bag of the Worka from Sey, roasted January 5th, 250g for $22

**BrewLogica:** Added new bag to Sey Coffee - Worka:

* Roast date: January 5, 2026

* Weight: 250g

* Price: $22 USD

* Days post-roast: 8

Set as active bag for this coffee.

Tool calls: `search(query: "Sey Worka")` then `create_bag(bean_id: "...", roast_date: "2026-01-05", bag_weight_grams: 250, price_paid: 22, currency: "USD")`

***

## Dial In Assistance

**You:** My last 3 espressos have been sour. I'm at 18g dose, 36g yield in 25 seconds. Help me dial in.

**BrewLogica:** Analyzing your last 3 espressos...

All showing under-extraction (25-26 sec, 1:2 ratio).

Suggestions:

1. **Grind finer** - Aim for 28-32 seconds
2. Try 18g → 38g (1:2.1) for more sweetness
3. Current bean is 12 days post-roast, still good

Start with grinding 2 notches finer and target 30 seconds.

Tool calls: `list_brews(method: "espresso", limit: 3)` then `get_suggestions(method: "espresso")`

***

## Check Remaining AI Quota

**You:** How many AI requests do I have left this month?

**BrewLogica:**

* AI parse calls: 147 / 200 used this month (53 remaining)

* AI suggestions: 61 / 100 used this month (39 remaining)

* API requests today: 234 / 5,000 used

Tool called: `get_limits()`

***

## Tips for Best Results

* **Be specific with numbers.** "18g espresso" works better than "made coffee."

* **Natural language works.** Write like you're texting a friend. The AI understands context.

* **Ask follow-ups.** "What about my average ratio?" after reviewing brews. Context is maintained.

* **Bulk log.** "Log these 3 brews: [details]" works in one request.

***

## Related Documentation

* Getting Started: [https://brewlogica.app/docs/getting-started](https://brewlogica.app/docs/getting-started)

* MCP Tools Reference: [https://brewlogica.app/docs/tools](https://brewlogica.app/docs/tools)

* MCP Quickstart: [https://brewlogica.app/docs/mcp-quickstart](https://brewlogica.app/docs/mcp-quickstart)