# MCP Tools Reference — BrewLogica

Last Updated: March 2026

Complete reference for all 19 BrewLogica MCP tools. Use these to interact with your coffee data through AI assistants.

MCP Endpoint: `https://api.brewlogica.app/mcp`
Authentication: Bearer token (generate at [https://brewlogica.app/tokens](https://brewlogica.app/tokens))

***

## Beans

### list_beans

List all beans in your collection.

Parameters:

* `limit` (number, optional) — Maximum number of beans to return. Default: 50

* `offset` (number, optional) — Number of beans to skip for pagination

### get_bean

Get details of a specific bean by ID.

Parameters:

* `bean_id` (string, required) — The UUID of the bean

### create_bean

Add a new bean to your collection.

Parameters:

* `name` (string, required) — Name of the coffee

* `roaster` (string, optional) — Roaster name

* `origin` (string, optional) — Country or region of origin

* `process` (string, optional) — Processing method (washed, natural, honey, etc.)

* `variety` (string, optional) — Coffee variety (bourbon, typica, etc.)

* `tasting_notes` (string, optional) — Flavor notes

### update_bean

Update an existing bean.

Parameters:

* `bean_id` (string, required) — The UUID of the bean to update

* `name` (string, optional) — New name

* `roaster` (string, optional) — New roaster

### delete_bean

Delete a bean from your collection.

Parameters:

* `bean_id` (string, required) — The UUID of the bean to delete

***

## Bags

### list_bags

List all bags (purchases) for a bean.

Parameters:

* `bean_id` (string, optional) — Filter by bean ID

### get_active_bag

Get the currently active bag for a bean.

Parameters:

* `bean_id` (string, required) — The bean ID

### create_bag

Record a new bag purchase.

Parameters:

* `bean_id` (string, required) — The bean this bag belongs to

* `roast_date` (string, optional) — ISO date when roasted (e.g., "2026-02-01")

* `bag_weight_grams` (number, optional) — Weight in grams

* `price_paid` (number, optional) — Purchase price

* `currency` (string, optional) — Currency code (USD, EUR, etc.)

### set_active_bag

Set a bag as the active one for its bean.

Parameters:

* `bag_id` (string, required) — The bag ID to activate

***

## Brews

### list_brews

List your brew history.

Parameters:

* `limit` (number, optional) — Maximum number of brews. Default: 50

* `bean_id` (string, optional) — Filter by bean

* `method` (string, optional) — Filter by brew method

### get_brew

Get details of a specific brew.

Parameters:

* `brew_id` (string, required) — The brew ID

### create_brew

Log a new brew.

Parameters:

* `bean_id` (string, optional) — The bean used

* `method` (string, required) — Brew method: espresso, v60, aeropress, french_press, chemex, kalita_wave, cold_brew, moka_pot, siphon, clever_dripper

* `dose_grams` (number, optional) — Coffee dose in grams

* `yield_grams` (number, optional) — Output yield in grams

* `time_seconds` (number, optional) — Extraction time in seconds

* `rating` (number, optional) — Rating 1–5

* `notes` (string, optional) — Tasting notes

### update_brew

Update an existing brew.

Parameters:

* `brew_id` (string, required) — The brew ID

* `rating` (number, optional) — New rating

* `notes` (string, optional) — Updated notes

### delete_brew

Delete a brew from history.

Parameters:

* `brew_id` (string, required) — The brew ID to delete

***

## AI Features

AI feature tools require a Pro subscription and count against monthly quotas.

### parse_brew_text

Parse natural language into structured brew data using AI.

Parameters:

* `text` (string, required) — Natural language brew description

Quota: 200 calls/month

### get_suggestions

Get AI-powered brewing suggestions based on your history.

Parameters:

* `bean_id` (string, optional) — Get suggestions for a specific bean

* `method` (string, optional) — Filter by brew method

Quota: 100 calls/month

### get_limits

Check your AI feature usage limits and remaining quota.

Parameters: None

***

## Utilities

### get_stats

Get brewing statistics and analytics.

Parameters:

* `period` (string, optional) — Time period: week, month, or year

### search

Search across beans and brews.

Parameters:

* `query` (string, required) — Search query

***

## Supported Brew Method Values

Use these exact strings for the `method` parameter in `create_brew` and `list_brews`:

| Method         | Value            |
| --------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| Espresso       | `espresso`       |
| V60            | `v60`            |
| Chemex         | `chemex`         |
| AeroPress      | `aeropress`      |
| French Press   | `french_press`   |
| Kalita Wave    | `kalita_wave`    |
| Cold Brew      | `cold_brew`      |
| Moka Pot       | `moka_pot`       |
| Siphon         | `siphon`         |
| Clever Dripper | `clever_dripper` |

***

## Rate Limits (Pro Plan)

* 60 requests per minute

* 5,000 requests per day

* 200 AI parse calls per month

* 100 AI suggestion calls per month

Full rate limit documentation: [https://brewlogica.app/docs/rate-limits](https://brewlogica.app/docs/rate-limits)