MCP Tools Reference
Complete reference for all BrewLogica MCP tools. Use these to interact with your coffee data through AI assistants.
Beans
list_beans
List all beans in your collection
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| 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
| Name | Type | Required | Description |
|---|---|---|---|
| bean_id | string | Required | The UUID of the bean |
create_bean
Add a new bean to your collection
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| 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, etc.) |
| variety | string | Optional | Coffee variety (bourbon, typica, etc.) |
| tasting_notes | string | Optional | Flavor notes |
update_bean
Update an existing bean
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| 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
| Name | Type | Required | Description |
|---|---|---|---|
| bean_id | string | Required | The UUID of the bean to delete |
Bags
list_bags
List all bags (purchases) for a bean
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| bean_id | string | Optional | Filter by bean ID |
get_active_bag
Get the currently active bag for a bean
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| bean_id | string | Required | The bean ID |
create_bag
Record a new bag purchase
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| bean_id | string | Required | The bean this bag belongs to |
| roast_date | string | Optional | ISO date when roasted |
| 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
| Name | Type | Required | Description |
|---|---|---|---|
| bag_id | string | Required | The bag ID to activate |
Brews
list_brews
List your brew history
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| 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
| Name | Type | Required | Description |
|---|---|---|---|
| brew_id | string | Required | The brew ID |
create_brew
Log a new brew
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| bean_id | string | Optional | The bean used |
| method | string | Required | Brew method (espresso, v60, aeropress) |
| dose_grams | number | Optional | Coffee dose in grams |
| yield_grams | number | Optional | Output yield in grams |
| time_seconds | number | Optional | Extraction time |
| rating | number | Optional | Rating 1-5 |
| notes | string | Optional | Tasting notes |
update_brew
Update an existing brew
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| 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
| Name | Type | Required | Description |
|---|---|---|---|
| brew_id | string | Required | The brew ID to delete |
AI Features
parse_brew_text
Parse natural language into structured brew data using AI
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| text | string | Required | Natural language brew description |
get_suggestions
Get AI-powered brewing suggestions
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| bean_id | string | Optional | Get suggestions for a specific bean |
| method | string | Optional | Filter by brew method |
get_limits
Check your AI feature usage limits
No parameters required
Utilities
get_stats
Get brewing statistics and analytics
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| period | string | Optional | Time period (week, month, year) |
search
Search across beans and brews
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| query | string | Required | Search query |