Endpoints: 28,729MCP servers: 18,413Payout addresses: 2,071Paid calls: 1,544Letters: 14Defects: 1,324counted just now
teppi

Server definition

Hash
sha256:100d93165ba2c6c166645b1858907406b8548f88376c9481dc50377f97c46cf1
What it is
What a remote MCP server returned when asked what it offers: 44 tools

The blob, as servednamed by its sha256

{ "instructions": null, "tools": [ { "description": "Compute a bag's age in days off roast and its resting/staling verdict — the coffee's current bag by default, or the bag named.", "inputSchema": { "properties": { "bag_id": { "description": "A bag of that coffee (from list_beans' bags[]); null = its current bag", "type": [ "integer", "null" ] }, "bean_id": { "type": "integer" } }, "required": [ "bean_id" ], "type": "object" }, "name": "compute_age", "outputSchema": { "additionalProperties": true, "properties": { "age_days": { "type": "integer" }, "bag_id": { "type": "integer" }, "bean_id": { "type": "integer" }, "days_off_roast": { "type": "integer" }, "days_since_opened": {}, "effective_age_days": { "type": "integer" }, "frozen_days_excluded": { "type": "integer" }, "grams_remaining": {}, "rest_window": { "type": "string" }, "roast_date": { "type": "string" }, "verdict": { "type": "string" }, "warnings": { "type": "array" } }, "required": [ "bean_id", "bag_id", "roast_date", "age_days", "days_off_roast", "days_since_opened", "frozen_days_excluded", "effective_age_days", "rest_window", "verdict", "grams_remaining", "warnings" ], "type": "object" } }, { "description": "Delete a logged shot from history. Restores the bean's remaining weight (which is derived from logged doses). Hard delete — there is no undo. To fix a mistake on an otherwise-valid shot, prefer update_shot over delete-and-relog.", "inputSchema": { "properties": { "shot_id": { "description": "ID of the shot to delete", "type": "integer" } }, "required": [ "shot_id" ], "type": "object" }, "name": "delete_shot", "outputSchema": { "additionalProperties": true, "properties": { "deleted_shot_id": { "type": "integer" }, "message": { "type": "string" }, "status": { "type": "string" } }, "required": [ "status", "deleted_shot_id", "message" ], "type": "object" } }, { "description": "Sandbox-only diagnosis, writes nothing (no verdict, no recommendation-trail entry). Two modes: pass shot_id to dry-run a LOGGED shot (optionally overriding its sensory_tags — the \"what would this read as?\" preview; the shot's own bean and its age at pulled_at are used), or pass the full metric set (bean_id, grinder_id, machine_id, grind_label, dose_g, yield_g, time_s, source) for a hypothetical shot. Identical output shape to diagnose_shot, including bean_context.", "inputSchema": { "properties": { "bean_id": { "description": "Coffee bean ID (must belong to this account)", "type": "integer" }, "dose_g": { "description": "Dose in grams", "type": "number" }, "grind_label": { "description": "Grinder setting label, e.g. \"1.1.3\"", "type": "string" }, "grinder_id": { "description": "Grinder ID (must belong to this account)", "type": "integer" }, "machine_id": { "description": "Machine ID (must belong to this account)", "type": "integer" }, "sensory_tags": { "description": "Sensory observations, e.g. [\"sour\",\"bitter\"]. With shot_id: replaces the stored tags for this preview (omit to use stored; [] = none).", "items": { "type": "string" }, "type": "array" }, "shot_id": { "description": "Preview a logged shot by ID (dry-run; ignores the metric params below)", "type": "integer" }, "source": { "description": "Grinder position source — affects G1 warning (raw mode only)", "enum": [ "measured", "recalled", "assumed" ], "type": "string" }, "time_s": { "description": "Extraction time in seconds", "type": "number" }, "yield_g": { "description": "Yield in grams", "type": "number" } }, "type": "object" }, "name": "diagnose_preview", "outputSchema": { "additionalProperties": true, "properties": { "bean_context": { "additionalProperties": true, "properties": { "bag_id": { "type": "integer" }, "bean_id": { "type": "integer" }, "bean_name": { "type": "string" }, "dial_category": { "type": "string" }, "effective_age_days": { "type": "integer" }, "roast_level": { "type": "string" } }, "required": [ "bean_id", "bag_id", "bean_name", "roast_level", "effective_age_days", "dial_category" ], "type": "object" }, "category": { "type": "string" }, "facts": { "items": { "additionalProperties": true, "properties": { "source": { "type": "string" }, "text": { "type": "string" } }, "required": [ "text", "source" ], "type": "object" }, "type": "array" }, "hypotheses": { "items": { "additionalProperties": true, "properties": { "cause": { "type": "string" }, "cited_rules": { "items": { "type": "string" }, "type": "array" }, "confidence": { "type": "string" }, "direction": { "type": "string" }, "experiment": { "type": "string" }, "lever": { "type": "string" }, "target_label": { "type": "string" } }, "required": [ "cause", "lever", "direction", "confidence", "experiment", "cited_rules" ], "type": "object" }, "type": "array" }, "kb_version": { "type": "string" }, "one_variable_only": { "type": "boolean" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "category", "facts", "hypotheses", "warnings", "one_variable_only", "kb_version", "bean_context" ], "type": "object" } }, { "description": "Evaluate shot metrics to provide ranked hypotheses (C6) and warn on flip-flops (G2) or fatigue (G6). Resolves the SHOT's own bean — age computed at the shot's pulled_at — never the active profile, and echoes it as bean_context, so diagnosing an older or differently-filed shot is always safe. The engine reads metrics and sensory tags — NOT free-text notes — so make sure taste feedback is recorded as sensory_tags on the shot (via log_shot or update_shot) before diagnosing; otherwise an in-range shot that tastes bad will come back \"balanced\".", "inputSchema": { "properties": { "shot_id": { "description": "Optional shot ID; defaults to last pulled shot.", "type": "integer" } }, "type": "object" }, "name": "diagnose_shot", "outputSchema": { "additionalProperties": true, "properties": { "bean_context": { "additionalProperties": true, "properties": { "bag_id": { "type": "integer" }, "bean_id": { "type": "integer" }, "bean_name": { "type": "string" }, "dial_category": { "type": "string" }, "effective_age_days": { "type": "integer" }, "roast_level": { "type": "string" } }, "required": [ "bean_id", "bag_id", "bean_name", "roast_level", "effective_age_days", "dial_category" ], "type": "object" }, "category": { "type": "string" }, "facts": { "items": { "additionalProperties": true, "properties": { "source": { "type": "string" }, "text": { "type": "string" } }, "required": [ "text", "source" ], "type": "object" }, "type": "array" }, "hypotheses": { "items": { "additionalProperties": true, "properties": { "cause": { "type": "string" }, "cited_rules": { "items": { "type": "string" }, "type": "array" }, "confidence": { "type": "string" }, "direction": { "type": "string" }, "experiment": { "type": "string" }, "lever": { "type": "string" }, "target_label": { "type": "string" } }, "required": [ "cause", "lever", "direction", "confidence", "experiment", "cited_rules" ], "type": "object" }, "type": "array" }, "kb_version": { "type": "string" }, "one_variable_only": { "type": "boolean" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "category", "facts", "hypotheses", "warnings", "one_variable_only", "kb_version", "bean_context" ], "type": "object" } }, { "description": "Retrieve current dialing state, active context, recent shots, recommendations, and locked recipes.", "inputSchema": { "properties": {}, "type": "object" }, "name": "get_dial_state", "outputSchema": { "additionalProperties": true, "properties": { "active_coffee": { "additionalProperties": true, "properties": { "acidity": {}, "age_days": { "type": "integer" }, "age_verdict": { "type": "string" }, "arabica_pct": {}, "archived": { "type": "integer" }, "aromatics": {}, "attachments": {}, "bag": { "additionalProperties": true, "properties": { "age_verdict": { "type": "string" }, "archived": { "type": "integer" }, "bag_notes": { "type": "string" }, "bag_weight_g": {}, "bean_id": { "type": "integer" }, "best_by_date": {}, "buy_date": {}, "cost": {}, "currency": {}, "days_off_roast": { "type": "integer" }, "days_since_opened": {}, "ean": {}, "effective_age_days": { "type": "integer" }, "finished": { "type": "integer" }, "frozen_at": {}, "frozen_days_excluded": { "type": "integer" }, "frozen_note": {}, "frozen_storage": {}, "grams_remaining": {}, "id": { "type": "integer" }, "opened_date": {}, "qr_code": {}, "roast_date": { "type": "string" }, "state": { "type": "string" }, "storage": {}, "unfrozen_at": {}, "weight_adjustment_g": { "type": "integer" } }, "required": [ "id", "bean_id", "roast_date", "buy_date", "opened_date", "best_by_date", "bag_weight_g", "weight_adjustment_g", "cost", "currency", "state", "finished", "frozen_at", "unfrozen_at", "frozen_storage", "frozen_note", "storage", "ean", "qr_code", "bag_notes", "archived", "days_off_roast", "days_since_opened", "frozen_days_excluded", "effective_age_days", "age_verdict", "grams_remaining" ], "type": "object" }, "bag_notes": { "type": "string" }, "bag_weight_g": {}, "bean_mix": {}, "best_by_date": {}, "body": {}, "buy_date": {}, "co2e_kg": {}, "cost": {}, "cupping_points": {}, "currency": {}, "current_bag_id": { "type": "integer" }, "days_off_roast": { "type": "integer" }, "days_since_opened": {}, "decaffeinated": {}, "dial_category": { "type": "string" }, "ean": {}, "effective_age_days": { "type": "integer" }, "favourite": {}, "finished": { "type": "integer" }, "frozen_at": {}, "frozen_days_excluded": { "type": "integer" }, "frozen_note": {}, "frozen_storage": {}, "grams_remaining": {}, "id": { "type": "integer" }, "is_active": { "type": "integer" }, "name": { "type": "string" }, "notes": {}, "opened_date": {}, "origin": {}, "process_type": { "type": "string" }, "qr_code": {}, "rating": {}, "rest_window_days_max": {}, "rest_window_days_min": {}, "roast_custom": {}, "roast_date": { "type": "string" }, "roast_level": { "type": "string" }, "roast_range": {}, "roaster": { "type": "string" }, "roasting_type": {}, "state": { "type": "string" }, "storage": {}, "sweetness": {}, "unfrozen_at": {}, "url": {}, "variety": {}, "weight_adjustment_g": { "type": "integer" } }, "required": [ "id", "name", "roaster", "origin", "variety", "roast_date", "roast_level", "process_type", "dial_category", "bag_notes", "rest_window_days_min", "rest_window_days_max", "state", "opened_date", "storage", "is_active", "weight_adjustment_g", "buy_date", "bag_weight_g", "cost", "currency", "decaffeinated", "bean_mix", "roast_range", "roast_custom", "roasting_type", "aromatics", "cupping_points", "rating", "favourite", "url", "ean", "qr_code", "co2e_kg", "attachments", "archived", "frozen_at", "unfrozen_at", "frozen_storage", "frozen_note", "best_by_date", "finished", "notes", "arabica_pct", "body", "acidity", "sweetness", "age_days", "days_off_roast", "days_since_opened", "frozen_days_excluded", "effective_age_days", "age_verdict", "grams_remaining", "current_bag_id", "bag" ], "type": "object" }, "active_grinder": { "additionalProperties": true, "properties": { "archived": { "type": "integer" }, "built_in_machine_id": {}, "burr_type": { "type": "string" }, "catalog_id": {}, "components_spec": { "type": "string" }, "direction_convention": { "type": "string" }, "id": { "type": "integer" }, "is_active": { "type": "integer" }, "max_value": {}, "microns_per_step": { "type": "integer" }, "min_value": {}, "motor_type": { "type": "string" }, "name": { "type": "string" }, "nominal_step": { "type": "integer" }, "notes": {}, "photo": {}, "position_value": { "type": "integer" }, "setting_components": { "type": "string" }, "setting_label": { "type": "string" }, "setting_scheme": { "type": "string" }, "source": { "type": "string" }, "verified_at": { "type": "string" } }, "required": [ "id", "name", "motor_type", "burr_type", "setting_scheme", "direction_convention", "nominal_step", "components_spec", "min_value", "max_value", "microns_per_step", "notes", "is_active", "archived", "photo", "catalog_id", "setting_label", "setting_components", "position_value", "source", "verified_at", "built_in_machine_id" ], "type": "object" }, "active_machine": { "additionalProperties": true, "properties": { "archived": { "type": "integer" }, "basket_size_grams": { "type": "integer" }, "boiler_type": { "type": "string" }, "built_in_grinder_id": {}, "catalog_id": { "type": "string" }, "connected_device": {}, "control_type": { "type": "string" }, "hardness_dh": {}, "id": { "type": "integer" }, "is_active": { "type": "integer" }, "name": { "type": "string" }, "notes": {}, "photo": {}, "prep_style": {}, "prep_type": {}, "settings": { "items": { "additionalProperties": true, "properties": { "default": { "type": [ "number", "null", "string" ] }, "key": { "type": "string" }, "label": { "type": "string" }, "max": { "type": [ "number", "null" ] }, "min": { "type": [ "number", "null" ] }, "options": { "items": { "additionalProperties": true, "properties": { "label": { "type": "string" }, "meaning": { "type": [ "string", "null" ] }, "value": { "type": "string" } }, "required": [ "value", "label", "meaning" ], "type": "object" }, "type": [ "null", "array" ] }, "step": {}, "type": { "type": "string" }, "unit": { "type": [ "string", "null" ] }, "value": { "type": [ "number", "null", "string" ] } }, "required": [ "key", "label", "type", "options", "min", "max", "step", "unit", "default", "value" ], "type": "object" }, "type": [ "array", "null" ] }, "tools": {} }, "required": [ "id", "name", "control_type", "basket_size_grams", "boiler_type", "notes", "is_active", "prep_type", "prep_style", "archived", "photo", "tools", "connected_device", "built_in_grinder_id", "catalog_id", "hardness_dh", "settings" ], "type": "object" }, "active_program": {}, "locked_recipe": { "additionalProperties": true, "properties": { "bean_id": { "type": "integer" }, "dose_g": { "type": "integer" }, "drink_intent": { "type": "string" }, "finish_action": { "type": "string" }, "grind_label": { "type": "string" }, "grind_position_value": { "type": "integer" }, "grind_reading": {}, "grinder_id": { "type": "integer" }, "id": { "type": "integer" }, "kb_version": { "type": "string" }, "locked_at": { "type": "string" }, "machine_id": { "type": "integer" }, "profile": { "type": "string" }, "program_id": {}, "status": { "type": "string" }, "target_time_s": { "type": "integer" }, "target_yield_g": { "type": "integer" } }, "required": [ "id", "bean_id", "grinder_id", "machine_id", "program_id", "status", "grind_label", "grind_position_value", "dose_g", "target_yield_g", "target_time_s", "finish_action", "drink_intent", "profile", "kb_version", "locked_at", "grind_reading" ], "type": "object" }, "maintenance_summary": { "additionalProperties": true, "properties": { "calibration_state": { "type": "string" }, "catalog_version": { "type": "string" }, "computed_at": { "type": "string" }, "due_count": { "type": "integer" }, "most_urgent": { "additionalProperties": true, "properties": { "basis": { "type": "string" }, "class": { "type": "string" }, "done": { "type": "integer" }, "due_at": {}, "equipment_id": { "type": "integer" }, "equipment_kind": { "type": "string" }, "equipment_name": { "type": "string" }, "every": { "type": "integer" }, "every_source": { "type": "string" }, "label": { "type": "string" }, "last_at": {}, "lower_bound": { "type": "boolean" }, "muted": { "type": "boolean" }, "muted_until": {}, "overdue_at": {}, "ratio": { "type": "number" }, "remaining": { "type": "integer" }, "soon": { "type": "boolean" }, "soon_at": {}, "state": { "type": "string" }, "task": { "type": "string" } }, "required": [ "equipment_kind", "equipment_id", "equipment_name", "task", "label", "class", "state", "ratio", "basis", "every", "done", "remaining", "last_at", "every_source", "lower_bound", "soon", "soon_at", "due_at", "overdue_at", "muted", "muted_until" ], "type": "object" }, "overdue_count": { "type": "integer" }, "soon_count": { "type": "integer" } }, "required": [ "computed_at", "catalog_version", "most_urgent", "due_count", "overdue_count", "soon_count", "calibration_state" ], "type": "object" }, "recent_recommendations": { "items": { "additionalProperties": true, "properties": { "based_on_shot": {}, "bean_id": { "type": "integer" }, "cited_rules": { "type": "string" }, "confidence": { "type": "string" }, "created_at": { "type": "string" }, "direction": { "type": "string" }, "grinder_id": { "type": "integer" }, "kb_version": { "type": "string" }, "lever": { "type": "string" }, "machine_id": { "type": "integer" }, "rationale": { "type": "string" } }, "required": [ "created_at", "bean_id", "grinder_id", "machine_id", "based_on_shot", "lever", "direction", "rationale", "confidence", "cited_rules", "kb_version" ], "type": "object" }, "type": "array" }, "recent_shots": { "items": { "additionalProperties": true, "properties": { "bag_id": { "type": "integer" }, "bean_id": { "type": "integer" }, "best_brew": { "type": "integer" }, "beverage_g": {}, "bloom_time_s": {}, "data_confidence": { "type": "string" }, "dose_g": { "type": "integer" }, "drink_intent": { "type": "string" }, "ey_pct": {}, "favourite": { "type": "integer" }, "finish_action": { "type": "string" }, "first_drip_time_s": {}, "flavor_notes": { "type": "string" }, "flow_rate_gps": { "type": "number" }, "grind_components": { "type": "string" }, "grind_label": { "type": "string" }, "grind_position_value": { "type": "integer" }, "grinder_id": { "type": "integer" }, "id": { "type": "integer" }, "machine_id": { "type": "integer" }, "machine_settings": {}, "observations": { "type": "string" }, "program_id": {}, "pulled_at": { "type": "string" }, "rating": {}, "sensory_tags": { "type": "string" }, "taste_pending": { "type": "integer" }, "tasted": { "type": "integer" }, "tds": {}, "temp_taste": { "type": "string" }, "temperature_c": {}, "time_s": { "type": "integer" }, "verdict": {}, "vessel_name": {}, "vessel_weight_g": {}, "water_id": {}, "yield_g": { "type": "integer" } }, "required": [ "id", "pulled_at", "bean_id", "grinder_id", "machine_id", "program_id", "grind_label", "grind_components", "grind_position_value", "dose_g", "yield_g", "time_s", "flow_rate_gps", "finish_action", "drink_intent", "flavor_notes", "sensory_tags", "observations", "temp_taste", "rating", "verdict", "data_confidence", "temperature_c", "bloom_time_s", "first_drip_time_s", "beverage_g", "tds", "ey_pct", "water_id", "vessel_name", "vessel_weight_g", "favourite", "best_brew", "tasted", "bag_id", "machine_settings", "taste_pending" ], "type": "object" }, "type": "array" } }, "required": [ "active_coffee", "active_grinder", "active_machine", "active_program", "recent_shots", "recent_recommendations", "locked_recipe", "maintenance_summary" ], "type": "object" } }, { "description": "Retrieve the current version of the knowledge base.", "inputSchema": { "properties": {}, "type": "object" }, "name": "get_kb_version", "outputSchema": { "additionalProperties": true, "properties": { "kb_version": { "type": "string" } }, "required": [ "kb_version" ], "type": "object" } }, { "description": "Step-by-step maintenance guides — tools, supplies, steps and warnings, in our own words with the maker's documents as sources. With no arguments, every guide for the user's current grinders and machines (and the water filter fitted in each). With guide_ids, those guides; the ids come from maintenance.tasks[].guide.id in list_grinders and list_machines. Ids that match no guide are listed under missing.", "inputSchema": { "properties": { "guide_ids": { "description": "Optional — the guides to fetch. Omit for every guide the user's equipment can use", "items": { "type": "string" }, "maxItems": 50, "type": "array" } }, "type": "object" }, "name": "get_maintenance_guides", "outputSchema": { "additionalProperties": true, "properties": { "catalog_version": { "type": "string" }, "guides": { "items": { "additionalProperties": true, "properties": { "also_covers": { "items": { "type": "string" }, "type": "array" }, "applies_to": { "items": { "type": "string" }, "type": "array" }, "basis": { "type": "string" }, "brand": { "type": "string" }, "duration_minutes": { "type": [ "null", "integer" ] }, "gaps": { "items": { "type": "string" }, "type": "array" }, "id": { "type": "string" }, "kind": { "type": "string" }, "machine_alert": { "additionalProperties": true, "properties": { "can_disable": {}, "clears": { "type": [ "string", "null" ] }, "counts": { "type": "string" }, "depends_on_setting": {}, "indicator": { "type": "string" }, "shown_as": { "type": "string" }, "source": { "type": "string" }, "threshold": {} }, "required": [], "type": [ "null", "object" ] }, "preferred": { "type": "boolean" }, "researched_at": { "type": "string" }, "scope": { "type": "string" }, "sources": { "items": { "additionalProperties": true, "properties": { "ref": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" }, "url": { "type": "string" } }, "required": [ "ref", "url", "type", "title" ], "type": "object" }, "type": "array" }, "steps": { "items": { "additionalProperties": true, "properties": { "anchor": { "type": "string" }, "n": { "type": "integer" }, "optional": { "type": "boolean" }, "repeat": { "type": "integer" }, "source": { "type": "string" }, "text": { "type": "string" }, "when": { "type": "string" } }, "required": [ "n", "text", "source", "anchor" ], "type": "object" }, "type": "array" }, "supplies": { "items": { "additionalProperties": true, "properties": { "item": { "type": "string" }, "required": { "type": "boolean" }, "source": { "type": "string" }, "spec": { "type": "string" } }, "required": [ "item", "spec", "required" ], "type": "object" }, "type": "array" }, "task": { "type": "string" }, "title": { "type": "string" }, "tools": { "items": { "type": "string" }, "type": "array" }, "variant": { "type": "string" }, "warnings": { "items": { "additionalProperties": true, "properties": { "source": { "type": "string" }, "text": { "type": "string" } }, "required": [ "text", "source" ], "type": "object" }, "type": "array" } }, "required": [ "id", "task", "kind", "scope", "brand", "applies_to", "title", "basis", "researched_at", "sources", "machine_alert", "duration_minutes", "supplies", "tools", "steps", "warnings", "gaps" ], "type": "object" }, "type": "array" }, "missing": { "items": { "type": "string" }, "type": [ "null", "array" ] } }, "required": [ "catalog_version", "guides", "missing" ], "type": "object" } }, { "description": "Retrieve the detailed text of a specific rule from the knowledge base by its rule ID.", "inputSchema": { "properties": { "rule_id": { "description": "The ID of the rule to fetch, e.g. CAT.DARK", "type": "string" } }, "required": [ "rule_id" ], "type": "object" }, "name": "get_rule", "outputSchema": { "additionalProperties": true, "properties": { "rule_id": { "type": "string" }, "text": { "type": "string" } }, "required": [ "rule_id", "text" ], "type": "object" } }, { "description": "Get compact flat usage stats for a grinder, machine, or bean.", "inputSchema": { "properties": { "id": { "description": "The entity ID", "type": "integer" }, "scope": { "description": "The stats scope", "enum": [ "grinder", "machine", "bean" ], "type": "string" } }, "required": [ "scope", "id" ], "type": "object" }, "name": "get_stats", "outputSchema": { "additionalProperties": true, "properties": { "beans_consumed": { "type": "integer" }, "brews": { "type": "integer" }, "effective_age": { "type": "integer" }, "grams_consumed": { "type": "integer" }, "grams_ground": { "type": "integer" }, "grams_remaining": { "type": "integer" }, "last_bean": { "type": "string" }, "last_grind_setting": { "type": "string" }, "last_used": { "type": "string" } }, "required": [ "brews" ], "type": "object" } }, { "description": "Determine steps/clicks difference and directions between setting labels (C3).", "inputSchema": { "properties": { "from_label": { "type": "string" }, "grinder_id": { "type": "integer" }, "to_label": { "type": "string" } }, "required": [ "grinder_id", "from_label", "to_label" ], "type": "object" }, "name": "grinder_math", "outputSchema": { "additionalProperties": true, "properties": { "burr_gap_travel_microns": { "type": "integer" }, "direction": { "type": "string" }, "relative_coarseness_note": { "type": "string" }, "step_unit": { "type": "string" }, "steps": { "type": "integer" } }, "required": [ "direction", "steps", "step_unit", "burr_gap_travel_microns", "relative_coarseness_note" ], "type": "object" } }, { "description": "Retrieve the changelog showing updates and version differences for the knowledge base.", "inputSchema": { "properties": {}, "type": "object" }, "name": "kb_changelog", "outputSchema": { "additionalProperties": true, "properties": { "changelog": { "type": "string" } }, "required": [ "changelog" ], "type": "object" } }, { "description": "List the coffees registered for the account, with status filter. Each coffee carries its bags[] (every purchase, with its own freshness and grams left) and current_bag_id; the row's top-level roast_date, state, grams_remaining and age fields are the current bag's. The `id` on each row is the number this account knows that coffee by, counting from 1 — safe to show, and what other tools expect back; bag ids are a separate series.", "inputSchema": { "properties": { "status": { "description": "Filter by status: current, archived, or all. Defaults to current.", "enum": [ "current", "archived", "all" ], "type": "string" } }, "type": "object" }, "name": "list_beans", "outputSchema": { "additionalProperties": true, "properties": { "beans": { "items": { "additionalProperties": true, "properties": { "acidity": {}, "age_verdict": { "type": "string" }, "arabica_pct": {}, "archived": { "type": "integer" }, "aromatics": {}, "bag_notes": { "type": [ "null", "string" ] }, "bag_weight_g": { "type": [ "integer", "null" ] }, "bags": { "items": { "additionalProperties": true, "properties": { "age_verdict": { "type": "string" }, "archived": { "type": "integer" }, "bag_notes": { "type": [ "null", "string" ] }, "bag_weight_g": { "type": [ "integer", "null" ] }, "bean_id": { "type": "integer" }, "best_by_date": {}, "buy_date": {}, "cost": { "type": [ "null", "integer" ] }, "currency": { "type": [ "null", "string" ] }, "days_off_roast": { "type": "integer" }, "days_since_opened": {}, "ean": {}, "effective_age_days": { "type": "integer" }, "finished": { "type": "integer" }, "frozen_at": {}, "frozen_days_excluded": { "type": "integer" }, "frozen_note": {}, "frozen_storage": {}, "grams_remaining": { "type": [ "integer", "null" ] }, "id": { "type": "integer" }, "opened_date": {}, "qr_code": {}, "roast_date": { "type": "string" }, "shots_remaining": { "type": "integer" }, "shots_remaining_basis": { "type": "string" }, "shots_remaining_dose_g": { "type": [ "integer", "number" ] }, "shots_remaining_sample": { "type": [ "integer", "null" ] }, "state": { "type": "string" }, "storage": {}, "unfrozen_at": {}, "weight_adjustment_g": { "type": "integer" } }, "required": [ "id", "bean_id", "roast_date", "buy_date", "opened_date", "best_by_date", "bag_weight_g", "weight_adjustment_g", "cost", "currency", "state", "finished", "frozen_at", "unfrozen_at", "frozen_storage", "frozen_note", "storage", "ean", "qr_code", "bag_notes", "archived", "effective_age_days", "age_verdict", "grams_remaining", "days_since_opened", "days_off_roast", "frozen_days_excluded" ], "type": "object" }, "type": "array" }, "best_by_date": {}, "body": {}, "buy_date": {}, "cost": {}, "cupping_points": {}, "currency": {}, "current_bag_id": { "type": [ "integer", "null" ] }, "days_off_roast": { "type": "integer" }, "days_since_opened": {}, "decaffeinated": { "type": [ "integer", "null" ] }, "dial_category": { "type": "string" }, "ean": {}, "effective_age_days": { "type": "integer" }, "favourite": { "type": [ "integer", "null" ] }, "finished": { "type": "integer" }, "frozen_at": {}, "frozen_days_excluded": { "type": "integer" }, "frozen_note": {}, "frozen_storage": {}, "grams_remaining": { "type": [ "integer", "null" ] }, "id": { "type": "integer" }, "name": { "type": "string" }, "notes": { "type": [ "null", "string" ] }, "opened_date": {}, "origin": {}, "origins": { "items": { "additionalProperties": true, "properties": { "country": { "type": "string" }, "elevation_m": {}, "elevation_max_m": {}, "farm": {}, "farmer": {}, "harvest": {}, "percentage": { "type": "integer" }, "processing": {}, "region": { "type": "string" }, "variety": { "type": "string" } }, "required": [ "country", "region", "farm", "farmer", "variety", "processing", "elevation_m", "elevation_max_m", "harvest", "percentage" ], "type": "object" }, "type": "array" }, "process_type": { "type": "string" }, "qr_code": {}, "rating": {}, "rest_window_days_max": { "type": [ "integer", "null" ] }, "rest_window_days_min": { "type": [ "integer", "null" ] }, "roast_date": { "type": "string" }, "roast_level": { "type": "string" }, "roaster": { "type": "string" }, "roasting_type": {}, "shots_remaining": { "type": "integer" }, "shots_remaining_basis": { "type": "string" }, "shots_remaining_dose_g": { "type": [ "integer", "number" ] }, "shots_remaining_sample": { "type": [ "integer", "null" ] }, "state": { "type": "string" }, "storage": {}, "sweetness": {}, "unfrozen_at": {}, "url": {}, "variety": {}, "weight_adjustment_g": { "type": "integer" } }, "required": [ "id", "name", "roaster", "roast_level", "archived", "favourite", "decaffeinated", "process_type", "dial_category", "rest_window_days_min", "rest_window_days_max", "rating", "aromatics", "cupping_points", "roasting_type", "variety", "origin", "url", "notes", "arabica_pct", "body", "acidity", "sweetness", "roast_date", "buy_date", "opened_date", "best_by_date", "bag_weight_g", "weight_adjustment_g", "cost", "currency", "state", "finished", "frozen_at", "unfrozen_at", "frozen_storage", "frozen_note", "storage", "ean", "qr_code", "bag_notes", "effective_age_days", "age_verdict", "grams_remaining", "days_since_opened", "days_off_roast", "frozen_days_excluded", "current_bag_id", "bags", "origins" ], "type": "object" }, "type": "array" } }, "required": [ "beans" ], "type": "object" } }, { "description": "List grinders registered for the account, with status filter. The `id` on each row is the number this account knows that record by, counting from 1 — safe to show, and what other tools expect back. Each row carries its maintenance block: every task with its class (S schedule, H habit, Y symptom, A the machine signals it, T technician, N never, U unstated, E event), due state, and the guide to follow.", "inputSchema": { "properties": { "maintenance": { "description": "How much of each row's maintenance block to include. compact (default): every task with its class, due state, schedule and guide. full: also the maker's own words — quote, source, alternates, the interval as written.", "enum": [ "compact", "full" ], "type": "string" }, "status": { "description": "Filter by status: current, archived, or all. Defaults to current.", "enum": [ "current", "archived", "all" ], "type": "string" } }, "type": "object" }, "name": "list_grinders", "outputSchema": { "additionalProperties": true, "properties": { "grinders": { "items": { "additionalProperties": true, "properties": { "archived": { "type": "integer" }, "built_in_machine_id": { "type": [ "integer", "null" ] }, "burr_type": { "type": "string" }, "catalog_id": { "type": [ "null", "string" ] }, "components_spec": { "type": [ "null", "string" ] }, "direction_convention": { "type": "string" }, "id": { "type": "integer" }, "maintenance": { "additionalProperties": true, "properties": { "calibration": { "additionalProperties": true, "properties": { "disturbs_note": { "type": [ "null", "string" ] }, "epoch_at": { "type": [ "null", "string" ] }, "epoch_id": { "type": [ "null", "integer" ] }, "epoch_task": { "type": [ "null", "string" ] }, "evidence": { "type": [ "null", "string" ] }, "offset_at": { "type": [ "null", "string" ] }, "offset_source": { "type": [ "null", "string" ] }, "offset_unit": { "type": "string" }, "offset_value": { "type": [ "null", "integer" ] }, "reference_recipe_id": { "type": [ "null", "integer" ] }, "stale_recipe_count": { "type": "integer" }, "state": { "type": "string" }, "untranslatable_recipe_count": { "type": "integer" } }, "required": [ "stale_recipe_count", "untranslatable_recipe_count", "reference_recipe_id", "state", "epoch_id", "epoch_task", "disturbs_note", "epoch_at", "offset_value", "offset_unit", "offset_source", "offset_at", "evidence" ], "type": "object" }, "catalog": { "additionalProperties": true, "properties": { "brand": { "type": [ "string", "null" ] }, "declined": { "type": "boolean" }, "id": { "type": [ "string", "null" ] }, "match": { "additionalProperties": true, "properties": { "brand": { "type": "string" }, "by": { "type": "string" }, "id": { "type": "string" }, "model": { "type": "string" } }, "required": [], "type": [ "null", "object" ] }, "model": { "type": [ "string", "null" ] }, "via": { "type": [ "string", "null" ] } }, "required": [ "id", "brand", "model", "via", "match", "declined" ], "type": "object" }, "catalog_version": { "type": "string" }, "computed_at": { "type": "string" }, "due": { "additionalProperties": true, "properties": { "burr_clean": { "additionalProperties": true, "properties": { "basis": { "type": [ "null", "string" ] }, "done": { "type": [ "null", "integer" ] }, "due_at": { "type": [ "null", "string" ] }, "every": { "type": [ "null", "integer" ] }, "every_source": { "type": [ "null", "string" ] }, "last_at": { "type": [ "null", "string" ] }, "lower_bound": { "type": "boolean" }, "muted": { "type": "boolean" }, "muted_until": {}, "overdue_at": { "type": [ "null", "string" ] }, "ratio": { "type": [ "integer", "number" ] }, "remaining": { "type": [ "null", "integer" ] }, "soon": { "type": "boolean" }, "soon_at": { "type": [ "null", "string" ] }, "state": { "type": "string" } }, "required": [ "state", "ratio", "basis", "every", "done", "remaining", "lower_bound", "soon", "soon_at", "due_at", "overdue_at", "last_at", "every_source", "muted", "muted_until" ], "type": "object" } }, "required": [ "burr_clean" ], "type": "object" }, "entries": { "items": { "additionalProperties": true, "properties": { "created_at": { "type": "string" }, "details": { "additionalProperties": true, "properties": { "from": { "additionalProperties": true, "properties": { "components_spec": { "type": [ "null", "string" ] }, "nominal_step": { "type": [ "number", "integer" ] }, "setting_scheme": { "type": "string" } }, "required": [ "setting_scheme", "nominal_step", "components_spec" ], "type": "object" }, "to": { "additionalProperties": true, "properties": { "components_spec": { "type": [ "null", "string" ] }, "nominal_step": { "type": [ "number", "integer" ] }, "setting_scheme": { "type": "string" } }, "required": [ "setting_scheme", "nominal_step", "components_spec" ], "type": "object" } }, "required": [], "type": [ "object", "null" ] }, "details_known": { "type": "boolean" }, "details_version": { "type": "integer" }, "disturbs_zero": { "type": "integer" }, "equipment_id": { "type": "integer" }, "equipment_kind": { "type": "string" }, "evidence": { "type": [ "null", "string" ] }, "guide_id": {}, "id": { "type": "integer" }, "note": { "type": [ "string", "null" ] }, "offset_at": { "type": [ "null", "string" ] }, "offset_source": { "type": [ "null", "string" ] }, "offset_value": { "type": [ "null", "integer" ] }, "performed_at": { "type": "string" }, "task": { "type": "string" }, "task_label": { "type": "string" } }, "required": [ "id", "equipment_kind", "equipment_id", "task", "performed_at", "disturbs_zero", "note", "offset_value", "offset_source", "offset_at", "evidence", "details", "details_version", "created_at", "guide_id", "details_known", "task_label" ], "type": "object" }, "type": "array" }, "entries_total": { "type": "integer" }, "hardness": {}, "sensitivity": {}, "tasks": { "items": { "additionalProperties": true, "properties": { "class": { "type": "string" }, "details_fields": { "items": { "additionalProperties": true, "properties": { "hint": { "type": "string" }, "key": { "type": "string" }, "label": { "type": "string" }, "required": { "type": "boolean" }, "type": { "type": "string" } }, "required": [ "key", "type", "label", "hint", "required" ], "type": "object" }, "type": "array" }, "details_version": { "type": "integer" }, "disturbs_note": { "type": "string" }, "disturbs_prompt": { "type": [ "null", "string" ] }, "disturbs_zero": { "type": "boolean" }, "every": { "additionalProperties": true, "properties": { "days": { "type": "integer" }, "grams": { "type": "integer" }, "shots": { "type": "integer" } }, "required": [], "type": [ "null", "object" ] }, "every_source": { "additionalProperties": true, "properties": { "days": { "type": "string" }, "grams": { "type": "string" }, "shots": { "type": "string" } }, "required": [], "type": [ "null", "object" ] }, "guide": { "additionalProperties": true, "properties": { "also_covers": {}, "basis": { "type": "string" }, "duration_minutes": {}, "duration_note": {}, "id": { "type": "string" }, "machine_alert": {}, "market": {}, "scope": { "type": "string" }, "steps": { "type": "integer" }, "title": { "type": "string" }, "variant": { "type": "string" }, "warnings": { "type": "integer" } }, "required": [], "type": [ "object", "null" ] }, "kind": { "type": "string" }, "label": { "type": "string" }, "offset_integral": { "type": "boolean" }, "offset_unit": { "type": "string" }, "opened_by": { "type": [ "null", "string" ] }, "schedule": { "additionalProperties": true, "properties": { "enabled": { "type": "boolean" }, "every": {}, "muted_until": {} }, "required": [], "type": [ "null", "object" ] }, "scheduled": { "type": "boolean" }, "status": { "type": [ "string", "null" ] }, "sub": { "type": "string" }, "trigger": { "type": [ "string", "null" ] }, "value": { "type": "string" }, "why": { "type": "string" } }, "required": [ "value", "kind", "label", "sub", "disturbs_zero", "every", "why", "disturbs_note", "offset_unit", "offset_integral", "scheduled", "opened_by", "details_version", "details_fields", "class", "status", "trigger", "every_source", "disturbs_prompt", "guide", "schedule" ], "type": "object" }, "type": "array" } }, "required": [ "tasks", "due", "calibration", "sensitivity", "entries", "entries_total", "catalog_version", "computed_at", "catalog", "hardness" ], "type": "object" }, "max_value": { "type": [ "null", "integer" ] }, "microns_per_step": { "type": [ "null", "integer" ] }, "min_value": { "type": [ "null", "integer" ] }, "motor_type": { "type": "string" }, "name": { "type": "string" }, "nominal_step": { "type": [ "integer", "number" ] }, "notes": { "type": [ "null", "string" ] }, "position_value": { "type": [ "null", "integer" ] }, "setting_components": { "type": [ "null", "string" ] }, "setting_label": { "type": [ "null", "string" ] }, "setting_scheme": { "type": "string" }, "source": { "type": [ "null", "string" ] }, "verified_at": { "type": [ "null", "string" ] } }, "required": [ "id", "name", "motor_type", "burr_type", "setting_scheme", "direction_convention", "nominal_step", "components_spec", "min_value", "max_value", "microns_per_step", "notes", "archived", "catalog_id", "setting_label", "setting_components", "position_value", "source", "verified_at", "built_in_machine_id", "maintenance" ], "type": "object" }, "type": "array" } }, "required": [ "grinders" ], "type": "object" } }, { "description": "List machines registered for the account, with status filter. The `id` on each row is the number this account knows that record by, counting from 1 — safe to show, and what other tools expect back. Each row carries its maintenance block, researched per model: every task with its class, due state, what the maker forbids, and the guide to follow. `settings` lists the selectors its model has and where each stands (null: unknown model, or none).", "inputSchema": { "properties": { "maintenance": { "description": "How much of each row's maintenance block to include. compact (default): every task with its class, due state, schedule and guide. full: also the maker's own words — quote, source, alternates, the interval as written.", "enum": [ "compact", "full" ], "type": "string" }, "status": { "description": "Filter by status: current, archived, or all. Defaults to current.", "enum": [ "current", "archived", "all" ], "type": "string" } }, "type": "object" }, "name": "list_machines", "outputSchema": { "additionalProperties": true, "properties": { "machines": { "items": { "additionalProperties": true, "properties": { "archived": { "type": "integer" }, "basket_size_grams": { "type": [ "null", "integer" ] }, "boiler_type": { "type": [ "null", "string" ] }, "built_in_grinder_id": { "type": [ "null", "integer" ] }, "catalog_id": { "type": [ "string", "null" ] }, "control_type": { "type": "string" }, "hardness_dh": { "type": [ "null", "number" ] }, "id": { "type": "integer" }, "maintenance": { "additionalProperties": true, "properties": { "calibration": { "additionalProperties": true, "properties": { "disturbs_note": {}, "epoch_at": {}, "epoch_id": {}, "epoch_task": {}, "evidence": {}, "offset_at": {}, "offset_source": {}, "offset_unit": {}, "offset_value": {}, "reference_recipe_id": {}, "stale_recipe_count": { "type": "integer" }, "state": { "type": "string" }, "untranslatable_recipe_count": { "type": "integer" } }, "required": [ "stale_recipe_count", "untranslatable_recipe_count", "reference_recipe_id", "state", "epoch_id", "epoch_task", "disturbs_note", "epoch_at", "offset_value", "offset_unit", "offset_source", "offset_at", "evidence" ], "type": "object" }, "catalog": { "additionalProperties": true, "properties": { "brand": { "type": [ "string", "null" ] }, "declined": { "type": "boolean" }, "id": { "type": [ "string", "null" ] }, "match": {}, "model": { "type": [ "string", "null" ] }, "via": {} }, "required": [ "id", "brand", "model", "via", "match", "declined" ], "type": "object" }, "catalog_version": { "type": "string" }, "computed_at": { "type": "string" }, "due": { "additionalProperties": { "additionalProperties": true, "properties": { "basis": { "type": [ "null", "string" ] }, "done": { "type": [ "null", "integer" ] }, "due_at": { "type": [ "null", "string" ] }, "every": { "type": [ "null", "integer" ] }, "every_source": { "type": [ "null", "string" ] }, "last_at": { "type": [ "null", "string" ] }, "lower_bound": { "type": "boolean" }, "muted": { "type": "boolean" }, "muted_until": { "type": [ "null", "string" ] }, "overdue_at": { "type": [ "null", "string" ] }, "ratio": { "type": [ "integer", "number" ] }, "remaining": { "type": [ "null", "integer" ] }, "soon": { "type": "boolean" }, "soon_at": { "type": [ "null", "string" ] }, "state": { "type": "string" } }, "required": [ "state", "ratio", "basis", "every", "done", "remaining", "lower_bound", "soon", "soon_at", "due_at", "overdue_at", "last_at", "every_source", "muted", "muted_until" ], "type": "object" }, "properties": {}, "required": [], "type": [ "object", "null" ] }, "entries": { "items": { "additionalProperties": true, "properties": { "created_at": { "type": "string" }, "details": { "additionalProperties": true, "properties": { "filter_id": { "type": "string" }, "label": { "type": "string" }, "product": { "type": "string" } }, "required": [], "type": "object" }, "details_known": { "type": "boolean" }, "details_version": { "type": "integer" }, "disturbs_zero": { "type": "integer" }, "equipment_id": { "type": "integer" }, "equipment_kind": { "type": "string" }, "evidence": {}, "guide_id": { "type": [ "null", "string" ] }, "id": { "type": "integer" }, "note": {}, "offset_at": {}, "offset_source": {}, "offset_value": {}, "performed_at": { "type": "string" }, "task": { "type": "string" }, "task_label": { "type": "string" } }, "required": [ "id", "equipment_kind", "equipment_id", "task", "performed_at", "disturbs_zero", "note", "offset_value", "offset_source", "offset_at", "evidence", "details", "details_version", "created_at", "guide_id", "details_known", "task_label" ], "type": "object" }, "type": "array" }, "entries_total": { "type": "integer" }, "hardness": { "additionalProperties": true, "properties": { "dh": { "type": [ "null", "number" ] }, "dkh": { "type": [ "null", "number" ] }, "dkh_source": { "type": [ "null", "string" ] }, "source": { "type": [ "null", "string" ] } }, "required": [ "dh", "dkh", "source", "dkh_source" ], "type": "object" }, "sensitivity": {}, "tasks": { "items": { "additionalProperties": true, "properties": { "class": { "type": "string" }, "details_fields": { "items": { "additionalProperties": true, "properties": { "hint": { "type": [ "string", "null" ] }, "key": { "type": "string" }, "label": { "type": "string" }, "options": { "items": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "label": { "type": "string" } }, "required": [ "id", "label" ], "type": "object" }, "type": "array" }, "required": { "type": "boolean" }, "source": { "type": "string" }, "type": { "type": "string" } }, "required": [ "key", "type", "label", "hint", "required" ], "type": "object" }, "type": "array" }, "details_version": { "type": "integer" }, "disturbs_note": { "type": "string" }, "disturbs_prompt": {}, "disturbs_zero": { "type": "boolean" }, "every": { "additionalProperties": true, "properties": { "days": { "type": "integer" }, "litres": { "type": [ "integer", "number" ] }, "shots": { "type": "integer" } }, "required": [], "type": [ "null", "object" ] }, "every_source": { "additionalProperties": true, "properties": { "days": { "type": "string" }, "litres": { "type": "string" }, "shots": { "type": "string" } }, "required": [], "type": [ "null", "object" ] }, "guide": { "additionalProperties": true, "properties": { "also_covers": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "basis": { "type": "string" }, "duration_minutes": { "type": [ "null", "integer" ] }, "duration_note": {}, "id": { "type": "string" }, "machine_alert": { "additionalProperties": true, "properties": { "can_disable": {}, "clears": { "type": [ "null", "string" ] }, "counts": { "type": "string" }, "depends_on_setting": {}, "indicator": { "type": "string" }, "shown_as": { "type": "string" }, "source": { "type": "string" }, "threshold": {} }, "required": [], "type": [ "null", "object" ] }, "market": {}, "scope": { "type": "string" }, "steps": { "type": "integer" }, "title": { "type": "string" }, "variant": {}, "warnings": { "type": "integer" } }, "required": [], "type": [ "null", "object" ] }, "kind": { "type": "string" }, "label": { "type": "string" }, "offset_integral": { "type": "boolean" }, "offset_unit": { "type": "string" }, "opened_by": {}, "schedule": { "additionalProperties": true, "properties": { "enabled": { "type": "boolean" }, "every": { "additionalProperties": true, "properties": { "days": { "type": "integer" }, "litres": { "type": "number" } }, "required": [ "days", "litres" ], "type": "object" }, "muted_until": { "type": "string" } }, "required": [], "type": [ "null", "object" ] }, "scheduled": { "type": "boolean" }, "status": { "type": [ "string", "null" ] }, "sub": { "type": "string" }, "trigger": { "type": [ "null", "string" ] }, "value": { "type": "string" }, "why": { "type": "string" } }, "required": [ "value", "kind", "label", "sub", "disturbs_zero", "every", "why", "disturbs_note", "offset_unit", "offset_integral", "scheduled", "opened_by", "details_version", "details_fields", "class", "status", "trigger", "every_source", "disturbs_prompt", "guide", "schedule" ], "type": "object" }, "type": "array" } }, "required": [ "tasks", "due", "calibration", "sensitivity", "entries", "entries_total", "catalog_version", "computed_at", "catalog", "hardness" ], "type": "object" }, "name": { "type": "string" }, "notes": { "type": [ "null", "string" ] }, "prep_style": { "type": [ "string", "null" ] }, "prep_type": { "type": [ "string", "null" ] }, "programs": { "items": { "additionalProperties": true, "properties": { "description": { "type": [ "string", "null" ] }, "id": { "type": "integer" }, "is_active": { "type": "integer" }, "program_number": { "type": "integer" }, "program_type": { "type": "string" }, "target_time_s": {}, "target_volume_g": { "type": "integer" }, "volume_source": { "type": "string" } }, "required": [ "id", "program_number", "program_type", "target_volume_g", "target_time_s", "volume_source", "description", "is_active" ], "type": "object" }, "type": "array" }, "settings": { "items": { "additionalProperties": true, "properties": { "default": { "type": [ "number", "null", "string" ] }, "key": { "type": "string" }, "label": { "type": "string" }, "max": { "type": [ "number", "null" ] }, "min": { "type": [ "number", "null" ] }, "options": { "items": { "additionalProperties": true, "properties": { "label": { "type": "string" }, "meaning": { "type": [ "string", "null" ] }, "value": { "type": "string" } }, "required": [ "value", "label", "meaning" ], "type": "object" }, "type": [ "null", "array" ] }, "step": {}, "type": { "type": "string" }, "unit": { "type": [ "string", "null" ] }, "value": { "type": [ "number", "null", "string" ] } }, "required": [ "key", "label", "type", "options", "min", "max", "step", "unit", "default", "value" ], "type": "object" }, "type": [ "array", "null" ] }, "tools_list": { "items": { "type": "string" }, "type": "array" } }, "required": [ "id", "name", "control_type", "basket_size_grams", "boiler_type", "notes", "prep_type", "prep_style", "archived", "built_in_grinder_id", "catalog_id", "hardness_dh", "tools_list", "programs", "maintenance", "settings" ], "type": "object" }, "type": "array" } }, "required": [ "machines" ], "type": "object" } }, { "description": "What maintenance is due across the user's current grinders and machines, most urgent first — for \"is anything due?\". Only tasks with an interval compete: a task the machine counts and signals itself, one done by habit or when a symptom shows, and one the maker advises against never appear. Each item says how far along it is (ratio, done of every, on which basis), whether it is coming up (soon), and whether the interval is the user's, the maker's or ShotPulled's default.", "inputSchema": { "properties": { "status": { "description": "due (default): due or overdue, and not muted. all: every scheduled task, muted ones last", "enum": [ "due", "all" ], "type": "string" } }, "type": "object" }, "name": "list_maintenance_due", "outputSchema": { "additionalProperties": true, "properties": { "catalog_version": { "type": "string" }, "computed_at": { "type": "string" }, "items": { "items": { "additionalProperties": true, "properties": { "basis": { "type": [ "string", "null" ] }, "class": { "type": "string" }, "done": { "type": [ "integer", "null" ] }, "due_at": { "type": [ "null", "string" ] }, "equipment_id": { "type": "integer" }, "equipment_kind": { "type": "string" }, "equipment_name": { "type": "string" }, "every": { "type": [ "integer", "null" ] }, "every_source": { "type": [ "string", "null" ] }, "label": { "type": "string" }, "last_at": { "type": [ "null", "string" ] }, "lower_bound": { "type": "boolean" }, "muted": { "type": "boolean" }, "muted_until": { "type": [ "null", "string" ] }, "overdue_at": { "type": [ "null", "string" ] }, "ratio": { "type": [ "number", "integer" ] }, "remaining": { "type": [ "integer", "null" ] }, "soon": { "type": "boolean" }, "soon_at": { "type": [ "null", "string" ] }, "state": { "type": "string" }, "task": { "type": "string" } }, "required": [ "equipment_kind", "equipment_id", "equipment_name", "task", "label", "class", "state", "ratio", "basis", "every", "done", "remaining", "last_at", "every_source", "lower_bound", "soon", "soon_at", "due_at", "overdue_at", "muted", "muted_until" ], "type": "object" }, "type": "array" } }, "required": [ "catalog_version", "computed_at", "items" ], "type": "object" } }, { "description": "List recipes (all or filtered by equipment and status). The `id` on each row is the number this account knows that record by, counting from 1 — safe to show, and what other tools expect back.", "inputSchema": { "properties": { "bean_id": { "type": "integer" }, "grinder_id": { "type": "integer" }, "machine_id": { "type": "integer" }, "status": { "description": "Filter by status: current, archived, or all. Defaults to current.", "enum": [ "current", "archived", "all" ], "type": "string" } }, "type": "object" }, "name": "list_recipes", "outputSchema": { "additionalProperties": true, "properties": { "recipes": { "items": { "additionalProperties": true, "properties": { "bean_id": { "type": "integer" }, "bean_name": { "type": "string" }, "dose_g": { "type": [ "integer", "number" ] }, "drink_intent": { "type": "string" }, "finish_action": { "type": "string" }, "grind_label": { "type": "string" }, "grind_position_value": { "type": "integer" }, "grind_reading": { "additionalProperties": true, "properties": { "epoch_tasks": { "items": { "type": "string" }, "type": "array" }, "epochs_since": { "type": "integer" }, "label": {}, "offset_clicks": {}, "offset_direction": {}, "unmeasured": { "type": "integer" }, "untranslatable": { "type": "boolean" } }, "required": [], "type": [ "null", "object" ] }, "grinder_id": { "type": "integer" }, "grinder_name": { "type": "string" }, "id": { "type": "integer" }, "locked_at": { "type": "string" }, "machine_id": { "type": "integer" }, "machine_name": { "type": "string" }, "profile": { "type": "string" }, "program_id": { "type": [ "null", "integer" ] }, "roaster_name": { "type": "string" }, "status": { "type": "string" }, "target_time_s": { "type": "integer" }, "target_yield_g": { "type": [ "integer", "number" ] } }, "required": [ "id", "bean_id", "grinder_id", "machine_id", "program_id", "status", "grind_label", "grind_position_value", "dose_g", "target_yield_g", "target_time_s", "finish_action", "drink_intent", "profile", "locked_at", "bean_name", "roaster_name", "grinder_name", "machine_name", "grind_reading" ], "type": "object" }, "type": "array" } }, "required": [ "recipes" ], "type": "object" } }, { "description": "List registered scales for the account. The `id` on each row is the number this account knows that record by, counting from 1 — safe to show, and what other tools expect back.", "inputSchema": { "properties": { "status": { "description": "Filter by status: current (unarchived), archived, or all. Defaults to current.", "enum": [ "current", "archived", "all" ], "type": "string" } }, "type": "object" }, "name": "list_scales", "outputSchema": { "additionalProperties": true, "properties": { "scales": { "items": { "additionalProperties": true, "properties": { "archived": { "type": "integer" }, "auto_tare": {}, "auto_timer": {}, "capacity_g": {}, "connectivity": {}, "depth_mm": {}, "flow_rate_display": {}, "height_mm": {}, "id": { "type": "integer" }, "name": { "type": "string" }, "notes": {}, "power": {}, "resolution_banded": { "type": "integer" }, "resolution_g": { "type": "number" }, "scale_type": { "type": "string" }, "water_resistance": {}, "width_mm": {} }, "required": [ "id", "name", "scale_type", "resolution_g", "resolution_banded", "capacity_g", "width_mm", "depth_mm", "height_mm", "water_resistance", "connectivity", "flow_rate_display", "auto_tare", "auto_timer", "power", "notes", "archived" ], "type": "object" }, "type": "array" } }, "required": [ "scales" ], "type": "object" } }, { "description": "List shot history with support for pagination and filtering. Every shot carries a derived taste_pending flag (1 = logged with no sensory tags, no rating, and no tasted flip — the tasting is still owed and can be backfilled with update_shot).", "inputSchema": { "properties": { "filters": { "properties": { "bag_id": { "description": "Filter by bag number (one purchase of a coffee)", "type": "integer" }, "bean_id": { "description": "Filter by coffee bean ID", "type": "integer" }, "best": { "description": "Filter by best brew status", "enum": [ 0, 1 ], "type": "integer" }, "date_from": { "description": "Filter shots pulled on or after YYYY-MM-DD", "type": "string" }, "date_to": { "description": "Filter shots pulled on or before YYYY-MM-DD", "type": "string" }, "favourite": { "description": "Filter by favourite status", "enum": [ 0, 1 ], "type": "integer" }, "grinder_id": { "description": "Filter by grinder ID", "type": "integer" }, "machine_id": { "description": "Filter by machine ID", "type": "integer" }, "taste_pending": { "description": "1 = shots logged without sensory tags, a rating, or the tasted flip (tasting still owed); 0 = tasted shots", "enum": [ 0, 1 ], "type": "integer" } }, "type": "object" }, "limit": { "default": 50, "description": "Number of records to return (1-500)", "maximum": 500, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "Offset for pagination", "minimum": 0, "type": "integer" } }, "type": "object" }, "name": "list_shots", "outputSchema": { "additionalProperties": true, "properties": { "shots": { "items": { "additionalProperties": true, "properties": { "bag_id": { "type": "integer" }, "bean_id": { "type": "integer" }, "bean_name": { "type": "string" }, "best_brew": { "type": "integer" }, "beverage_g": {}, "bloom_time_s": {}, "data_confidence": { "type": "string" }, "dose_g": { "type": "integer" }, "drink_intent": { "type": "string" }, "ey_pct": {}, "favourite": { "type": "integer" }, "finish_action": { "type": "string" }, "first_drip_time_s": {}, "flavor_notes": { "type": [ "string", "null" ] }, "flow_rate_gps": { "type": "number" }, "grind_components": { "type": "string" }, "grind_label": { "type": "string" }, "grind_position_value": { "type": "integer" }, "grinder_id": { "type": "integer" }, "id": { "type": "integer" }, "machine_id": { "type": "integer" }, "machine_settings": { "type": [ "null", "string" ] }, "observations": { "type": "string" }, "program_id": {}, "pulled_at": { "type": "string" }, "rating": {}, "sensory_tags": { "type": "string" }, "taste_pending": { "type": "integer" }, "tasted": { "type": "integer" }, "tds": {}, "temp_taste": { "type": "string" }, "temperature_c": {}, "time_s": { "type": "integer" }, "verdict": {}, "vessel_name": {}, "vessel_weight_g": {}, "water_id": {}, "yield_g": { "type": "integer" } }, "required": [ "id", "pulled_at", "bean_id", "grinder_id", "machine_id", "program_id", "grind_label", "grind_components", "grind_position_value", "dose_g", "yield_g", "time_s", "flow_rate_gps", "finish_action", "drink_intent", "flavor_notes", "sensory_tags", "observations", "temp_taste", "rating", "verdict", "data_confidence", "temperature_c", "bloom_time_s", "first_drip_time_s", "beverage_g", "tds", "ey_pct", "water_id", "vessel_name", "vessel_weight_g", "favourite", "best_brew", "tasted", "bag_id", "machine_settings", "bean_name", "taste_pending" ], "type": "object" }, "type": "array" }, "total": { "type": "integer" } }, "required": [ "shots", "total" ], "type": "object" } }, { "description": "List registered waters for the account. The `id` on each row is the number this account knows that record by, counting from 1 — safe to show, and what other tools expect back.", "inputSchema": { "properties": { "status": { "description": "Filter by status: current (unarchived), archived, or all. Defaults to current.", "enum": [ "current", "archived", "all" ], "type": "string" } }, "type": "object" }, "name": "list_waters", "outputSchema": { "additionalProperties": true, "properties": { "waters": { "items": { "additionalProperties": true, "properties": { "archived": { "type": "integer" }, "calcium": {}, "gh": { "type": "integer" }, "id": { "type": "integer" }, "kh": { "type": "integer" }, "magnesium": {}, "name": { "type": "string" }, "notes": {}, "sodium": {}, "tds": {}, "type": {} }, "required": [ "id", "name", "type", "tds", "gh", "kh", "sodium", "calcium", "magnesium", "notes", "archived" ], "type": "object" }, "type": "array" } }, "required": [ "waters" ], "type": "object" } }, { "description": "Lock a successful shot as the reference dialing recipe for this equipment profile. It overwrites the recipe already locked for the same coffee, grinder, machine, program and drink intent, which keeps its recipe_id.", "inputSchema": { "properties": { "drink_intent": { "enum": [ "straight", "milk" ], "type": "string" }, "from_shot_id": { "type": "integer" } }, "required": [ "from_shot_id", "drink_intent" ], "type": "object" }, "name": "lock_recipe", "outputSchema": { "additionalProperties": true, "properties": { "message": { "type": "string" }, "recipe_id": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "status", "recipe_id", "message" ], "type": "object" } }, { "description": "Log a cleaning or maintenance job against a piece of equipment. A task that takes the thing apart opens a calibration epoch, and every recipe locked before it is read through that epoch's offset — so record the offset here if you counted the clicks while reassembling, which is the one moment anybody actually knows it. Any task in the maintenance vocabulary can be logged against a grinder or machine it belongs to — including one the maker advises against, because the log records what was done. Read each piece of equipment's tasks, their intervals and their due state from list_grinders and list_machines.", "inputSchema": { "properties": { "details": { "additionalProperties": true, "description": "Fields specific to this task. Which ones a task takes is published as details_fields on each task; a burr clean takes none", "type": "object" }, "disturbs_zero": { "description": "Whether this job disturbed the reference the stored numbers are read against — for a burr clean, whether the burrs actually came out. Defaults to the task's own answer; send 0 for a wipe-down that left the collar alone", "enum": [ 0, 1 ], "type": "integer" }, "equipment_id": { "description": "The ID of that piece of equipment", "type": "integer" }, "equipment_kind": { "description": "Which kind of equipment this job was done on", "enum": [ "grinder", "machine" ], "type": "string" }, "evidence": { "description": "One line recording what the measurement rested on, e.g. \"Counted 6 clicks coarser at reassembly.\"", "type": "string" }, "guide_id": { "description": "Optional — the id of the maintenance guide that was followed. Must be a guide for this task", "type": "string" }, "note": { "description": "Optional — what you did, and anything that surprised you", "type": "string" }, "offset_source": { "description": "How the offset was arrived at: pull (a reference shot), counted (clicks counted at reassembly), typed (asserted directly)", "enum": [ "pull", "counted", "typed" ], "type": "string" }, "offset_value": { "description": "The correction, if you measured it now: clicks to ADD to a pre-clean reading to get the same grind today, signed along the collar's own number direction. Omit it and the epoch stays unmeasured, which is a state the app shows rather than a zero it assumes", "type": "number" }, "performed_at": { "description": "When it was done (ISO 8601 or YYYY-MM-DD HH:MM:SS, UTC). Defaults to now; backdating is fine", "type": "string" }, "task": { "description": "Which maintenance job was performed", "enum": [ "burr_clean", "backflush_water", "backflush_detergent", "descale", "group_gasket_replace", "shower_screen_clean", "shower_screen_replace", "group_head_wipe", "basket_portafilter_soak", "steam_wand_purge", "steam_wand_soak", "drip_tray_clean", "water_tank_clean", "water_filter_replace", "boiler_water_change", "lever_piston_seal_replace", "lever_lubricate", "milk_system_clean", "professional_service", "builtin_grinder_burr_clean", "builtin_grinder_burr_replace", "grinder_quick_clean", "grinder_cleaning_tablets", "burr_replace", "hopper_clean", "grounds_cup_clean", "bearing_lubricate", "gasket_seal_replace", "idle_rinse", "water_wash", "dishwasher", "filter_prime", "softener_regenerate", "other" ], "type": "string" } }, "required": [ "equipment_kind", "equipment_id", "task" ], "type": "object" }, "name": "log_maintenance", "outputSchema": { "additionalProperties": true, "properties": { "deduped": { "type": "boolean" }, "entry": { "additionalProperties": true, "properties": { "created_at": { "type": "string" }, "details": { "additionalProperties": true, "properties": { "filter_id": { "type": "string" }, "label": { "type": "string" }, "product": { "type": "string" } }, "required": [], "type": [ "null", "object" ] }, "details_known": { "type": "boolean" }, "details_version": { "type": "integer" }, "disturbs_zero": { "type": "integer" }, "equipment_id": { "type": "integer" }, "equipment_kind": { "type": "string" }, "evidence": { "type": [ "null", "string" ] }, "guide_id": { "type": [ "null", "string" ] }, "id": { "type": "integer" }, "note": { "type": [ "string", "null" ] }, "offset_at": { "type": [ "null", "string" ] }, "offset_source": { "type": [ "null", "string" ] }, "offset_value": { "type": [ "null", "integer" ] }, "performed_at": { "type": "string" }, "task": { "type": "string" } }, "required": [ "id", "equipment_kind", "equipment_id", "task", "performed_at", "disturbs_zero", "note", "offset_value", "offset_source", "offset_at", "evidence", "details", "details_version", "created_at", "guide_id", "details_known" ], "type": "object" }, "entry_id": { "type": "integer" }, "message": { "type": "string" } }, "required": [ "entry_id", "entry", "deduped", "message" ], "type": "object" } }, { "description": "Log a recommended dialing change to allow contradiction/oscillation checking (G2).", "inputSchema": { "properties": { "based_on_shot": { "type": "integer" }, "cited_rules": { "items": { "type": "string" }, "type": "array" }, "confidence": { "enum": [ "low", "medium", "high" ], "type": "string" }, "direction": { "enum": [ "finer", "coarser", "more", "less", "same" ], "type": "string" }, "lever": { "enum": [ "grind", "yield", "temp", "program", "prep", "none" ], "type": "string" }, "rationale": { "type": "string" } }, "required": [ "lever", "direction", "rationale", "confidence" ], "type": "object" }, "name": "log_recommendation", "outputSchema": { "additionalProperties": true, "properties": { "message": { "type": "string" }, "status": { "type": "string" } }, "required": [ "status", "message" ], "type": "object" } }, { "description": "Log an espresso or alternative shot/brew attempt. Uses the active context (bean/grinder/machine/program) unless overridden via bean_id/grinder_id/machine_id/program_id — ALWAYS pass bean_id explicitly when the user names a specific coffee, so the shot cannot land on the wrong bag. Backdate with pulled_at when the shot happened earlier. When the user reports taste (bitter, sour, harsh, hollow…), include matching sensory_tags — the diagnosis engine reads tags and metrics, not free-text flavor_notes. When the user tasted the shot and reports it as GOOD/clean (no defects), pass tasted=1 with no sensory_tags — otherwise a tag-less, rating-less shot is filed taste-pending as if never tasted.", "inputSchema": { "properties": { "bag_id": { "description": "Which bag of the coffee the shot came from; defaults to its current (open) bag. Bag numbers are on list_beans' bags[]", "type": [ "integer", "null" ] }, "bean_id": { "description": "Override: log against this bean instead of the active one (null = active)", "type": [ "integer", "null" ] }, "best_brew": { "description": "1 if marked as best brew, 0 otherwise", "enum": [ 0, 1 ], "type": "integer" }, "beverage_g": { "description": "Yield mass excluding cup/vessel weight in grams", "type": "number" }, "bloom_time_s": { "description": "Pre-wetting or bloom duration in seconds", "type": "number" }, "data_confidence": { "description": "measured = weighed/timed live; recalled = from memory; estimated = a best guess (e.g. missed the timer — \"~25s\")", "enum": [ "measured", "recalled", "estimated" ], "type": "string" }, "dose_g": { "type": "number" }, "drink_intent": { "enum": [ "straight", "milk" ], "type": "string" }, "favourite": { "description": "1 if favourite, 0 otherwise", "enum": [ 0, 1 ], "type": "integer" }, "finish_action": { "enum": [ "hard_stop", "passive_drip" ], "type": "string" }, "first_drip_time_s": { "description": "Time to first drip in seconds", "type": "number" }, "flavor_notes": { "maxLength": 4096, "type": "string" }, "flow_profile": { "description": "Opaque flow profile data (JSON/TEXT)", "maxLength": 16384, "type": "string" }, "grinder_id": { "description": "Override: grinder used, if not the active one (null = active)", "type": [ "integer", "null" ] }, "machine_id": { "description": "Override: machine used, if not the active one (null = active)", "type": [ "integer", "null" ] }, "machine_settings": { "description": "Only when this one shot was pulled with a selector somewhere other than the machine's recorded settings: {key: position}. The shot is otherwise stamped with those automatically; a lasting change goes through update_machine.", "maxProperties": 16, "type": "object" }, "method_tools": { "description": "JSON representation of method tools used (e.g., paper filters, screen)", "maxLength": 4096, "type": "string" }, "observations": { "maxProperties": 64, "type": "object" }, "pressure_profile": { "description": "Pressure profile description or values", "maxLength": 16384, "type": "string" }, "program_id": { "description": "Override: machine program used, if not the active one (null = active)", "type": [ "integer", "null" ] }, "pulled_at": { "description": "When the shot was actually pulled (ISO 8601 or \"YYYY-MM-DD HH:MM:SS\"), for backdated entries. Defaults to now (null = now). When backdating, pass the returned shot_id to diagnose_shot explicitly — the default diagnosis target is the chronologically latest shot.", "type": [ "string", "null" ] }, "rating": { "maximum": 5, "minimum": 1, "type": "integer" }, "sensory_tags": { "items": { "maxLength": 128, "type": "string" }, "maxItems": 64, "type": "array" }, "tasted": { "description": "1 = the shot was tasted at log time. The explicit way to record a CLEAN tasting: sensory tags all describe defects, so a good shot has none — without this flag (or a rating) it would be filed taste-pending. Tags or a rating also mark a shot as tasted; 0 (default) = taste later.", "enum": [ 0, 1 ], "type": "integer" }, "tds": { "description": "Total Dissolved Solids percentage (e.g. 9.1 or 1.35)", "type": "number" }, "temp_taste": { "enum": [ "hot", "warm", "cold" ], "type": "string" }, "temperature_c": { "description": "Brew temperature in Celsius", "type": "number" }, "time_s": { "type": "number" }, "verdict": { "type": "string" }, "vessel_name": { "description": "Cup/vessel name", "type": "string" }, "vessel_weight_g": { "description": "Cup/vessel weight in grams", "type": "number" }, "water_id": { "description": "Optional references to waters formulation", "type": "integer" }, "yield_g": { "type": "number" } }, "required": [ "dose_g", "yield_g", "time_s", "finish_action" ], "type": "object" }, "name": "log_shot", "outputSchema": { "additionalProperties": true, "properties": { "message": { "type": "string" }, "shot_id": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "status", "shot_id", "message" ], "type": "object" } }, { "description": "Fold one coffee into another when the same coffee was registered twice. Every bag, shot, recipe and recommendation of from_bean_id moves to into_bean_id; the active coffee follows if it was the one merged away; origins move only if the target has none. Where both hold a locked recipe for the same grinder, machine, program and drink, the newer lock wins and the older is deleted. The source coffee is archived, never deleted. Irreversible — confirm both numbers with the user first (list_beans shows them).", "inputSchema": { "properties": { "from_bean_id": { "description": "The duplicate: the coffee number that will be emptied and archived", "type": "integer" }, "into_bean_id": { "description": "The coffee number that keeps everything", "type": "integer" }, "reason": { "description": "Optional note, recorded on the surviving coffee's notes with the merge", "type": "string" } }, "required": [ "from_bean_id", "into_bean_id" ], "type": "object" }, "name": "merge_beans", "outputSchema": { "additionalProperties": true, "properties": { "active_followed": { "type": "boolean" }, "into_bean_id": { "type": "integer" }, "message": { "type": "string" }, "moved": { "additionalProperties": true, "properties": { "bags": { "type": "integer" }, "recipes": { "type": "integer" }, "recommendations": { "type": "integer" }, "shots": { "type": "integer" } }, "required": [ "bags", "shots", "recipes", "recommendations" ], "type": "object" }, "replaced_recipes": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "status", "into_bean_id", "moved", "replaced_recipes", "active_followed", "message" ], "type": "object" } }, { "description": "Register another bag of a coffee that is already in list_beans — the same roaster's product, bought again. It keeps the coffee's recipes, notes and history; only the purchase facts (roast date, weight, price, state) are new. Does not change the active coffee. Returns a bag_id: bag numbers are their own series, separate from bean numbers. For a coffee that is not in list_beans yet, call register_coffee instead.", "inputSchema": { "properties": { "bag_notes": { "description": "Notes about THIS bag (a batch note, where it was bought). The coffee's own description lives on the coffee, in notes.", "maxLength": 4096, "type": "string" }, "bag_weight_g": { "description": "Bag weight in grams", "type": "number" }, "bean_id": { "description": "This account's own coffee number, from list_beans. Never guess one.", "type": "integer" }, "best_by_date": { "description": "Calendar day in YYYY-MM-DD format — a day, not a timestamp", "type": "string" }, "buy_date": { "description": "Calendar day in YYYY-MM-DD format — a day, not a timestamp", "type": "string" }, "cost": { "type": "number" }, "currency": { "type": "string" }, "ean": { "type": "string" }, "opened_date": { "description": "Calendar day in YYYY-MM-DD format — a day, not a timestamp", "type": "string" }, "qr_code": { "type": "string" }, "roast_date": { "description": "Calendar day in YYYY-MM-DD format — a day, not a timestamp", "type": "string" }, "state": { "description": "Defaults to sealed; the first log_shot against it opens it", "enum": [ "sealed", "open", "frozen", "finished" ], "type": "string" }, "storage": { "type": "string" } }, "required": [ "bean_id", "roast_date" ], "type": "object" }, "name": "register_bag", "outputSchema": { "additionalProperties": true, "properties": { "bag_id": { "type": "integer" }, "bean_id": { "type": "integer" }, "message": { "type": "string" }, "status": { "type": "string" } }, "required": [ "status", "bag_id", "bean_id", "message" ], "type": "object" } }, { "description": "Register a coffee that is NOT yet in list_beans, together with its first bag. It does not switch a coffee in use: it becomes active only when no coffee is in use (none active, or the active one archived or with every bag finished); otherwise call set_active with its bean_id when the user starts brewing it. The `active` field of the reply says which. The coffee is the roaster's product (roaster, origins, variety, process, roast level, roasting type, cupping score, aromatics, roaster notes, rest window); the bag is this purchase (roast date, weight, price, state). For another bag of a coffee already on file call register_bag instead — it keeps the recipes and notes. Returns bean_id and the first bag's bag_id.", "inputSchema": { "properties": { "acidity": { "description": "Free text; roasters usually say low, medium or high", "type": "string" }, "arabica_pct": { "description": "Percent arabica, 100 for a pure arabica; the rest robusta", "maximum": 100, "minimum": 0, "type": "number" }, "archived": { "description": "1 if archived, 0 otherwise", "type": "integer" }, "aromatics": { "maxLength": 1024, "type": "string" }, "attachments": { "description": "JSON or comma-separated list of attachments", "maxLength": 1024, "type": "string" }, "bag_notes": { "maxLength": 4096, "type": "string" }, "bag_weight_g": { "description": "Bag weight in grams", "type": "number" }, "bean_mix": { "description": "E.g. blend details", "type": "string" }, "best_by_date": { "description": "Calendar day in YYYY-MM-DD format — a day, not a timestamp", "type": "string" }, "body": { "description": "Free text; roasters usually say low, medium or high", "type": "string" }, "buy_date": { "description": "Calendar day in YYYY-MM-DD format — a day, not a timestamp", "type": "string" }, "co2e_kg": { "type": "number" }, "cost": { "type": "number" }, "cupping_points": { "type": "number" }, "currency": { "type": "string" }, "decaffeinated": { "description": "1 if decaf, 0 if regular", "type": "integer" }, "dial_category": { "description": "Dialing behavior class: classic = medium/traditional espresso roasts (chocolate/nut, balanced); dark = genuinely dark/roasty; the light categories cover Nordic and ultra-light styles.", "enum": [ "nordic-light", "ultra-light", "classic", "processed", "dark", "aged" ], "type": "string" }, "ean": { "type": "string" }, "favourite": { "description": "1 if favourite, 0 otherwise", "type": "integer" }, "finished": { "description": "1 if finished, 0 otherwise", "type": "integer" }, "frozen_at": { "description": "Calendar day the bag went into the freezer, YYYY-MM-DD — a day, not a timestamp", "type": "string" }, "frozen_note": { "type": "string" }, "frozen_storage": { "type": "string" }, "name": { "type": "string" }, "notes": { "description": "The coffee's own description — the roaster's tasting notes, the dialing approach that worked. Per bag notes go in bag_notes.", "maxLength": 4096, "type": "string" }, "opened_date": { "description": "Calendar day in YYYY-MM-DD format — a day, not a timestamp", "type": "string" }, "origin": { "type": "string" }, "origins": { "description": "List of bean origin details", "items": { "properties": { "country": { "type": "string" }, "elevation_m": { "type": "number" }, "elevation_max_m": { "description": "Upper end of an elevation range, e.g. 1980 for \"1800–1980 m\"; elevation_m is the lower end", "type": "number" }, "farm": { "type": "string" }, "farmer": { "type": "string" }, "harvest": { "type": "string" }, "percentage": { "type": "number" }, "processing": { "type": "string" }, "region": { "type": "string" }, "variety": { "type": "string" } }, "type": "object" }, "type": "array" }, "process_type": { "enum": [ "washed", "natural", "honey", "anaerobic", "aerobic-extended", "co-fermented", "bioreactor", "other" ], "type": "string" }, "qr_code": { "type": "string" }, "rating": { "maximum": 5, "minimum": 1, "type": "integer" }, "rest_window_days_max": { "type": "integer" }, "rest_window_days_min": { "type": "integer" }, "roast_custom": { "type": "string" }, "roast_date": { "description": "Calendar day in YYYY-MM-DD format — a day, not a timestamp", "type": "string" }, "roast_level": { "enum": [ "ultra-light", "light", "medium", "medium-dark", "dark" ], "type": "string" }, "roast_range": { "type": "string" }, "roaster": { "type": "string" }, "roasting_type": { "enum": [ "filter", "espresso", "omni" ], "type": "string" }, "state": { "enum": [ "sealed", "open", "frozen", "finished" ], "type": "string" }, "storage": { "type": "string" }, "sweetness": { "description": "Free text; roasters usually say low, medium or high", "type": "string" }, "unfrozen_at": { "description": "Calendar day the bag came out, YYYY-MM-DD — a day, not a timestamp", "type": "string" }, "url": { "type": "string" }, "variety": { "type": "string" } }, "required": [ "name", "roast_date", "roast_level", "process_type" ], "type": "object" }, "name": "register_coffee", "outputSchema": { "additionalProperties": true, "properties": { "active": { "type": "boolean" }, "bag_id": { "type": "integer" }, "bean_id": { "type": "integer" }, "message": { "type": "string" }, "status": { "type": "string" } }, "required": [ "status", "bean_id", "bag_id", "active", "message" ], "type": "object" } }, { "description": "Register a manual or electric grinder with its dial settings scheme. It becomes the active grinder only when no grinder is in use (none active, or the active one archived); otherwise call set_active with its grinder_id to switch to it. The `active` field of the reply says which.", "inputSchema": { "properties": { "archived": { "description": "1 if archived, 0 if active", "type": "integer" }, "burr_type": { "enum": [ "conical", "flat" ], "type": "string" }, "catalog_id": { "description": "Optional — the maintenance catalog model this is (the `id` of a catalog row, e.g. rancilio-silvia), when it was registered from the catalog. Its maintenance then comes from that model's researched record. \"none\" says it is not in the catalog.", "type": "string" }, "components_spec": { "description": "JSON mapping string representing compound adjustment math", "maxLength": 4096, "type": "string" }, "direction_convention": { "enum": [ "lower_is_finer", "higher_is_finer" ], "type": "string" }, "max_value": { "description": "Optional travel max bounds", "type": [ "number", "null" ] }, "microns_per_step": { "description": "Optional mechanical burr travel microns per nominal step", "type": [ "number", "null" ] }, "min_value": { "description": "Optional travel min bounds", "type": [ "number", "null" ] }, "motor_type": { "enum": [ "manual", "electric" ], "type": "string" }, "name": { "description": "The name/model of the grinder, e.g. Kinu M47", "type": "string" }, "nominal_step": { "description": "Smallest adjustment increment (e.g. 1 click or 0.1collar units)", "type": "number" }, "notes": { "description": "Additional notes", "type": "string" }, "photo": { "description": "Photo path or URL", "type": "string" }, "setting_scheme": { "description": "Collar mark style: single clicks or compound (rotation.number.clicks)", "enum": [ "numeric_stepless", "numeric_stepped", "clicks_single", "compound", "named" ], "type": "string" } }, "required": [ "name", "motor_type", "burr_type", "setting_scheme", "direction_convention", "nominal_step" ], "type": "object" }, "name": "register_grinder", "outputSchema": { "additionalProperties": true, "properties": { "active": { "type": "boolean" }, "grinder_id": { "type": "integer" }, "message": { "type": "string" }, "status": { "type": "string" } }, "required": [ "status", "grinder_id", "active", "message" ], "type": "object" } }, { "description": "Register an espresso or alternative preparation machine. It becomes the active machine only when no machine is in use (none active, or the active one archived); otherwise call set_active with its machine_id to switch to it. The `active` field of the reply says which.", "inputSchema": { "properties": { "archived": { "description": "1 if archived, 0 if active", "type": "integer" }, "basket_size_grams": { "type": "number" }, "boiler_type": { "type": "string" }, "built_in_grinder_id": { "description": "id of a grinder built into this machine (bean-to-cup / integrated grinder)", "type": "integer" }, "catalog_id": { "description": "Optional — the maintenance catalog model this is (the `id` of a catalog row, e.g. rancilio-silvia), when it was registered from the catalog. Its maintenance then comes from that model's researched record. \"none\" says it is not in the catalog.", "type": "string" }, "connected_device": { "description": "Metadata mapping to smart hardware APIs", "type": "string" }, "control_type": { "enum": [ "volumetric", "manual", "lever" ], "type": "string" }, "hardness_dh": { "description": "Optional — the TOTAL hardness (GH) of the water this machine runs on, in °dH (German degrees; ppm as CaCO3 ÷ 17.85), as a test strip reports it. Picks the band of a maker's hardness table for descaling and filter life", "type": [ "number", "null" ] }, "name": { "description": "Machine name/model, e.g. Dedica EC685", "type": "string" }, "notes": { "type": "string" }, "photo": { "description": "Photo path or URL", "type": "string" }, "prep_style": { "description": "Preparation style. One of: espresso, filter, immersion, percolation. Only \"espresso\" is diagnosed by the dialing engine (G8) — anything else is recorded but never dialed, so do not guess this field.", "type": "string" }, "prep_type": { "description": "Preparation equipment type. One of: espresso_machine, lever_press, moka_pot, aeropress, french_press, v60_dripper, cold_brew. Lower snake_case.", "type": "string" }, "tools": { "description": "JSON or comma-separated tools, e.g., paper filters, flow control, metal mesh", "type": [ "string", "null" ] } }, "required": [ "name", "control_type" ], "type": "object" }, "name": "register_machine", "outputSchema": { "additionalProperties": true, "properties": { "active": { "type": "boolean" }, "machine_id": { "type": "integer" }, "message": { "type": "string" }, "status": { "type": "string" } }, "required": [ "status", "machine_id", "active", "message" ], "type": "object" } }, { "description": "Register a programmed shot button on a machine. A program cuts the shot off either by weight (program_type \"volumetric\", set target_volume_g) or by time (program_type \"timed\", set target_time_s). One machine can have a mix of both. A program_number the machine already has is overwritten with these settings; shots logged on it keep pointing at it.", "inputSchema": { "properties": { "description": { "type": [ "string", "null" ] }, "machine_id": { "type": "integer" }, "program_number": { "description": "Program number / button index (e.g. 1 or 2)", "type": "integer" }, "program_type": { "description": "Cutoff method: \"volumetric\" (weight) or \"timed\" (duration). Defaults to volumetric.", "enum": [ "volumetric", "timed" ], "type": "string" }, "target_time_s": { "description": "Target shot duration cutoff in seconds (required for timed programs)", "type": [ "number", "null" ] }, "target_volume_g": { "description": "Target yield cutoff in grams (required for volumetric programs)", "type": [ "number", "null" ] }, "volume_source": { "description": "Confidence in the stored cutoff value, for either type", "enum": [ "measured", "recalled" ], "type": "string" } }, "required": [ "machine_id", "program_number" ], "type": "object" }, "name": "register_program", "outputSchema": { "additionalProperties": true, "properties": { "message": { "type": "string" }, "program_id": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "status", "program_id", "message" ], "type": "object" } }, { "description": "Register a brewing scale — the instrument that weighs the dose and the yield.", "inputSchema": { "properties": { "auto_tare": { "description": "1 if it zeroes itself when a vessel is set down, 0 if not, null if unstated", "type": [ "integer", "null" ] }, "auto_timer": { "description": "1 if the timer starts on first flow, 0 if not, null if unstated", "type": [ "integer", "null" ] }, "capacity_g": { "description": "Maximum weight in grams. The cup or portafilter counts against it", "type": [ "number", "null" ] }, "connectivity": { "description": "How the scale talks to an app or a machine controller", "enum": [ "none", "bluetooth", "usb", "bluetooth_usb" ], "type": "string" }, "depth_mm": { "description": "Platform depth in mm", "type": [ "number", "null" ] }, "flow_rate_display": { "description": "1 if the scale shows live flow rate in g/s, 0 if it does not, null if the maker never said", "type": [ "integer", "null" ] }, "height_mm": { "description": "Overall height in mm — the dimension that decides whether it fits under a group head", "type": [ "number", "null" ] }, "name": { "description": "Scale name/model, e.g. Acaia Lunar, Timemore Black Mirror Basic 2", "type": "string" }, "notes": { "description": "Additional notes", "type": "string" }, "power": { "description": "How it is powered or recharged", "enum": [ "usb_c", "micro_usb", "aa", "aaa", "mains" ], "type": "string" }, "resolution_banded": { "description": "1 when resolution_g only holds in the lowest weight band and coarsens with load — put the ladder in notes", "type": [ "integer", "null" ] }, "resolution_g": { "description": "Finest published readability in grams. Leave null unless the maker states it", "type": [ "number", "null" ] }, "scale_type": { "description": "What the scale is built for: espresso (drip-tray footprint), brew (pour-over platform), dual (both modes), connected (app/controller integration), dosing (gravimetric dispensing), training, bench (high capacity, coarse)", "enum": [ "espresso", "brew", "dual", "connected", "dosing", "training", "bench" ], "type": "string" }, "water_resistance": { "description": "IEC 60529 ingress code as published, e.g. IPX4, IPX6, IP67, or none", "type": [ "string", "null" ] }, "width_mm": { "description": "Platform width in mm — measure your drip tray", "type": [ "number", "null" ] } }, "required": [ "name", "scale_type" ], "type": "object" }, "name": "register_scale", "outputSchema": { "additionalProperties": true, "properties": { "message": { "type": "string" }, "scale_id": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "status", "scale_id", "message" ], "type": "object" } }, { "description": "Register a custom or commercial water formulation.", "inputSchema": { "properties": { "calcium": { "description": "Calcium concentration in ppm", "type": [ "number", "null" ] }, "gh": { "description": "General hardness (GH) in ppm", "type": [ "number", "null" ] }, "kh": { "description": "Karbonate hardness (KH) in ppm", "type": [ "number", "null" ] }, "magnesium": { "description": "Magnesium concentration in ppm", "type": [ "number", "null" ] }, "name": { "description": "Water formulation name, e.g. Lotus Light & Bright, Third Wave Water", "type": "string" }, "notes": { "description": "Additional notes", "type": "string" }, "sodium": { "description": "Sodium concentration in ppm", "type": [ "number", "null" ] }, "tds": { "description": "TDS in ppm", "type": [ "number", "null" ] }, "type": { "description": "Type, e.g., mineralized, tap, distilled, RO", "type": "string" } }, "required": [ "name" ], "type": "object" }, "name": "register_water", "outputSchema": { "additionalProperties": true, "properties": { "message": { "type": "string" }, "status": { "type": "string" }, "water_id": { "type": "integer" } }, "required": [ "status", "water_id", "message" ], "type": "object" } }, { "description": "Switch the active bean, grinder or machine for this account. The numbers come from list_beans, list_grinders and list_machines. Registering a coffee, grinder or machine makes it active only when nothing of that kind is in use (the `active` field of the reply says which), so call this to start using something new as well as to switch back.", "inputSchema": { "properties": { "bean_id": { "description": "This account's own bean number, as returned by list_beans. Never guess one; null = leave unchanged", "type": [ "integer", "null" ] }, "grinder_id": { "description": "This account's own grinder number, as returned by list_grinders. Never guess one; null = leave unchanged", "type": [ "integer", "null" ] }, "machine_id": { "description": "This account's own machine number, as returned by list_machines. Never guess one; null = leave unchanged", "type": [ "integer", "null" ] }, "program_id": { "description": "A program number from the active machine's list. null = leave unchanged", "type": [ "integer", "null" ] } }, "type": "object" }, "name": "set_active", "outputSchema": { "additionalProperties": true, "properties": { "message": { "type": "string" }, "status": { "type": "string" } }, "required": [ "status", "message" ], "type": "object" } }, { "description": "Archive or restore a grinder, machine, water, or scale.", "inputSchema": { "properties": { "archived": { "description": "1 to archive, 0 to restore", "enum": [ 0, 1 ], "type": "integer" }, "id": { "description": "The ID of the equipment", "type": "integer" }, "kind": { "description": "The kind of equipment to archive/restore", "enum": [ "grinder", "machine", "water", "scale" ], "type": "string" } }, "required": [ "kind", "id", "archived" ], "type": "object" }, "name": "set_equipment_archived", "outputSchema": { "additionalProperties": true, "properties": { "message": { "type": "string" }, "status": { "type": "string" } }, "required": [ "status", "message" ], "type": "object" } }, { "description": "Set the current grinder collar position. source=\"measured\" resets verification freshness. It replaces the stored position; no history of earlier positions is kept.", "inputSchema": { "properties": { "grinder_id": { "type": "integer" }, "setting_label": { "description": "Verbatim display label, e.g. \"1.1.2\"", "type": "string" }, "source": { "description": "Whether setting is verified (\"measured\") or guess (\"recalled\"/\"assumed\")", "enum": [ "measured", "recalled", "assumed" ], "type": "string" } }, "required": [ "grinder_id", "setting_label", "source" ], "type": "object" }, "name": "set_grinder_position", "outputSchema": { "additionalProperties": true, "properties": { "grinder_id": { "type": "integer" }, "message": { "type": "string" }, "position_value": { "type": "integer" }, "setting_label": { "type": "string" }, "source": { "type": "string" }, "status": { "type": "string" } }, "required": [ "status", "grinder_id", "setting_label", "position_value", "source", "message" ], "type": "object" } }, { "description": "Record how far a maintenance job moved the reference, on an entry that opened a calibration epoch. Takes an ENTRY, not a piece of equipment: the offset belongs to the event that caused it, which is what lets several of them compose for a recipe locked before all of them. Zero is a legitimate measurement and means \"measured, and it had not moved\" — omit offset_value entirely to clear it back to unmeasured.", "inputSchema": { "properties": { "entry_id": { "description": "The maintenance entry that opened the epoch, from list_grinders", "type": "integer" }, "evidence": { "description": "One line recording what it rested on, e.g. \"Reference pull 1.38 g/s against 1.74 g/s locked.\"", "type": "string" }, "offset_value": { "description": "Clicks to ADD to a pre-clean reading to get the same grind today, signed along the collar's own number direction. 0 records \"unchanged\"; omit to clear the measurement", "type": "number" }, "source": { "description": "How it was arrived at: pull, counted, or typed", "enum": [ "pull", "counted", "typed" ], "type": "string" } }, "required": [ "entry_id" ], "type": "object" }, "name": "set_maintenance_offset", "outputSchema": { "additionalProperties": true, "properties": { "entry": { "additionalProperties": true, "properties": { "created_at": { "type": "string" }, "details": { "additionalProperties": true, "properties": { "from": { "additionalProperties": true, "properties": { "components_spec": { "type": "string" }, "nominal_step": { "type": "integer" }, "setting_scheme": { "type": "string" } }, "required": [ "setting_scheme", "nominal_step", "components_spec" ], "type": "object" }, "to": { "additionalProperties": true, "properties": { "components_spec": {}, "nominal_step": { "type": "number" }, "setting_scheme": { "type": "string" } }, "required": [ "setting_scheme", "nominal_step", "components_spec" ], "type": "object" } }, "required": [], "type": [ "null", "object" ] }, "details_known": { "type": "boolean" }, "details_version": { "type": "integer" }, "disturbs_zero": { "type": "integer" }, "equipment_id": { "type": "integer" }, "equipment_kind": { "type": "string" }, "evidence": { "type": [ "string", "null" ] }, "guide_id": {}, "id": { "type": "integer" }, "note": { "type": "string" }, "offset_at": { "type": "string" }, "offset_source": { "type": "string" }, "offset_value": { "type": "integer" }, "performed_at": { "type": "string" }, "task": { "type": "string" } }, "required": [ "id", "equipment_kind", "equipment_id", "task", "performed_at", "disturbs_zero", "note", "offset_value", "offset_source", "offset_at", "evidence", "details", "details_version", "created_at", "guide_id", "details_known" ], "type": "object" }, "message": { "type": "string" } }, "required": [ "entry", "message" ], "type": "object" } }, { "description": "Set the user's own schedule for one maintenance task on one grinder or machine: their own interval, switching it off, or muting the reminder until a date. Only the keys you send in fields change; send every: null to go back to the maker's guidance and muted_until: null to unmute. Use it when the user states how often they do a task or asks to be left alone about one — never to invent an interval. The task's class, interval and due state are read back from list_grinders and list_machines.", "inputSchema": { "properties": { "changed_at": { "description": "Optional — when the user made this change (ISO 8601, UTC). An app sending a queued edit passes it, so an older edit never overwrites a newer one; it is then answered with applied: false", "type": "string" }, "equipment_id": { "description": "This account's own grinder or machine number, from list_grinders or list_machines", "type": "integer" }, "equipment_kind": { "description": "Which kind of equipment the task is on", "enum": [ "grinder", "machine" ], "type": "string" }, "fields": { "properties": { "enabled": { "description": "false sets the user's interval aside (the maker's applies again) without forgetting it", "type": "boolean" }, "every": { "description": "The user's interval: whichever basis arrives first makes it due. A grinder counts days, shots and grams; a machine days, shots and litres. null returns to the maker's guidance", "properties": { "days": { "description": "Whole days", "type": [ "number", "null" ] }, "grams": { "description": "Grams of coffee through a grinder", "type": [ "number", "null" ] }, "litres": { "description": "Litres through a machine's group", "type": [ "number", "null" ] }, "shots": { "description": "Whole shots", "type": [ "number", "null" ] } }, "type": [ "object", "null" ] }, "muted_until": { "description": "Silence the reminder until this date or time (ISO 8601, UTC); null unmutes", "type": [ "string", "null" ] } }, "type": "object" }, "task": { "description": "The task, as its value in that equipment's maintenance.tasks", "enum": [ "burr_clean", "backflush_water", "backflush_detergent", "descale", "group_gasket_replace", "shower_screen_clean", "shower_screen_replace", "group_head_wipe", "basket_portafilter_soak", "steam_wand_purge", "steam_wand_soak", "drip_tray_clean", "water_tank_clean", "water_filter_replace", "boiler_water_change", "lever_piston_seal_replace", "lever_lubricate", "milk_system_clean", "professional_service", "builtin_grinder_burr_clean", "builtin_grinder_burr_replace", "grinder_quick_clean", "grinder_cleaning_tablets", "burr_replace", "hopper_clean", "grounds_cup_clean", "bearing_lubricate", "gasket_seal_replace", "idle_rinse", "water_wash", "dishwasher", "filter_prime", "softener_regenerate", "other" ], "type": "string" } }, "required": [ "equipment_kind", "equipment_id", "task" ], "type": "object" }, "name": "set_maintenance_schedule", "outputSchema": { "additionalProperties": true, "properties": { "applied": { "type": "boolean" }, "class": { "type": "string" }, "due": { "additionalProperties": true, "properties": { "basis": { "type": "string" }, "done": { "type": "integer" }, "due_at": { "type": "string" }, "every": { "type": "integer" }, "every_source": { "type": "string" }, "last_at": { "type": "string" }, "lower_bound": { "type": "boolean" }, "muted": { "type": "boolean" }, "muted_until": { "type": [ "null", "string" ] }, "overdue_at": { "type": "string" }, "ratio": { "type": "integer" }, "remaining": { "type": "integer" }, "soon": { "type": "boolean" }, "soon_at": { "type": "string" }, "state": { "type": "string" } }, "required": [], "type": [ "object", "null" ] }, "equipment_id": { "type": "integer" }, "equipment_kind": { "type": "string" }, "every": { "additionalProperties": true, "properties": { "days": { "type": "integer" }, "grams": { "type": "integer" }, "litres": { "type": "number" }, "shots": { "type": "integer" } }, "required": [], "type": [ "object", "null" ] }, "every_source": { "additionalProperties": true, "properties": { "days": { "type": "string" }, "grams": { "type": "string" }, "litres": { "type": "string" }, "shots": { "type": "string" } }, "required": [], "type": [ "object", "null" ] }, "message": { "type": "string" }, "schedule": { "additionalProperties": true, "properties": { "enabled": { "type": "boolean" }, "every": { "additionalProperties": true, "properties": { "days": { "type": "integer" }, "litres": { "type": "number" } }, "required": [], "type": [ "object", "null" ] }, "muted_until": { "type": [ "null", "string" ] } }, "required": [], "type": [ "object", "null" ] }, "task": { "type": "string" } }, "required": [ "equipment_kind", "equipment_id", "task", "schedule", "class", "every", "every_source", "due", "applied", "message" ], "type": "object" } }, { "description": "Retrieve the single next experiment step from the reasoning engine.", "inputSchema": { "properties": { "bean_id": { "type": "integer" } }, "required": [ "bean_id" ], "type": "object" }, "name": "suggest_next_step", "outputSchema": { "additionalProperties": true, "properties": { "category": { "type": "string" }, "next_step": { "type": "string" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "next_step", "category", "warnings" ], "type": "object" } }, { "description": "Change bag-level facts on one bag of a coffee: open, seal, freeze, thaw or finish it, correct its roast date, weight, grams left or price. Bag numbers come from the bags[] on list_beans (or current_bag_id). For the coffee itself — roaster, origin, roast level, rest window, notes — use update_bean.", "inputSchema": { "properties": { "bag_id": { "description": "This account's own bag number, from list_beans' bags[]. Never guess one.", "type": "integer" }, "fields": { "properties": { "bag_notes": { "maxLength": 4096, "type": "string" }, "bag_weight_g": { "description": "Bag weight in grams", "type": "number" }, "best_by_date": { "description": "Calendar day in YYYY-MM-DD format — a day, not a timestamp", "type": "string" }, "buy_date": { "description": "Calendar day in YYYY-MM-DD format — a day, not a timestamp", "type": "string" }, "cost": { "type": "number" }, "currency": { "type": "string" }, "ean": { "type": "string" }, "finished": { "description": "1 if finished, 0 otherwise", "type": "integer" }, "frozen_at": { "description": "Calendar day the bag went into the freezer, YYYY-MM-DD — a day, not a timestamp", "type": "string" }, "frozen_note": { "type": "string" }, "frozen_storage": { "type": "string" }, "grams_remaining": { "description": "Override the computed grams left in the bag (weigh the bag, set what is actually there). Translated into weight_adjustment_g so bag_weight_g keeps recording the true bag size. 0 marks the bag finished; a positive value on a finished bag un-finishes it.", "type": "number" }, "opened_date": { "description": "Calendar day in YYYY-MM-DD format — a day, not a timestamp", "type": "string" }, "qr_code": { "type": "string" }, "roast_date": { "description": "Calendar day in YYYY-MM-DD format — a day, not a timestamp", "type": "string" }, "state": { "enum": [ "sealed", "open", "frozen", "finished" ], "type": "string" }, "storage": { "type": "string" }, "unfrozen_at": { "description": "Calendar day the bag came out, YYYY-MM-DD — a day, not a timestamp", "type": "string" }, "weight_adjustment_g": { "description": "Grams consumed or lost OUTSIDE logged shots (spillage, unlogged brews). grams_remaining = bag_weight_g − logged doses − this. Negative adds weight back.", "type": "number" } }, "type": "object" }, "reason": { "description": "Optional free-text note, appended to this bag's notes as an ordinary line. Omit it and nothing is written.", "type": "string" } }, "required": [ "bag_id", "fields" ], "type": "object" }, "name": "update_bag", "outputSchema": { "additionalProperties": true, "properties": { "message": { "type": "string" }, "status": { "type": "string" } }, "required": [ "status", "message" ], "type": "object" } }, { "description": "Update a coffee's own fields (roaster, origins, roast level, rest window, notes, rating…). Bag-shaped fields sent here (state, roast_date, bag_weight_g, grams_remaining, cost…) land on the coffee's CURRENT bag — use update_bag when it has more than one. Changing dial_category changes what the engine advises (G5, C10), so say why in the optional note.", "inputSchema": { "properties": { "bean_id": { "type": "integer" }, "fields": { "properties": { "acidity": { "description": "Free text; roasters usually say low, medium or high", "type": "string" }, "arabica_pct": { "maximum": 100, "minimum": 0, "type": "number" }, "archived": { "description": "1 if archived, 0 otherwise", "type": "integer" }, "aromatics": { "maxLength": 1024, "type": "string" }, "attachments": { "description": "JSON or comma-separated list of attachments", "maxLength": 1024, "type": "string" }, "bag_notes": { "maxLength": 4096, "type": "string" }, "bag_weight_g": { "description": "Bag weight in grams", "type": "number" }, "bean_mix": { "description": "E.g. blend details", "type": "string" }, "best_by_date": { "description": "Calendar day in YYYY-MM-DD format — a day, not a timestamp", "type": "string" }, "body": { "description": "Free text; roasters usually say low, medium or high", "type": "string" }, "buy_date": { "description": "Calendar day in YYYY-MM-DD format — a day, not a timestamp", "type": "string" }, "co2e_kg": { "type": "number" }, "cost": { "type": "number" }, "cupping_points": { "type": "number" }, "currency": { "type": "string" }, "decaffeinated": { "description": "1 if decaf, 0 if regular", "type": "integer" }, "dial_category": { "description": "Dialing behavior class: classic = medium/traditional espresso roasts (chocolate/nut, balanced); dark = genuinely dark/roasty; the light categories cover Nordic and ultra-light styles.", "enum": [ "nordic-light", "ultra-light", "classic", "processed", "dark", "aged" ], "type": "string" }, "ean": { "type": "string" }, "favourite": { "description": "1 if favourite, 0 otherwise", "type": "integer" }, "finished": { "description": "1 if finished, 0 otherwise", "type": "integer" }, "frozen_at": { "description": "Calendar day the bag went into the freezer, YYYY-MM-DD — a day, not a timestamp", "type": "string" }, "frozen_note": { "type": "string" }, "frozen_storage": { "type": "string" }, "grams_remaining": { "description": "Override the computed grams left in the bag (weigh the bag, set what is actually there). Translated into weight_adjustment_g so bag_weight_g keeps recording the true bag size. 0 marks the bag finished; a positive value on a finished bag un-finishes it.", "type": "number" }, "name": { "type": "string" }, "notes": { "description": "The coffee's own description — roaster tasting notes, the dialing approach. Replaces the stored value; the optional reason is appended instead.", "maxLength": 4096, "type": "string" }, "opened_date": { "description": "Calendar day in YYYY-MM-DD format — a day, not a timestamp", "type": "string" }, "origin": { "type": "string" }, "origins": { "description": "List of bean origin details", "items": { "properties": { "country": { "type": "string" }, "elevation_m": { "type": "number" }, "elevation_max_m": { "description": "Upper end of an elevation range; elevation_m is the lower end", "type": "number" }, "farm": { "type": "string" }, "farmer": { "type": "string" }, "harvest": { "type": "string" }, "percentage": { "type": "number" }, "processing": { "type": "string" }, "region": { "type": "string" }, "variety": { "type": "string" } }, "type": "object" }, "type": "array" }, "process_type": { "enum": [ "washed", "natural", "honey", "anaerobic", "aerobic-extended", "co-fermented", "bioreactor", "other" ], "type": "string" }, "qr_code": { "type": "string" }, "rating": { "description": "1-5 stars; 0 clears the rating (unrated)", "maximum": 5, "minimum": 0, "type": "integer" }, "rest_window_days_max": { "type": "integer" }, "rest_window_days_min": { "type": "integer" }, "roast_custom": { "type": "string" }, "roast_date": { "description": "Calendar day in YYYY-MM-DD format — a day, not a timestamp", "type": "string" }, "roast_level": { "enum": [ "ultra-light", "light", "medium", "medium-dark", "dark" ], "type": "string" }, "roast_range": { "type": "string" }, "roaster": { "type": "string" }, "roasting_type": { "enum": [ "filter", "espresso", "omni" ], "type": "string" }, "state": { "enum": [ "sealed", "open", "frozen", "finished" ], "type": "string" }, "storage": { "type": "string" }, "sweetness": { "description": "Free text; roasters usually say low, medium or high", "type": "string" }, "unfrozen_at": { "description": "Calendar day the bag came out, YYYY-MM-DD — a day, not a timestamp", "type": "string" }, "url": { "type": "string" }, "variety": { "type": "string" }, "weight_adjustment_g": { "description": "Grams consumed or lost OUTSIDE logged shots (spillage, unlogged brews). grams_remaining = bag_weight_g − logged doses − this. To force remaining to a known value X, set this to bag_weight_g − logged doses − X. Negative adds weight back.", "type": "number" } }, "type": "object" }, "reason": { "description": "Optional free-text note, appended as an ordinary line to the coffee's notes — or to the current bag's bag_notes when the call changed only bag fields. Omit it and nothing is written.", "type": "string" } }, "required": [ "bean_id", "fields" ], "type": "object" }, "name": "update_bean", "outputSchema": { "additionalProperties": true, "properties": { "message": { "type": "string" }, "status": { "type": "string" } }, "required": [ "status", "message" ], "type": "object" } }, { "description": "Correct a registered grinder — its name, burrs, collar scheme, nominal step, layout, range or notes. Only the keys you send in fields change; send null to clear an optional field (an empty string also clears a text field, but not a number or a closed list). Required fields can be changed but not cleared. fields may be omitted when only reason is sent. setting_scheme, nominal_step and components_spec describe the collar every recorded grind label is read through: call with dry_run first to see which recorded settings would read as a different position, and tell the user before saving. Saving records the change in the grinder's maintenance history; when a locked recipe's setting moves it also opens an unmeasured calibration epoch (set_maintenance_offset resolves it). The collar's current setting is marked assumed when it reads differently, or cleared when the new collar cannot read it, and measured offsets are converted when a click changes worth. Changing direction_convention is a correction — it moves no number, but every finer/coarser said about this grinder was the wrong way round.", "inputSchema": { "properties": { "dry_run": { "description": "true: write nothing, and answer with what the edit would do to the settings already recorded (moved[], checked, epoch, position_moved, position_cleared, rescaled_offsets, resigned_offsets, step_ignored, direction_flipped, recipe_count)", "type": "boolean" }, "fields": { "properties": { "burr_type": { "enum": [ "conical", "flat" ], "type": "string" }, "catalog_id": { "description": "The maintenance catalog model this grinder is; \"none\" if it is not listed; null to unbind. list_grinders proposes one from the name under maintenance.catalog.match", "type": [ "string", "null" ] }, "components_spec": { "description": "JSON array of {name, per_step}, coarsest first — the ring arithmetic of a compound collar, or the ordered settings of a named one", "maxLength": 4096, "type": [ "string", "null" ] }, "direction_convention": { "enum": [ "lower_is_finer", "higher_is_finer" ], "type": "string" }, "max_value": { "type": [ "number", "null" ] }, "microns_per_step": { "type": [ "number", "null" ] }, "min_value": { "type": [ "number", "null" ] }, "motor_type": { "enum": [ "manual", "electric" ], "type": "string" }, "name": { "type": "string" }, "nominal_step": { "description": "Smallest adjustment increment. On a numeric_stepless collar it is the precision labels are recorded in (0.1 records tenths) and the size of one click. numeric_stepped and clicks_single collars record whole steps whatever it says — to record tenths, set setting_scheme numeric_stepless as well", "type": "number" }, "notes": { "type": [ "string", "null" ] }, "photo": { "type": [ "string", "null" ] }, "setting_scheme": { "enum": [ "numeric_stepless", "numeric_stepped", "clicks_single", "compound", "named" ], "type": "string" } }, "type": "object" }, "grinder_id": { "description": "This account's own grinder number, from list_grinders. Never guess one.", "type": "integer" }, "reason": { "description": "Optional note, appended to this record's own notes as an ordinary line. Omit it and nothing is written.", "type": "string" } }, "required": [ "grinder_id" ], "type": "object" }, "name": "update_grinder", "outputSchema": { "additionalProperties": true, "properties": { "changed_keys": { "items": { "type": "string" }, "type": "array" }, "checked": { "type": [ "integer", "null" ] }, "direction_flipped": { "type": "boolean" }, "dry_run": { "type": "boolean" }, "entry_id": { "type": [ "null", "integer" ] }, "epoch": { "type": "boolean" }, "grinder_id": { "type": "integer" }, "message": { "type": "string" }, "moved": { "items": { "additionalProperties": true, "properties": { "becomes": { "type": "string" }, "becomes_same": { "type": "boolean" }, "count": { "type": "integer" }, "label": { "type": "string" }, "unreadable_after": { "type": "boolean" }, "where": { "type": "string" } }, "required": [ "label", "becomes", "becomes_same", "unreadable_after", "where", "count" ], "type": "object" }, "type": "array" }, "moved_count": { "type": [ "integer", "null" ] }, "position_cleared": { "type": "boolean" }, "position_moved": { "type": "boolean" }, "reads_changed": { "type": "boolean" }, "recipe_count": { "type": [ "integer", "null" ] }, "rescaled_offsets": { "type": "integer" }, "resigned_offsets": { "type": "integer" }, "status": { "type": "string" }, "step_ignored": { "type": "boolean" }, "unreadable": { "type": [ "integer", "null" ] }, "untranslatable": { "type": [ "integer", "null" ] }, "untranslatable_recipes": { "type": [ "integer", "null" ] } }, "required": [ "grinder_id", "changed_keys", "reads_changed", "checked", "moved_count", "moved", "untranslatable", "untranslatable_recipes", "unreadable", "epoch", "position_moved", "position_cleared", "rescaled_offsets", "resigned_offsets", "step_ignored", "direction_flipped", "recipe_count", "status", "dry_run", "entry_id", "message" ], "type": "object" } }, { "description": "Correct a registered machine — its name, control type, prep type and style, basket, boiler, accessories or notes — or record where its selectors stand (settings). Only the keys you send in fields change; send null to clear an optional field (an empty string also clears a text field, but not a number or a closed list). Required fields can be changed but not cleared. fields may be omitted when only reason is sent. prep_style decides whether shots on this machine are diagnosed at all: only \"espresso\" is. Programs are edited with register_program, the built-in grinder link is not editable here, and archiving is set_equipment_archived.", "inputSchema": { "properties": { "fields": { "properties": { "basket_size_grams": { "type": [ "number", "null" ] }, "boiler_type": { "type": [ "string", "null" ] }, "catalog_id": { "description": "The maintenance catalog model this machine is; \"none\" if it is not listed; null to unbind. list_machines proposes one from the name under maintenance.catalog.match", "type": [ "string", "null" ] }, "connected_device": { "type": [ "string", "null" ] }, "control_type": { "enum": [ "volumetric", "manual", "lever" ], "type": "string" }, "hardness_dh": { "description": "The total hardness (GH) of the water this machine runs on, in °dH; null to fall back to the water of its last shot", "type": [ "number", "null" ] }, "name": { "type": "string" }, "notes": { "type": [ "string", "null" ] }, "photo": { "type": [ "string", "null" ] }, "prep_style": { "description": "One of: espresso, filter, immersion, percolation. Only \"espresso\" is diagnosed by the dialing engine (G8).", "type": "string" }, "prep_type": { "description": "One of: espresso_machine, lever_press, moka_pot, aeropress, french_press, v60_dripper, cold_brew.", "type": "string" }, "settings": { "description": "Where the machine's selectors now stand, as {key: position} from list_machines settings, e.g. {\"brew_temperature\": \"ii\"}. Only the keys given change; a null position clears one, null clears all. Shots are stamped with these.", "type": [ "object", "null" ] }, "tools": { "description": "Comma-separated accessories. list_machines reads them back as tools_list", "type": [ "string", "null" ] } }, "type": "object" }, "machine_id": { "description": "This account's own machine number, from list_machines. Never guess one.", "type": "integer" }, "reason": { "description": "Optional note, appended to this record's own notes as an ordinary line. Omit it and nothing is written.", "type": "string" } }, "required": [ "machine_id" ], "type": "object" }, "name": "update_machine", "outputSchema": { "additionalProperties": true, "properties": { "changed_keys": { "items": { "type": "string" }, "type": "array" }, "machine_id": { "type": "integer" }, "message": { "type": "string" }, "status": { "type": "string" } }, "required": [ "status", "machine_id", "changed_keys", "message" ], "type": "object" } }, { "description": "Correct a registered scale — its type, resolution, capacity, capabilities, build or notes. Only the keys you send in fields change; send null to clear an optional field (an empty string also clears a text field, but not a number or a closed list). Required fields can be changed but not cleared. fields may be omitted when only reason is sent. The three capabilities are 1, 0, or null for \"the maker never said\"; leave one out rather than sending 0 when nobody knows.", "inputSchema": { "properties": { "fields": { "properties": { "auto_tare": { "type": [ "integer", "null" ] }, "auto_timer": { "type": [ "integer", "null" ] }, "capacity_g": { "type": [ "number", "null" ] }, "connectivity": { "enum": [ "none", "bluetooth", "usb", "bluetooth_usb", null ], "type": [ "string", "null" ] }, "depth_mm": { "type": [ "number", "null" ] }, "flow_rate_display": { "type": [ "integer", "null" ] }, "height_mm": { "type": [ "number", "null" ] }, "name": { "type": "string" }, "notes": { "type": [ "string", "null" ] }, "power": { "enum": [ "usb_c", "micro_usb", "aa", "aaa", "mains", null ], "type": [ "string", "null" ] }, "resolution_banded": { "description": "1 when resolution_g only holds in the lowest weight band", "type": [ "integer", "null" ] }, "resolution_g": { "type": [ "number", "null" ] }, "scale_type": { "enum": [ "espresso", "brew", "dual", "connected", "dosing", "training", "bench" ], "type": "string" }, "water_resistance": { "type": [ "string", "null" ] }, "width_mm": { "type": [ "number", "null" ] } }, "type": "object" }, "reason": { "description": "Optional note, appended to this record's own notes as an ordinary line. Omit it and nothing is written.", "type": "string" }, "scale_id": { "description": "This account's own scale number, from list_scales. Never guess one.", "type": "integer" } }, "required": [ "scale_id" ], "type": "object" }, "name": "update_scale", "outputSchema": { "additionalProperties": true, "properties": { "changed_keys": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "scale_id": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "status", "scale_id", "changed_keys", "message" ], "type": "object" } }, { "description": "Correct fields on an already-logged shot in place — no need to delete and re-log. Use for fixing a wrong dose/yield/time or grind label, re-filing a shot onto the right bean (bean_id), backfilling rating/tasting notes, or fixing the timestamp (pulled_at). Changing grind_label re-derives the numeric grind position from the shot's grinder; changing yield/time/dose/tds keeps flow rate and extraction yield consistent automatically.", "inputSchema": { "properties": { "fields": { "description": "Only the fields to change", "properties": { "bag_id": { "description": "Re-file the shot onto this bag; must be a bag of the shot's bean", "type": "integer" }, "bean_id": { "description": "Re-file the shot onto this bean (its current bag, unless bag_id is also given)", "type": "integer" }, "best_brew": { "enum": [ 0, 1 ], "type": "integer" }, "beverage_g": { "type": "number" }, "data_confidence": { "description": "estimated marks the metrics as a best guess instead of burying the caveat in notes", "enum": [ "measured", "recalled", "estimated" ], "type": "string" }, "dose_g": { "type": "number" }, "drink_intent": { "enum": [ "straight", "milk" ], "type": "string" }, "favourite": { "enum": [ 0, 1 ], "type": "integer" }, "finish_action": { "enum": [ "hard_stop", "passive_drip" ], "type": "string" }, "flavor_notes": { "description": "null clears the notes", "maxLength": 4096, "type": [ "string", "null" ] }, "grind_label": { "description": "Corrected grind setting label; numeric position is re-derived", "type": "string" }, "grinder_id": { "type": "integer" }, "machine_id": { "type": "integer" }, "machine_settings": { "description": "The machine's selector positions for this shot, {key: position}; replaces what was stamped, null clears it", "maxProperties": 16, "type": [ "object", "null" ] }, "observations": { "maxProperties": 64, "type": "object" }, "program_id": { "type": "integer" }, "pulled_at": { "description": "Corrected timestamp (ISO 8601 or \"YYYY-MM-DD HH:MM:SS\")", "type": "string" }, "rating": { "description": "1-5; null clears the rating", "maximum": 5, "minimum": 1, "type": [ "integer", "null" ] }, "sensory_tags": { "items": { "maxLength": 128, "type": "string" }, "maxItems": 64, "type": "array" }, "tasted": { "description": "Backfill 1 to mark a pending shot as tasted-clean (tasted, no defect tags) so it leaves the taste-pending queue without inventing a tag or rating", "enum": [ 0, 1 ], "type": "integer" }, "tds": { "type": "number" }, "temp_taste": { "enum": [ "hot", "warm", "cold" ], "type": "string" }, "temperature_c": { "type": "number" }, "time_s": { "type": "number" }, "verdict": { "description": "null clears the verdict", "type": [ "string", "null" ] }, "vessel_name": { "type": "string" }, "vessel_weight_g": { "type": "number" }, "water_id": { "type": "integer" }, "yield_g": { "type": "number" } }, "type": "object" }, "shot_id": { "description": "ID of the shot to correct", "type": "integer" } }, "required": [ "shot_id", "fields" ], "type": "object" }, "name": "update_shot", "outputSchema": { "additionalProperties": true, "properties": { "message": { "type": "string" }, "shot_id": { "type": "integer" }, "status": { "type": "string" }, "updated_fields": { "items": { "type": "string" }, "type": "array" } }, "required": [ "status", "shot_id", "updated_fields", "message" ], "type": "object" } }, { "description": "Correct a registered water — its name, type, mineral figures or notes. Only the keys you send in fields change; send null to clear an optional field (an empty string also clears a text field, but not a number or a closed list). Required fields can be changed but not cleared. fields may be omitted when only reason is sent.", "inputSchema": { "properties": { "fields": { "properties": { "calcium": { "type": [ "number", "null" ] }, "gh": { "type": [ "number", "null" ] }, "kh": { "type": [ "number", "null" ] }, "magnesium": { "type": [ "number", "null" ] }, "name": { "type": "string" }, "notes": { "type": [ "string", "null" ] }, "sodium": { "type": [ "number", "null" ] }, "tds": { "type": [ "number", "null" ] }, "type": { "type": [ "string", "null" ] } }, "type": "object" }, "reason": { "description": "Optional note, appended to this record's own notes as an ordinary line. Omit it and nothing is written.", "type": "string" }, "water_id": { "description": "This account's own water number, from list_waters. Never guess one.", "type": "integer" } }, "required": [ "water_id" ], "type": "object" }, "name": "update_water", "outputSchema": { "additionalProperties": true, "properties": { "changed_keys": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "status": { "type": "string" }, "water_id": { "type": "integer" } }, "required": [ "status", "water_id", "changed_keys", "message" ], "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:100d93165ba2c6c166645b1858907406b8548f88376c9481dc50377f97c46cf1 | sha256sum