Beer Tracking tools
Every tool in this module, with its full description, parameters, and return value. All of them require the module to be active first. See the Beer Tracking overview for how to turn it on.
Core tools
Create, read, update, and delete entries. Every module has exactly these four.
beer_tracking_add_entryAdd a beer to the user's Beer Tracking module. Requires the module to be active — see create_database. Resolves the style against the style catalog automatically when the text is a confident match.
Parameters
| Name | Type | Required | Notes |
|---|---|---|---|
| beer | string | Yes | Name of the beer. |
| brewery | string | No | Brewery or maker of the beer. |
| style | string | No | Beer style, e.g. IPA, stout, lager. |
| style_id | string | No | Exact beerStyles.id from beer_tracking_search_styles, if already known. Skips automatic matching. |
| abv_pct | number | No | Alcohol by volume, as a percentage, e.g. 5.5 for 5.5%. |
| rating | number | No | Your rating for this beer, 1-5 scale. |
| notes | string | No | Free-form tasting notes or comments. |
Returns
The created entry as JSON, including its id.
beer_tracking_list_entriesList entries in the user's active Beer Tracking module.
Parameters
| Name | Type | Required | Notes |
|---|---|---|---|
| limit | number | No | Max entries to return (default 100, max 500). |
Returns
Every entry in the active database, as a JSON array.
beer_tracking_update_entryUpdate fields on an existing Beer Tracking entry.
Parameters
| Name | Type | Required | Notes |
|---|---|---|---|
| entryId | string | Yes | ID of the Beer Tracking entry to update. |
| beer | string | No | Name of the beer. |
| brewery | string | No | Brewery or maker of the beer. |
| style | string | No | Beer style, e.g. IPA, stout, lager. |
| style_id | string | No | Exact beerStyles.id from beer_tracking_search_styles. Skips automatic matching. |
| abv_pct | number | No | Alcohol by volume, as a percentage, e.g. 5.5 for 5.5%. |
| rating | number | No | Your rating for this beer, 1-5 scale. |
| notes | string | No | Free-form tasting notes or comments. |
Returns
The updated or deleted entry as JSON. Returns an error if entryId does not belong to an entry in the active database.
beer_tracking_delete_entryDelete an entry from the user's active Beer Tracking module.
Parameters
| Name | Type | Required | Notes |
|---|---|---|---|
| entryId | string | Yes | ID of the Beer Tracking entry to delete. |
Returns
The updated or deleted entry as JSON. Returns an error if entryId does not belong to an entry in the active database.
Purpose-built tools
Shortcuts and queries shaped around how Beer Tracking is actually used, so your agent doesn't have to fetch every entry and filter them itself.
beer_tracking_attach_photoAttach a photo to an existing Beer Tracking entry (replacing any photo already on it). If you have the image's raw bytes, pass photo_base64. If the user attached the image in a chat client (e.g. claude.ai), you cannot read its bytes: call this WITHOUT photo_base64 to get a one-time upload link, and give that link to the user so they can upload the photo themselves. The link expires in 30 minutes. Photos are stored privately; the returned viewPath is only viewable signed into the connacto web app as this user.
Parameters
| Name | Type | Required | Notes |
|---|---|---|---|
| entryId | string | Yes | ID of the Beer Tracking entry to attach the photo to. |
| photo_base64 | string | No | The photo, base64-encoded (no data: URI prefix). Omit when you cannot read the image bytes — the tool then returns an upload link for the user instead. |
| photo_content_type | image/jpeg | image/png | image/webp | image/heic | No | MIME type of the photo, if photo_base64 is set. Defaults to image/jpeg. |
Returns
JSON with a private viewPath when photo_base64 was given, or an uploadUrl to hand the user when it was not.
beer_tracking_top_ratedList the highest-rated entries (default 10) from the active Beer Tracking module, ordered by rating descending.
Parameters
| Name | Type | Required | Notes |
|---|---|---|---|
| limit | number | No | Max number of entries to return. Defaults to 10. |
Returns
The top-rated beers as a JSON array.
beer_tracking_statsReturn the total entry count, average rating, average ABV, and counts by style, for the user's active Beer Tracking module.
Parameters
None. Call it with an empty object.
Returns
Total entries, average rating, average ABV, and a count per style, as JSON.
beer_tracking_search_stylesLook up candidate beer styles by name or alias when the exact match for an entry is unclear. Use the returned id as style_id in beer_tracking_add_entry or beer_tracking_update_entry.
Parameters
| Name | Type | Required | Notes |
|---|---|---|---|
| query | string | Yes | Free-text style name to search for, e.g. 'ipa' or 'dry stout'. |
| limit | number | No | Max candidates to return (default 5, max 20). |
Returns
Candidate beer styles with their category, ABV, IBU, and SRM ranges, and match score, as a JSON array.
beer_tracking_styles_exploredCount the distinct beer styles resolved against the catalog in the active Beer Tracking module, against the total catalog size, plus an honest count of entries whose style never resolved to the catalog.
Parameters
None. Call it with an empty object.
Returns
Distinct styles explored, catalog size, and the count of entries with no resolved style, as JSON.