{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "mcp.shotpulled.com",
    "site": "shotpulled.com",
    "addresses": [
      {
        "address": "172.67.146.222",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "172.67.144.0/20",
          "country": "US"
        }
      },
      {
        "address": "104.21.57.153",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.21.48.0/20",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3035::6815:3999",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3035::/48",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3036::ac43:92de",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3036::/48",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "172.67.146.222",
          "104.21.57.153",
          "2606:4700:3035::6815:3999",
          "2606:4700:3036::ac43:92de"
        ],
        "first_seen": "2026-11-22T16:24:03.320Z",
        "last_seen": "2026-11-22T16:24:03.320Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "shotpulled",
      "version": "1.4.2",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "cloudflare",
      "strict-transport-security": "max-age=31536000; includeSubDomains; preload"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 0,
      "sample": []
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "com.shotpulled",
      "total": 0,
      "sample": []
    },
    "same_repository": null,
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "15852",
    "server_name": "com.shotpulled/shotpulled",
    "url": "https://mcp.shotpulled.com/mcp",
    "host": "mcp.shotpulled.com",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T16:24:03.320Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "96628d8d9863f1f7217d26f0ec4b336818704b686f4643fb988b30993696f67a",
    "first_listed_at": "2026-11-21T10:57:02.254Z",
    "created_at": "2026-11-21T06:45:04.775Z",
    "resolved_addresses": [
      "172.67.146.222",
      "104.21.57.153",
      "2606:4700:3035::6815:3999",
      "2606:4700:3036::ac43:92de"
    ]
  },
  "server": {
    "name": "com.shotpulled/shotpulled",
    "title": "ShotPulled",
    "description": "Espresso dialing: log a shot, say how it tasted, get one change in your grinder's own clicks.",
    "version": "1.4.2",
    "registry_status": "active",
    "repository_url": null,
    "website_url": "https://shotpulled.com",
    "published_at": "2026-10-26T11:42:43.407Z",
    "updated_at": "2026-10-26T11:42:43.407Z",
    "first_seen": "2026-11-21T06:45:03.753Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T16:24:11.603Z"
  },
  "operator": null,
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 2,
    "answered": 2,
    "answered_percent": 100,
    "avg_listing_latency_ms": 243,
    "first_check_in_window": "2026-11-21T10:57:02.254Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      },
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "96628d8d9863f1f7217d26f0ec4b336818704b686f4643fb988b30993696f67a",
    "tools": 44,
    "resources": 2,
    "prompts": 3,
    "first_seen": "2026-11-22T16:24:03.549Z",
    "tool_names": [
      "register_grinder",
      "set_grinder_position",
      "register_machine",
      "set_equipment_archived",
      "update_grinder",
      "update_machine",
      "update_scale",
      "update_water",
      "log_maintenance",
      "set_maintenance_offset",
      "set_maintenance_schedule",
      "get_maintenance_guides",
      "list_maintenance_due",
      "register_water",
      "list_waters",
      "register_scale",
      "list_scales",
      "register_program",
      "register_coffee",
      "set_active",
      "update_bean",
      "get_dial_state",
      "log_shot",
      "lock_recipe",
      "delete_shot",
      "update_shot",
      "list_recipes",
      "get_stats",
      "list_grinders",
      "list_machines",
      "list_beans",
      "grinder_math",
      "compute_age",
      "diagnose_shot",
      "suggest_next_step",
      "log_recommendation",
      "get_rule",
      "get_kb_version",
      "kb_changelog",
      "diagnose_preview",
      "list_shots",
      "register_bag",
      "update_bag",
      "merge_beans"
    ],
    "declared": {
      "tools": [
        {
          "name": "register_grinder",
          "title": "Register a grinder",
          "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": {
            "type": "object",
            "required": [
              "name",
              "motor_type",
              "burr_type",
              "setting_scheme",
              "direction_convention",
              "nominal_step"
            ],
            "properties": {
              "name": {
                "type": "string",
                "description": "The name/model of the grinder, e.g. Kinu M47"
              },
              "notes": {
                "type": "string",
                "description": "Additional notes"
              },
              "photo": {
                "type": "string",
                "description": "Photo path or URL"
              },
              "archived": {
                "type": "integer",
                "description": "1 if archived, 0 if active"
              },
              "burr_type": {
                "enum": [
                  "conical",
                  "flat"
                ],
                "type": "string"
              },
              "max_value": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Optional travel max bounds"
              },
              "min_value": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Optional travel min bounds"
              },
              "catalog_id": {
                "type": "string",
                "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."
              },
              "motor_type": {
                "enum": [
                  "manual",
                  "electric"
                ],
                "type": "string"
              },
              "nominal_step": {
                "type": "number",
                "description": "Smallest adjustment increment (e.g. 1 click or 0.1collar units)"
              },
              "setting_scheme": {
                "enum": [
                  "numeric_stepless",
                  "numeric_stepped",
                  "clicks_single",
                  "compound",
                  "named"
                ],
                "type": "string",
                "description": "Collar mark style: single clicks or compound (rotation.number.clicks)"
              },
              "components_spec": {
                "type": "string",
                "maxLength": 4096,
                "description": "JSON mapping string representing compound adjustment math"
              },
              "microns_per_step": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Optional mechanical burr travel microns per nominal step"
              },
              "direction_convention": {
                "enum": [
                  "lower_is_finer",
                  "higher_is_finer"
                ],
                "type": "string"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "grinder_id",
              "active",
              "message"
            ],
            "properties": {
              "active": {
                "type": "boolean"
              },
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "grinder_id": {
                "type": "integer"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "set_grinder_position",
          "title": "Set grinder position",
          "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": {
            "type": "object",
            "required": [
              "grinder_id",
              "setting_label",
              "source"
            ],
            "properties": {
              "source": {
                "enum": [
                  "measured",
                  "recalled",
                  "assumed"
                ],
                "type": "string",
                "description": "Whether setting is verified (\"measured\") or guess (\"recalled\"/\"assumed\")"
              },
              "grinder_id": {
                "type": "integer"
              },
              "setting_label": {
                "type": "string",
                "description": "Verbatim display label, e.g. \"1.1.2\""
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "grinder_id",
              "setting_label",
              "position_value",
              "source",
              "message"
            ],
            "properties": {
              "source": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "grinder_id": {
                "type": "integer"
              },
              "setting_label": {
                "type": "string"
              },
              "position_value": {
                "type": "integer"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "register_machine",
          "title": "Register an espresso machine",
          "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": {
            "type": "object",
            "required": [
              "name",
              "control_type"
            ],
            "properties": {
              "name": {
                "type": "string",
                "description": "Machine name/model, e.g. Dedica EC685"
              },
              "notes": {
                "type": "string"
              },
              "photo": {
                "type": "string",
                "description": "Photo path or URL"
              },
              "tools": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "JSON or comma-separated tools, e.g., paper filters, flow control, metal mesh"
              },
              "archived": {
                "type": "integer",
                "description": "1 if archived, 0 if active"
              },
              "prep_type": {
                "type": "string",
                "description": "Preparation equipment type. One of: espresso_machine, lever_press, moka_pot, aeropress, french_press, v60_dripper, cold_brew. Lower snake_case."
              },
              "catalog_id": {
                "type": "string",
                "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."
              },
              "prep_style": {
                "type": "string",
                "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."
              },
              "boiler_type": {
                "type": "string"
              },
              "hardness_dh": {
                "type": [
                  "number",
                  "null"
                ],
                "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"
              },
              "control_type": {
                "enum": [
                  "volumetric",
                  "manual",
                  "lever"
                ],
                "type": "string"
              },
              "connected_device": {
                "type": "string",
                "description": "Metadata mapping to smart hardware APIs"
              },
              "basket_size_grams": {
                "type": "number"
              },
              "built_in_grinder_id": {
                "type": "integer",
                "description": "id of a grinder built into this machine (bean-to-cup / integrated grinder)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "machine_id",
              "active",
              "message"
            ],
            "properties": {
              "active": {
                "type": "boolean"
              },
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "machine_id": {
                "type": "integer"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "set_equipment_archived",
          "title": "Archive or restore equipment",
          "description": "Archive or restore a grinder, machine, water, or scale.",
          "inputSchema": {
            "type": "object",
            "required": [
              "kind",
              "id",
              "archived"
            ],
            "properties": {
              "id": {
                "type": "integer",
                "description": "The ID of the equipment"
              },
              "kind": {
                "enum": [
                  "grinder",
                  "machine",
                  "water",
                  "scale"
                ],
                "type": "string",
                "description": "The kind of equipment to archive/restore"
              },
              "archived": {
                "enum": [
                  0,
                  1
                ],
                "type": "integer",
                "description": "1 to archive, 0 to restore"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "message"
            ],
            "properties": {
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "update_grinder",
          "title": "Update a grinder",
          "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": {
            "type": "object",
            "required": [
              "grinder_id"
            ],
            "properties": {
              "fields": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "notes": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "photo": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "burr_type": {
                    "enum": [
                      "conical",
                      "flat"
                    ],
                    "type": "string"
                  },
                  "max_value": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "min_value": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "catalog_id": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "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"
                  },
                  "motor_type": {
                    "enum": [
                      "manual",
                      "electric"
                    ],
                    "type": "string"
                  },
                  "nominal_step": {
                    "type": "number",
                    "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"
                  },
                  "setting_scheme": {
                    "enum": [
                      "numeric_stepless",
                      "numeric_stepped",
                      "clicks_single",
                      "compound",
                      "named"
                    ],
                    "type": "string"
                  },
                  "components_spec": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 4096,
                    "description": "JSON array of {name, per_step}, coarsest first: the ring arithmetic of a compound collar, or the ordered settings of a named one"
                  },
                  "microns_per_step": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "direction_convention": {
                    "enum": [
                      "lower_is_finer",
                      "higher_is_finer"
                    ],
                    "type": "string"
                  }
                }
              },
              "reason": {
                "type": "string",
                "description": "Optional note, appended to this record's own notes as an ordinary line. Omit it and nothing is written."
              },
              "dry_run": {
                "type": "boolean",
                "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)"
              },
              "grinder_id": {
                "type": "integer",
                "description": "This account's own grinder number, from list_grinders. Never guess one."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "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"
            ],
            "properties": {
              "epoch": {
                "type": "boolean"
              },
              "moved": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "label",
                    "becomes",
                    "becomes_same",
                    "unreadable_after",
                    "where",
                    "count"
                  ],
                  "properties": {
                    "count": {
                      "type": "integer"
                    },
                    "label": {
                      "type": "string"
                    },
                    "where": {
                      "type": "string"
                    },
                    "becomes": {
                      "type": "string"
                    },
                    "becomes_same": {
                      "type": "boolean"
                    },
                    "unreadable_after": {
                      "type": "boolean"
                    }
                  },
                  "additionalProperties": true
                }
              },
              "status": {
                "type": "string"
              },
              "checked": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "dry_run": {
                "type": "boolean"
              },
              "message": {
                "type": "string"
              },
              "entry_id": {
                "type": [
                  "null",
                  "integer"
                ]
              },
              "grinder_id": {
                "type": "integer"
              },
              "unreadable": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "moved_count": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "changed_keys": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "recipe_count": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "step_ignored": {
                "type": "boolean"
              },
              "reads_changed": {
                "type": "boolean"
              },
              "position_moved": {
                "type": "boolean"
              },
              "untranslatable": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "position_cleared": {
                "type": "boolean"
              },
              "rescaled_offsets": {
                "type": "integer"
              },
              "resigned_offsets": {
                "type": "integer"
              },
              "direction_flipped": {
                "type": "boolean"
              },
              "untranslatable_recipes": {
                "type": [
                  "integer",
                  "null"
                ]
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "update_machine",
          "title": "Update a machine",
          "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": {
            "type": "object",
            "required": [
              "machine_id"
            ],
            "properties": {
              "fields": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "notes": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "photo": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "tools": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Comma-separated accessories. list_machines reads them back as tools_list"
                  },
                  "settings": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "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."
                  },
                  "prep_type": {
                    "type": "string",
                    "description": "One of: espresso_machine, lever_press, moka_pot, aeropress, french_press, v60_dripper, cold_brew."
                  },
                  "catalog_id": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "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"
                  },
                  "prep_style": {
                    "type": "string",
                    "description": "One of: espresso, filter, immersion, percolation. Only \"espresso\" is diagnosed by the dialing engine (G8)."
                  },
                  "boiler_type": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "hardness_dh": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "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"
                  },
                  "control_type": {
                    "enum": [
                      "volumetric",
                      "manual",
                      "lever"
                    ],
                    "type": "string"
                  },
                  "connected_device": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "basket_size_grams": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                }
              },
              "reason": {
                "type": "string",
                "description": "Optional note, appended to this record's own notes as an ordinary line. Omit it and nothing is written."
              },
              "machine_id": {
                "type": "integer",
                "description": "This account's own machine number, from list_machines. Never guess one."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "machine_id",
              "changed_keys",
              "message"
            ],
            "properties": {
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "machine_id": {
                "type": "integer"
              },
              "changed_keys": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "update_scale",
          "title": "Update a scale",
          "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": {
            "type": "object",
            "required": [
              "scale_id"
            ],
            "properties": {
              "fields": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "notes": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "power": {
                    "enum": [
                      "usb_c",
                      "micro_usb",
                      "aa",
                      "aaa",
                      "mains",
                      null
                    ],
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "depth_mm": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "width_mm": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "auto_tare": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "height_mm": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "auto_timer": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "capacity_g": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "scale_type": {
                    "enum": [
                      "espresso",
                      "brew",
                      "dual",
                      "connected",
                      "dosing",
                      "training",
                      "bench"
                    ],
                    "type": "string"
                  },
                  "connectivity": {
                    "enum": [
                      "none",
                      "bluetooth",
                      "usb",
                      "bluetooth_usb",
                      null
                    ],
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "resolution_g": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "water_resistance": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "flow_rate_display": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "resolution_banded": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "description": "1 when resolution_g only holds in the lowest weight band"
                  }
                }
              },
              "reason": {
                "type": "string",
                "description": "Optional note, appended to this record's own notes as an ordinary line. Omit it and nothing is written."
              },
              "scale_id": {
                "type": "integer",
                "description": "This account's own scale number, from list_scales. Never guess one."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "scale_id",
              "changed_keys",
              "message"
            ],
            "properties": {
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "scale_id": {
                "type": "integer"
              },
              "changed_keys": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "update_water",
          "title": "Update a water recipe",
          "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": {
            "type": "object",
            "required": [
              "water_id"
            ],
            "properties": {
              "fields": {
                "type": "object",
                "properties": {
                  "gh": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "kh": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "tds": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "name": {
                    "type": "string"
                  },
                  "type": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "notes": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "sodium": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "calcium": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "magnesium": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                }
              },
              "reason": {
                "type": "string",
                "description": "Optional note, appended to this record's own notes as an ordinary line. Omit it and nothing is written."
              },
              "water_id": {
                "type": "integer",
                "description": "This account's own water number, from list_waters. Never guess one."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "water_id",
              "changed_keys",
              "message"
            ],
            "properties": {
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "water_id": {
                "type": "integer"
              },
              "changed_keys": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "log_maintenance",
          "title": "Log maintenance",
          "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. 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": {
            "type": "object",
            "required": [
              "equipment_kind",
              "equipment_id",
              "task"
            ],
            "properties": {
              "note": {
                "type": "string",
                "description": "Optional: what you did, and anything that surprised you"
              },
              "task": {
                "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",
                "description": "Which maintenance job was performed"
              },
              "details": {
                "type": "object",
                "description": "Fields specific to this task. Which ones a task takes is published as details_fields on each task; a burr clean takes none",
                "additionalProperties": true
              },
              "evidence": {
                "type": "string",
                "description": "One line recording what the measurement rested on, e.g. \"Counted 6 clicks coarser at reassembly.\""
              },
              "guide_id": {
                "type": "string",
                "description": "Optional: the id of the maintenance guide that was followed. Must be a guide for this task"
              },
              "equipment_id": {
                "type": "integer",
                "description": "The ID of that piece of equipment"
              },
              "offset_value": {
                "type": "number",
                "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"
              },
              "performed_at": {
                "type": "string",
                "description": "When it was done (ISO 8601 or YYYY-MM-DD HH:MM:SS, UTC). Defaults to now; backdating is fine"
              },
              "disturbs_zero": {
                "enum": [
                  0,
                  1
                ],
                "type": "integer",
                "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"
              },
              "offset_source": {
                "enum": [
                  "pull",
                  "counted",
                  "typed"
                ],
                "type": "string",
                "description": "How the offset was arrived at: pull (a reference shot), counted (clicks counted at reassembly), typed (asserted directly)"
              },
              "equipment_kind": {
                "enum": [
                  "grinder",
                  "machine"
                ],
                "type": "string",
                "description": "Which kind of equipment this job was done on"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "entry_id",
              "entry",
              "deduped",
              "message"
            ],
            "properties": {
              "entry": {
                "type": "object",
                "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"
                ],
                "properties": {
                  "id": {
                    "type": "integer"
                  },
                  "note": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "task": {
                    "type": "string"
                  },
                  "details": {
                    "type": [
                      "null",
                      "object"
                    ],
                    "required": [],
                    "properties": {
                      "label": {
                        "type": "string"
                      },
                      "product": {
                        "type": "string"
                      },
                      "filter_id": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": true
                  },
                  "evidence": {
                    "type": [
                      "null",
                      "string"
                    ]
                  },
                  "guide_id": {
                    "type": [
                      "null",
                      "string"
                    ]
                  },
                  "offset_at": {
                    "type": [
                      "null",
                      "string"
                    ]
                  },
                  "created_at": {
                    "type": "string"
                  },
                  "equipment_id": {
                    "type": "integer"
                  },
                  "offset_value": {
                    "type": [
                      "null",
                      "integer"
                    ]
                  },
                  "performed_at": {
                    "type": "string"
                  },
                  "details_known": {
                    "type": "boolean"
                  },
                  "disturbs_zero": {
                    "type": "integer"
                  },
                  "offset_source": {
                    "type": [
                      "null",
                      "string"
                    ]
                  },
                  "equipment_kind": {
                    "type": "string"
                  },
                  "details_version": {
                    "type": "integer"
                  }
                },
                "additionalProperties": true
              },
              "deduped": {
                "type": "boolean"
              },
              "message": {
                "type": "string"
              },
              "entry_id": {
                "type": "integer"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "set_maintenance_offset",
          "title": "Set calibration offset",
          "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": {
            "type": "object",
            "required": [
              "entry_id"
            ],
            "properties": {
              "source": {
                "enum": [
                  "pull",
                  "counted",
                  "typed"
                ],
                "type": "string",
                "description": "How it was arrived at: pull, counted, or typed"
              },
              "entry_id": {
                "type": "integer",
                "description": "The maintenance entry that opened the epoch, from list_grinders"
              },
              "evidence": {
                "type": "string",
                "description": "One line recording what it rested on, e.g. \"Reference pull 1.38 g/s against 1.74 g/s locked.\""
              },
              "offset_value": {
                "type": "number",
                "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"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "entry",
              "message"
            ],
            "properties": {
              "entry": {
                "type": "object",
                "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"
                ],
                "properties": {
                  "id": {
                    "type": "integer"
                  },
                  "note": {
                    "type": "string"
                  },
                  "task": {
                    "type": "string"
                  },
                  "details": {
                    "type": [
                      "null",
                      "object"
                    ],
                    "required": [],
                    "properties": {
                      "to": {
                        "type": "object",
                        "required": [
                          "setting_scheme",
                          "nominal_step",
                          "components_spec"
                        ],
                        "properties": {
                          "nominal_step": {
                            "type": "number"
                          },
                          "setting_scheme": {
                            "type": "string"
                          },
                          "components_spec": {}
                        },
                        "additionalProperties": true
                      },
                      "from": {
                        "type": "object",
                        "required": [
                          "setting_scheme",
                          "nominal_step",
                          "components_spec"
                        ],
                        "properties": {
                          "nominal_step": {
                            "type": "integer"
                          },
                          "setting_scheme": {
                            "type": "string"
                          },
                          "components_spec": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": true
                      }
                    },
                    "additionalProperties": true
                  },
                  "evidence": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "guide_id": {},
                  "offset_at": {
                    "type": "string"
                  },
                  "created_at": {
                    "type": "string"
                  },
                  "equipment_id": {
                    "type": "integer"
                  },
                  "offset_value": {
                    "type": "integer"
                  },
                  "performed_at": {
                    "type": "string"
                  },
                  "details_known": {
                    "type": "boolean"
                  },
                  "disturbs_zero": {
                    "type": "integer"
                  },
                  "offset_source": {
                    "type": "string"
                  },
                  "equipment_kind": {
                    "type": "string"
                  },
                  "details_version": {
                    "type": "integer"
                  }
                },
                "additionalProperties": true
              },
              "message": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "set_maintenance_schedule",
          "title": "Set a maintenance schedule",
          "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": {
            "type": "object",
            "required": [
              "equipment_kind",
              "equipment_id",
              "task"
            ],
            "properties": {
              "task": {
                "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",
                "description": "The task, as its value in that equipment's maintenance.tasks"
              },
              "fields": {
                "type": "object",
                "properties": {
                  "every": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "properties": {
                      "days": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Whole days"
                      },
                      "grams": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Grams of coffee through a grinder"
                      },
                      "shots": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Whole shots"
                      },
                      "litres": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Litres through a machine's group"
                      }
                    },
                    "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"
                  },
                  "enabled": {
                    "type": "boolean",
                    "description": "false sets the user's interval aside (the maker's applies again) without forgetting it"
                  },
                  "muted_until": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Silence the reminder until this date or time (ISO 8601, UTC); null unmutes"
                  }
                }
              },
              "changed_at": {
                "type": "string",
                "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"
              },
              "equipment_id": {
                "type": "integer",
                "description": "This account's own grinder or machine number, from list_grinders or list_machines"
              },
              "equipment_kind": {
                "enum": [
                  "grinder",
                  "machine"
                ],
                "type": "string",
                "description": "Which kind of equipment the task is on"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "equipment_kind",
              "equipment_id",
              "task",
              "schedule",
              "class",
              "every",
              "every_source",
              "due",
              "applied",
              "message"
            ],
            "properties": {
              "due": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [],
                "properties": {
                  "done": {
                    "type": [
                      "integer",
                      "number"
                    ]
                  },
                  "soon": {
                    "type": "boolean"
                  },
                  "basis": {
                    "type": "string"
                  },
                  "every": {
                    "type": [
                      "integer",
                      "number"
                    ]
                  },
                  "muted": {
                    "type": "boolean"
                  },
                  "ratio": {
                    "type": [
                      "integer",
                      "number"
                    ]
                  },
                  "state": {
                    "type": "string"
                  },
                  "due_at": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "last_at": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "soon_at": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "remaining": {
                    "type": [
                      "integer",
                      "number"
                    ]
                  },
                  "overdue_at": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "lower_bound": {
                    "type": "boolean"
                  },
                  "muted_until": {
                    "type": [
                      "null",
                      "string"
                    ]
                  },
                  "every_source": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              },
              "task": {
                "type": "string"
              },
              "class": {
                "type": "string"
              },
              "every": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [],
                "properties": {
                  "days": {
                    "type": "integer"
                  },
                  "grams": {
                    "type": "integer"
                  },
                  "shots": {
                    "type": "integer"
                  },
                  "litres": {
                    "type": "number"
                  }
                },
                "additionalProperties": true
              },
              "applied": {
                "type": "boolean"
              },
              "message": {
                "type": "string"
              },
              "schedule": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [],
                "properties": {
                  "every": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "required": [],
                    "properties": {
                      "days": {
                        "type": "integer"
                      },
                      "litres": {
                        "type": "number"
                      }
                    },
                    "additionalProperties": true
                  },
                  "enabled": {
                    "type": "boolean"
                  },
                  "muted_until": {
                    "type": [
                      "null",
                      "string"
                    ]
                  }
                },
                "additionalProperties": true
              },
              "equipment_id": {
                "type": "integer"
              },
              "every_source": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [],
                "properties": {
                  "days": {
                    "type": "string"
                  },
                  "grams": {
                    "type": "string"
                  },
                  "shots": {
                    "type": "string"
                  },
                  "litres": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              },
              "equipment_kind": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "get_maintenance_guides",
          "title": "Get maintenance guides",
          "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": {
            "type": "object",
            "properties": {
              "guide_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "maxItems": 50,
                "description": "Optional: the guides to fetch. Omit for every guide the user's equipment can use"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "catalog_version",
              "guides",
              "missing"
            ],
            "properties": {
              "guides": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "task",
                    "kind",
                    "scope",
                    "brand",
                    "applies_to",
                    "title",
                    "basis",
                    "researched_at",
                    "sources",
                    "machine_alert",
                    "duration_minutes",
                    "supplies",
                    "tools",
                    "steps",
                    "warnings",
                    "gaps"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "gaps": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "kind": {
                      "type": "string"
                    },
                    "task": {
                      "type": "string"
                    },
                    "basis": {
                      "type": "string"
                    },
                    "brand": {
                      "type": "string"
                    },
                    "scope": {
                      "type": "string"
                    },
                    "steps": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "n",
                          "text",
                          "source",
                          "anchor"
                        ],
                        "properties": {
                          "n": {
                            "type": "integer"
                          },
                          "text": {
                            "type": "string"
                          },
                          "when": {
                            "type": "string"
                          },
                          "anchor": {
                            "type": "string"
                          },
                          "repeat": {
                            "type": "integer"
                          },
                          "source": {
                            "type": "string"
                          },
                          "optional": {
                            "type": "boolean"
                          }
                        },
                        "additionalProperties": true
                      }
                    },
                    "title": {
                      "type": "string"
                    },
                    "tools": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "sources": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "ref",
                          "url",
                          "type",
                          "title"
                        ],
                        "properties": {
                          "ref": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string"
                          },
                          "type": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": true
                      }
                    },
                    "variant": {
                      "type": "string"
                    },
                    "supplies": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "item",
                          "spec",
                          "required"
                        ],
                        "properties": {
                          "item": {
                            "type": "string"
                          },
                          "spec": {
                            "type": "string"
                          },
                          "source": {
                            "type": "string"
                          },
                          "required": {
                            "type": "boolean"
                          }
                        },
                        "additionalProperties": true
                      }
                    },
                    "warnings": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "text",
                          "source"
                        ],
                        "properties": {
                          "text": {
                            "type": "string"
                          },
                          "source": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": true
                      }
                    },
                    "preferred": {
                      "type": "boolean"
                    },
                    "applies_to": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "also_covers": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "machine_alert": {
                      "type": [
                        "null",
                        "object"
                      ],
                      "required": [],
                      "properties": {
                        "clears": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "counts": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string"
                        },
                        "shown_as": {
                          "type": "string"
                        },
                        "indicator": {
                          "type": "string"
                        },
                        "threshold": {},
                        "can_disable": {},
                        "depends_on_setting": {}
                      },
                      "additionalProperties": true
                    },
                    "researched_at": {
                      "type": "string"
                    },
                    "duration_minutes": {
                      "type": [
                        "null",
                        "integer"
                      ]
                    }
                  },
                  "additionalProperties": true
                }
              },
              "missing": {
                "type": [
                  "null",
                  "array"
                ],
                "items": {
                  "type": "string"
                }
              },
              "catalog_version": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_maintenance_due",
          "title": "List maintenance due",
          "description": "What maintenance is due across the user's current grinders and machines, most urgent first. Use it 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": {
            "type": "object",
            "properties": {
              "status": {
                "enum": [
                  "due",
                  "all"
                ],
                "type": "string",
                "description": "due (default): due or overdue, and not muted. all: every scheduled task, muted ones last"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "catalog_version",
              "computed_at",
              "items"
            ],
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "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"
                  ],
                  "properties": {
                    "done": {
                      "type": [
                        "number",
                        "integer",
                        "null"
                      ]
                    },
                    "soon": {
                      "type": "boolean"
                    },
                    "task": {
                      "type": "string"
                    },
                    "basis": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "class": {
                      "type": "string"
                    },
                    "every": {
                      "type": [
                        "number",
                        "integer",
                        "null"
                      ]
                    },
                    "label": {
                      "type": "string"
                    },
                    "muted": {
                      "type": "boolean"
                    },
                    "ratio": {
                      "type": [
                        "number",
                        "integer"
                      ]
                    },
                    "state": {
                      "type": "string"
                    },
                    "due_at": {
                      "type": [
                        "null",
                        "string"
                      ]
                    },
                    "last_at": {
                      "type": [
                        "null",
                        "string"
                      ]
                    },
                    "soon_at": {
                      "type": [
                        "null",
                        "string"
                      ]
                    },
                    "remaining": {
                      "type": [
                        "number",
                        "integer",
                        "null"
                      ]
                    },
                    "overdue_at": {
                      "type": [
                        "null",
                        "string"
                      ]
                    },
                    "lower_bound": {
                      "type": "boolean"
                    },
                    "muted_until": {
                      "type": [
                        "null",
                        "string"
                      ]
                    },
                    "equipment_id": {
                      "type": "integer"
                    },
                    "every_source": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "equipment_kind": {
                      "type": "string"
                    },
                    "equipment_name": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": true
                }
              },
              "computed_at": {
                "type": "string"
              },
              "catalog_version": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "register_water",
          "title": "Register a water recipe",
          "description": "Register a custom or commercial water formulation.",
          "inputSchema": {
            "type": "object",
            "required": [
              "name"
            ],
            "properties": {
              "gh": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "General hardness (GH) in ppm"
              },
              "kh": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Karbonate hardness (KH) in ppm"
              },
              "tds": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "TDS in ppm"
              },
              "name": {
                "type": "string",
                "description": "Water formulation name, e.g. Lotus Light & Bright, Third Wave Water"
              },
              "type": {
                "type": "string",
                "description": "Type, e.g., mineralized, tap, distilled, RO"
              },
              "notes": {
                "type": "string",
                "description": "Additional notes"
              },
              "sodium": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Sodium concentration in ppm"
              },
              "calcium": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Calcium concentration in ppm"
              },
              "magnesium": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Magnesium concentration in ppm"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "water_id",
              "message"
            ],
            "properties": {
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "water_id": {
                "type": "integer"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "list_waters",
          "title": "List water recipes",
          "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": {
            "type": "object",
            "properties": {
              "status": {
                "enum": [
                  "current",
                  "archived",
                  "all"
                ],
                "type": "string",
                "description": "Filter by status: current (unarchived), archived, or all. Defaults to current."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "waters"
            ],
            "properties": {
              "waters": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "name",
                    "type",
                    "tds",
                    "gh",
                    "kh",
                    "sodium",
                    "calcium",
                    "magnesium",
                    "notes",
                    "archived"
                  ],
                  "properties": {
                    "gh": {
                      "type": "integer"
                    },
                    "id": {
                      "type": "integer"
                    },
                    "kh": {
                      "type": "integer"
                    },
                    "tds": {},
                    "name": {
                      "type": "string"
                    },
                    "type": {},
                    "notes": {},
                    "sodium": {},
                    "calcium": {},
                    "archived": {
                      "type": "integer"
                    },
                    "magnesium": {}
                  },
                  "additionalProperties": true
                }
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "register_scale",
          "title": "Register a scale",
          "description": "Register a brewing scale: the instrument that weighs the dose and the yield.",
          "inputSchema": {
            "type": "object",
            "required": [
              "name",
              "scale_type"
            ],
            "properties": {
              "name": {
                "type": "string",
                "description": "Scale name/model, e.g. Acaia Lunar, Timemore Black Mirror Basic 2"
              },
              "notes": {
                "type": "string",
                "description": "Additional notes"
              },
              "power": {
                "enum": [
                  "usb_c",
                  "micro_usb",
                  "aa",
                  "aaa",
                  "mains"
                ],
                "type": "string",
                "description": "How it is powered or recharged"
              },
              "depth_mm": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Platform depth in mm"
              },
              "width_mm": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Platform width in mm. Measure your drip tray"
              },
              "auto_tare": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "1 if it zeroes itself when a vessel is set down, 0 if not, null if unstated"
              },
              "height_mm": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Overall height in mm: the dimension that decides whether it fits under a group head"
              },
              "auto_timer": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "1 if the timer starts on first flow, 0 if not, null if unstated"
              },
              "capacity_g": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Maximum weight in grams. The cup or portafilter counts against it"
              },
              "scale_type": {
                "enum": [
                  "espresso",
                  "brew",
                  "dual",
                  "connected",
                  "dosing",
                  "training",
                  "bench"
                ],
                "type": "string",
                "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)"
              },
              "connectivity": {
                "enum": [
                  "none",
                  "bluetooth",
                  "usb",
                  "bluetooth_usb"
                ],
                "type": "string",
                "description": "How the scale talks to an app or a machine controller"
              },
              "resolution_g": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Finest published readability in grams. Leave null unless the maker states it"
              },
              "water_resistance": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "IEC 60529 ingress code as published, e.g. IPX4, IPX6, IP67, or none"
              },
              "flow_rate_display": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "1 if the scale shows live flow rate in g/s, 0 if it does not, null if the maker never said"
              },
              "resolution_banded": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "1 when resolution_g only holds in the lowest weight band and coarsens with load. Put the ladder in notes"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "scale_id",
              "message"
            ],
            "properties": {
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "scale_id": {
                "type": "integer"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "list_scales",
          "title": "List scales",
          "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": {
            "type": "object",
            "properties": {
              "status": {
                "enum": [
                  "current",
                  "archived",
                  "all"
                ],
                "type": "string",
                "description": "Filter by status: current (unarchived), archived, or all. Defaults to current."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "scales"
            ],
            "properties": {
              "scales": {
                "type": "array",
                "items": {
                  "type": "object",
                  "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"
                  ],
                  "properties": {
                    "id": {
                      "type": "integer"
                    },
                    "name": {
                      "type": "string"
                    },
                    "notes": {},
                    "power": {},
                    "archived": {
                      "type": "integer"
                    },
                    "depth_mm": {},
                    "width_mm": {},
                    "auto_tare": {},
                    "height_mm": {},
                    "auto_timer": {},
                    "capacity_g": {},
                    "scale_type": {
                      "type": "string"
                    },
                    "connectivity": {},
                    "resolution_g": {
                      "type": "number"
                    },
                    "water_resistance": {},
                    "flow_rate_display": {},
                    "resolution_banded": {
                      "type": "integer"
                    }
                  },
                  "additionalProperties": true
                }
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "register_program",
          "title": "Register a machine program",
          "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": {
            "type": "object",
            "required": [
              "machine_id",
              "program_number"
            ],
            "properties": {
              "machine_id": {
                "type": "integer"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "program_type": {
                "enum": [
                  "volumetric",
                  "timed"
                ],
                "type": "string",
                "description": "Cutoff method: \"volumetric\" (weight) or \"timed\" (duration). Defaults to volumetric."
              },
              "target_time_s": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Target shot duration cutoff in seconds (required for timed programs)"
              },
              "volume_source": {
                "enum": [
                  "measured",
                  "recalled"
                ],
                "type": "string",
                "description": "Confidence in the stored cutoff value, for either type"
              },
              "program_number": {
                "type": "integer",
                "description": "Program number / button index (e.g. 1 or 2)"
              },
              "target_volume_g": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Target yield cutoff in grams (required for volumetric programs)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "program_id",
              "message"
            ],
            "properties": {
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "program_id": {
                "type": "integer"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "register_coffee",
          "title": "Register a coffee",
          "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": {
            "type": "object",
            "required": [
              "name",
              "roast_date",
              "roast_level",
              "process_type"
            ],
            "properties": {
              "ean": {
                "type": "string"
              },
              "url": {
                "type": "string"
              },
              "body": {
                "type": "string",
                "description": "Free text; roasters usually say low, medium or high"
              },
              "cost": {
                "type": "number"
              },
              "name": {
                "type": "string"
              },
              "notes": {
                "type": "string",
                "maxLength": 4096,
                "description": "The coffee's own description: the roaster's tasting notes, the dialing approach that worked. Per bag notes go in bag_notes."
              },
              "state": {
                "enum": [
                  "sealed",
                  "open",
                  "frozen",
                  "finished"
                ],
                "type": "string"
              },
              "origin": {
                "type": "string"
              },
              "rating": {
                "type": "integer",
                "maximum": 5,
                "minimum": 1
              },
              "acidity": {
                "type": "string",
                "description": "Free text; roasters usually say low, medium or high"
              },
              "co2e_kg": {
                "type": "number"
              },
              "origins": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "farm": {
                      "type": "string"
                    },
                    "farmer": {
                      "type": "string"
                    },
                    "region": {
                      "type": "string"
                    },
                    "country": {
                      "type": "string"
                    },
                    "harvest": {
                      "type": "string"
                    },
                    "variety": {
                      "type": "string"
                    },
                    "percentage": {
                      "type": "number"
                    },
                    "processing": {
                      "type": "string"
                    },
                    "elevation_m": {
                      "type": "number"
                    },
                    "elevation_max_m": {
                      "type": "number",
                      "description": "Upper end of an elevation range, e.g. 1980 for \"1800–1980 m\"; elevation_m is the lower end"
                    }
                  }
                },
                "description": "List of bean origin details"
              },
              "qr_code": {
                "type": "string"
              },
              "roaster": {
                "type": "string"
              },
              "storage": {
                "type": "string"
              },
              "variety": {
                "type": "string"
              },
              "archived": {
                "type": "integer",
                "description": "1 if archived, 0 otherwise"
              },
              "bean_mix": {
                "type": "string",
                "description": "E.g. blend details"
              },
              "buy_date": {
                "type": "string",
                "description": "Calendar day in YYYY-MM-DD format: a day, not a timestamp"
              },
              "currency": {
                "type": "string"
              },
              "finished": {
                "type": "integer",
                "description": "1 if finished, 0 otherwise"
              },
              "aromatics": {
                "type": "string",
                "maxLength": 1024
              },
              "bag_notes": {
                "type": "string",
                "maxLength": 4096
              },
              "favourite": {
                "type": "integer",
                "description": "1 if favourite, 0 otherwise"
              },
              "frozen_at": {
                "type": "string",
                "description": "Calendar day the bag went into the freezer, YYYY-MM-DD: a day, not a timestamp"
              },
              "sweetness": {
                "type": "string",
                "description": "Free text; roasters usually say low, medium or high"
              },
              "product_id": {
                "type": "string",
                "description": "Set by the apps. Leave out."
              },
              "roast_date": {
                "type": "string",
                "description": "Calendar day in YYYY-MM-DD format: a day, not a timestamp"
              },
              "arabica_pct": {
                "type": "number",
                "maximum": 100,
                "minimum": 0,
                "description": "Percent arabica, 100 for a pure arabica; the rest robusta"
              },
              "attachments": {
                "type": "string",
                "maxLength": 1024,
                "description": "JSON or comma-separated list of attachments"
              },
              "frozen_note": {
                "type": "string"
              },
              "opened_date": {
                "type": "string",
                "description": "Calendar day in YYYY-MM-DD format: a day, not a timestamp"
              },
              "roast_level": {
                "enum": [
                  "ultra-light",
                  "light",
                  "medium",
                  "medium-dark",
                  "dark"
                ],
                "type": "string"
              },
              "roast_range": {
                "type": "string"
              },
              "unfrozen_at": {
                "type": "string",
                "description": "Calendar day the bag came out, YYYY-MM-DD: a day, not a timestamp"
              },
              "bag_weight_g": {
                "type": "number",
                "description": "Bag weight in grams"
              },
              "best_by_date": {
                "type": "string",
                "description": "Calendar day in YYYY-MM-DD format: a day, not a timestamp"
              },
              "process_type": {
                "enum": [
                  "washed",
                  "natural",
                  "honey",
                  "anaerobic",
                  "aerobic-extended",
                  "co-fermented",
                  "bioreactor",
                  "other"
                ],
                "type": "string"
              },
              "roast_custom": {
                "type": "string"
              },
              "decaffeinated": {
                "type": "integer",
                "description": "1 if decaf, 0 if regular"
              },
              "dial_category": {
                "enum": [
                  "nordic-light",
                  "ultra-light",
                  "classic",
                  "processed",
                  "dark",
                  "aged"
                ],
                "type": "string",
                "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."
              },
              "roasting_type": {
                "enum": [
                  "filter",
                  "espresso",
                  "omni"
                ],
                "type": "string"
              },
              "cupping_points": {
                "type": "number"
              },
              "frozen_storage": {
                "type": "string"
              },
              "lot_revision_id": {
                "type": "string",
                "description": "Set by the apps. Leave out."
              },
              "catalog_coffee_id": {
                "type": "string",
                "description": "Set by the apps. Leave out."
              },
              "rest_window_days_max": {
                "type": "integer"
              },
              "rest_window_days_min": {
                "type": "integer"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "bean_id",
              "bag_id",
              "active",
              "message"
            ],
            "properties": {
              "active": {
                "type": "boolean"
              },
              "bag_id": {
                "type": "integer"
              },
              "status": {
                "type": "string"
              },
              "bean_id": {
                "type": "integer"
              },
              "message": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "set_active",
          "title": "Set active equipment",
          "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": {
            "type": "object",
            "properties": {
              "bean_id": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "This account's own bean number, as returned by list_beans. Never guess one; null = leave unchanged"
              },
              "grinder_id": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "This account's own grinder number, as returned by list_grinders. Never guess one; null = leave unchanged"
              },
              "machine_id": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "This account's own machine number, as returned by list_machines. Never guess one; null = leave unchanged"
              },
              "program_id": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "A program number from the active machine's list; switching machines clears it. null = leave unchanged"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "message"
            ],
            "properties": {
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "update_bean",
          "title": "Update a coffee",
          "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": {
            "type": "object",
            "required": [
              "bean_id",
              "fields"
            ],
            "properties": {
              "fields": {
                "type": "object",
                "properties": {
                  "ean": {
                    "type": "string"
                  },
                  "url": {
                    "type": "string"
                  },
                  "body": {
                    "type": "string",
                    "description": "Free text; roasters usually say low, medium or high"
                  },
                  "cost": {
                    "type": "number"
                  },
                  "name": {
                    "type": "string"
                  },
                  "notes": {
                    "type": "string",
                    "maxLength": 4096,
                    "description": "The coffee's own description: roaster tasting notes, the dialing approach. Replaces the stored value; the optional reason is appended instead."
                  },
                  "state": {
                    "enum": [
                      "sealed",
                      "open",
                      "frozen",
                      "finished"
                    ],
                    "type": "string"
                  },
                  "origin": {
                    "type": "string"
                  },
                  "rating": {
                    "type": "integer",
                    "maximum": 5,
                    "minimum": 0,
                    "description": "1-5 stars; 0 clears the rating (unrated)"
                  },
                  "acidity": {
                    "type": "string",
                    "description": "Free text; roasters usually say low, medium or high"
                  },
                  "co2e_kg": {
                    "type": "number"
                  },
                  "origins": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "farm": {
                          "type": "string"
                        },
                        "farmer": {
                          "type": "string"
                        },
                        "region": {
                          "type": "string"
                        },
                        "country": {
                          "type": "string"
                        },
                        "harvest": {
                          "type": "string"
                        },
                        "variety": {
                          "type": "string"
                        },
                        "percentage": {
                          "type": "number"
                        },
                        "processing": {
                          "type": "string"
                        },
                        "elevation_m": {
                          "type": "number"
                        },
                        "elevation_max_m": {
                          "type": "number",
                          "description": "Upper end of an elevation range; elevation_m is the lower end"
                        }
                      }
                    },
                    "description": "List of bean origin details"
                  },
                  "qr_code": {
                    "type": "string"
                  },
                  "roaster": {
                    "type": "string"
                  },
                  "storage": {
                    "type": "string"
                  },
                  "variety": {
                    "type": "string"
                  },
                  "archived": {
                    "type": "integer",
                    "description": "1 if archived, 0 otherwise"
                  },
                  "bean_mix": {
                    "type": "string",
                    "description": "E.g. blend details"
                  },
                  "buy_date": {
                    "type": "string",
                    "description": "Calendar day in YYYY-MM-DD format: a day, not a timestamp"
                  },
                  "currency": {
                    "type": "string"
                  },
                  "finished": {
                    "type": "integer",
                    "description": "1 if finished, 0 otherwise"
                  },
                  "aromatics": {
                    "type": "string",
                    "maxLength": 1024
                  },
                  "bag_notes": {
                    "type": "string",
                    "maxLength": 4096
                  },
                  "favourite": {
                    "type": "integer",
                    "description": "1 if favourite, 0 otherwise"
                  },
                  "frozen_at": {
                    "type": "string",
                    "description": "Calendar day the bag went into the freezer, YYYY-MM-DD: a day, not a timestamp"
                  },
                  "sweetness": {
                    "type": "string",
                    "description": "Free text; roasters usually say low, medium or high"
                  },
                  "roast_date": {
                    "type": "string",
                    "description": "Calendar day in YYYY-MM-DD format: a day, not a timestamp"
                  },
                  "arabica_pct": {
                    "type": "number",
                    "maximum": 100,
                    "minimum": 0
                  },
                  "attachments": {
                    "type": "string",
                    "maxLength": 1024,
                    "description": "JSON or comma-separated list of attachments"
                  },
                  "frozen_note": {
                    "type": "string"
                  },
                  "opened_date": {
                    "type": "string",
                    "description": "Calendar day in YYYY-MM-DD format: a day, not a timestamp"
                  },
                  "roast_level": {
                    "enum": [
                      "ultra-light",
                      "light",
                      "medium",
                      "medium-dark",
                      "dark"
                    ],
                    "type": "string"
                  },
                  "roast_range": {
                    "type": "string"
                  },
                  "unfrozen_at": {
                    "type": "string",
                    "description": "Calendar day the bag came out, YYYY-MM-DD: a day, not a timestamp"
                  },
                  "bag_weight_g": {
                    "type": "number",
                    "description": "Bag weight in grams"
                  },
                  "best_by_date": {
                    "type": "string",
                    "description": "Calendar day in YYYY-MM-DD format: a day, not a timestamp"
                  },
                  "process_type": {
                    "enum": [
                      "washed",
                      "natural",
                      "honey",
                      "anaerobic",
                      "aerobic-extended",
                      "co-fermented",
                      "bioreactor",
                      "other"
                    ],
                    "type": "string"
                  },
                  "roast_custom": {
                    "type": "string"
                  },
                  "decaffeinated": {
                    "type": "integer",
                    "description": "1 if decaf, 0 if regular"
                  },
                  "dial_category": {
                    "enum": [
                      "nordic-light",
                      "ultra-light",
                      "classic",
                      "processed",
                      "dark",
                      "aged"
                    ],
                    "type": "string",
                    "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."
                  },
                  "roasting_type": {
                    "enum": [
                      "filter",
                      "espresso",
                      "omni"
                    ],
                    "type": "string"
                  },
                  "cupping_points": {
                    "type": "number"
                  },
                  "frozen_storage": {
                    "type": "string"
                  },
                  "grams_remaining": {
                    "type": "number",
                    "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."
                  },
                  "weight_adjustment_g": {
                    "type": "number",
                    "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."
                  },
                  "rest_window_days_max": {
                    "type": "integer"
                  },
                  "rest_window_days_min": {
                    "type": "integer"
                  }
                }
              },
              "reason": {
                "type": "string",
                "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."
              },
              "bean_id": {
                "type": "integer"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "message"
            ],
            "properties": {
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "get_dial_state",
          "title": "Get current dial state",
          "description": "Retrieve current dialing state, active context, recent shots, recommendations, and locked recipes.",
          "inputSchema": {
            "type": "object",
            "properties": {}
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "active_coffee",
              "active_grinder",
              "active_machine",
              "active_program",
              "recent_shots",
              "recent_recommendations",
              "locked_recipe",
              "maintenance_summary"
            ],
            "properties": {
              "recent_shots": {
                "type": "array",
                "items": {
                  "type": "object",
                  "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"
                  ],
                  "properties": {
                    "id": {
                      "type": "integer"
                    },
                    "tds": {},
                    "bag_id": {
                      "type": "integer"
                    },
                    "dose_g": {
                      "type": "integer"
                    },
                    "ey_pct": {},
                    "rating": {},
                    "tasted": {
                      "type": "integer"
                    },
                    "time_s": {
                      "type": "integer"
                    },
                    "bean_id": {
                      "type": "integer"
                    },
                    "verdict": {},
                    "yield_g": {
                      "type": "integer"
                    },
                    "water_id": {},
                    "best_brew": {
                      "type": "integer"
                    },
                    "favourite": {
                      "type": "integer"
                    },
                    "pulled_at": {
                      "type": "string"
                    },
                    "beverage_g": {},
                    "grinder_id": {
                      "type": "integer"
                    },
                    "machine_id": {
                      "type": "integer"
                    },
                    "program_id": {},
                    "temp_taste": {
                      "type": "string"
                    },
                    "grind_label": {
                      "type": "string"
                    },
                    "vessel_name": {},
                    "bloom_time_s": {},
                    "drink_intent": {
                      "type": "string"
                    },
                    "flavor_notes": {
                      "type": "string"
                    },
                    "observations": {
                      "type": "string"
                    },
                    "sensory_tags": {
                      "type": "string"
                    },
                    "finish_action": {
                      "type": "string"
                    },
                    "flow_rate_gps": {
                      "type": "number"
                    },
                    "taste_pending": {
                      "type": "integer"
                    },
                    "temperature_c": {},
                    "data_confidence": {
                      "type": "string"
                    },
                    "vessel_weight_g": {},
                    "grind_components": {
                      "type": "string"
                    },
                    "machine_settings": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "additionalProperties": true
                    },
                    "first_drip_time_s": {},
                    "grind_position_value": {
                      "type": "integer"
                    }
                  },
                  "additionalProperties": true
                }
              },
              "active_coffee": {
                "type": "object",
                "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",
                  "catalog_coffee_id",
                  "age_days",
                  "days_off_roast",
                  "days_since_opened",
                  "frozen_days_excluded",
                  "effective_age_days",
                  "age_verdict",
                  "age_verdict_code",
                  "grams_remaining",
                  "current_bag_id",
                  "bag"
                ],
                "properties": {
                  "id": {
                    "type": "integer"
                  },
                  "bag": {
                    "type": "object",
                    "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",
                      "product_id",
                      "lot_revision_id",
                      "days_off_roast",
                      "days_since_opened",
                      "frozen_days_excluded",
                      "effective_age_days",
                      "age_verdict",
                      "age_verdict_code",
                      "grams_remaining"
                    ],
                    "properties": {
                      "id": {
                        "type": "integer"
                      },
                      "ean": {},
                      "cost": {},
                      "state": {
                        "type": "string"
                      },
                      "bean_id": {
                        "type": "integer"
                      },
                      "qr_code": {},
                      "storage": {},
                      "archived": {
                        "type": "integer"
                      },
                      "buy_date": {},
                      "currency": {},
                      "finished": {
                        "type": "integer"
                      },
                      "bag_notes": {
                        "type": "string"
                      },
                      "frozen_at": {},
                      "product_id": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "roast_date": {
                        "type": "string"
                      },
                      "age_verdict": {
                        "type": "string"
                      },
                      "frozen_note": {},
                      "opened_date": {},
                      "unfrozen_at": {},
                      "bag_weight_g": {},
                      "best_by_date": {},
                      "days_off_roast": {
                        "type": "integer"
                      },
                      "frozen_storage": {},
                      "grams_remaining": {},
                      "lot_revision_id": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "age_verdict_code": {
                        "type": "string"
                      },
                      "days_since_opened": {},
                      "effective_age_days": {
                        "type": "integer"
                      },
                      "weight_adjustment_g": {
                        "type": "integer"
                      },
                      "frozen_days_excluded": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": true
                  },
                  "ean": {},
                  "url": {},
                  "body": {},
                  "cost": {},
                  "name": {
                    "type": "string"
                  },
                  "notes": {},
                  "state": {
                    "type": "string"
                  },
                  "origin": {},
                  "rating": {},
                  "acidity": {},
                  "co2e_kg": {},
                  "qr_code": {},
                  "roaster": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "storage": {},
                  "variety": {},
                  "age_days": {
                    "type": "integer"
                  },
                  "archived": {
                    "type": "integer"
                  },
                  "bean_mix": {},
                  "buy_date": {},
                  "currency": {},
                  "finished": {
                    "type": "integer"
                  },
                  "aromatics": {},
                  "bag_notes": {
                    "type": "string"
                  },
                  "favourite": {},
                  "frozen_at": {},
                  "is_active": {
                    "type": "integer"
                  },
                  "sweetness": {},
                  "roast_date": {
                    "type": "string"
                  },
                  "age_verdict": {
                    "type": "string"
                  },
                  "arabica_pct": {},
                  "attachments": {},
                  "frozen_note": {},
                  "opened_date": {},
                  "roast_level": {
                    "type": "string"
                  },
                  "roast_range": {},
                  "unfrozen_at": {},
                  "bag_weight_g": {},
                  "best_by_date": {},
                  "process_type": {
                    "type": "string"
                  },
                  "roast_custom": {},
                  "decaffeinated": {},
                  "dial_category": {
                    "type": "string"
                  },
                  "roasting_type": {},
                  "cupping_points": {},
                  "current_bag_id": {
                    "type": "integer"
                  },
                  "days_off_roast": {
                    "type": "integer"
                  },
                  "frozen_storage": {},
                  "grams_remaining": {},
                  "age_verdict_code": {
                    "type": "string"
                  },
                  "catalog_coffee_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "days_since_opened": {},
                  "effective_age_days": {
                    "type": "integer"
                  },
                  "weight_adjustment_g": {
                    "type": "integer"
                  },
                  "frozen_days_excluded": {
                    "type": "integer"
                  },
                  "rest_window_days_max": {},
                  "rest_window_days_min": {}
                },
                "additionalProperties": true
              },
              "locked_recipe": {
                "type": "object",
                "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",
                  "machine_settings",
                  "grind_reading"
                ],
                "properties": {
                  "id": {
                    "type": "integer"
                  },
                  "dose_g": {
                    "type": "integer"
                  },
                  "status": {
                    "type": "string"
                  },
                  "bean_id": {
                    "type": "integer"
                  },
                  "profile": {
                    "type": "string"
                  },
                  "locked_at": {
                    "type": "string"
                  },
                  "grinder_id": {
                    "type": "integer"
                  },
                  "kb_version": {
                    "type": "string"
                  },
                  "machine_id": {
                    "type": "integer"
                  },
                  "program_id": {},
                  "grind_label": {
                    "type": "string"
                  },
                  "drink_intent": {
                    "type": "string"
                  },
                  "finish_action": {
                    "type": "string"
                  },
                  "grind_reading": {},
                  "target_time_s": {
                    "type": "integer"
                  },
                  "target_yield_g": {
                    "type": "integer"
                  },
                  "machine_settings": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "additionalProperties": true
                  },
                  "grind_position_value": {
                    "type": "integer"
                  }
                },
                "additionalProperties": true
              },
              "active_grinder": {
                "type": "object",
                "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"
                ],
                "properties": {
                  "id": {
                    "type": "integer"
                  },
                  "name": {
                    "type": "string"
                  },
                  "notes": {},
                  "photo": {},
                  "source": {
                    "type": "string"
                  },
                  "archived": {
                    "type": "integer"
                  },
                  "burr_type": {
                    "type": "string"
                  },
                  "is_active": {
                    "type": "integer"
                  },
                  "max_value": {},
                  "min_value": {},
                  "catalog_id": {},
                  "motor_type": {
                    "type": "string"
                  },
                  "verified_at": {
                    "type": "string"
                  },
                  "nominal_step": {
                    "type": "integer"
                  },
                  "setting_label": {
                    "type": "string"
                  },
                  "position_value": {
                    "type": "integer"
                  },
                  "setting_scheme": {
                    "type": "string"
                  },
                  "components_spec": {
                    "type": "string"
                  },
                  "microns_per_step": {
                    "type": "integer"
                  },
                  "setting_components": {
                    "type": "string"
                  },
                  "built_in_machine_id": {},
                  "direction_convention": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              },
              "active_machine": {
                "type": "object",
                "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"
                ],
                "properties": {
                  "id": {
                    "type": "integer"
                  },
                  "name": {
                    "type": "string"
                  },
                  "notes": {},
                  "photo": {},
                  "tools": {},
                  "archived": {
                    "type": "integer"
                  },
                  "settings": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "items": {
                      "type": "object",
                      "required": [
                        "key",
                        "label",
                        "type",
                        "options",
                        "min",
                        "max",
                        "step",
                        "unit",
                        "default",
                        "value",
                        "provenance"
                      ],
                      "properties": {
                        "key": {
                          "type": "string"
                        },
                        "max": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "min": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "step": {},
                        "type": {
                          "type": "string"
                        },
                        "unit": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "label": {
                          "type": "string"
                        },
                        "value": {
                          "type": [
                            "number",
                            "null",
                            "string"
                          ]
                        },
                        "default": {
                          "type": [
                            "number",
                            "null",
                            "string"
                          ]
                        },
                        "options": {
                          "type": [
                            "null",
                            "array"
                          ],
                          "items": {
                            "type": "object",
                            "required": [
                              "value",
                              "label",
                              "meaning"
                            ],
                            "properties": {
                              "label": {
                                "type": "string"
                              },
                              "value": {
                                "type": "string"
                              },
                              "meaning": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "additionalProperties": true
                          }
                        },
                        "provenance": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "required": [
                            "source",
                            "quote",
                            "default_source",
                            "default_quote"
                          ],
                          "properties": {
                            "quote": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "source": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "default_quote": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "default_source": {
                              "type": [
                                "string",
                                "null"
                              ]
                            }
                          },
                          "additionalProperties": true
                        }
                      },
                      "additionalProperties": true
                    }
                  },
                  "is_active": {
                    "type": "integer"
                  },
                  "prep_type": {
                    "type": "string"
                  },
                  "catalog_id": {
                    "type": "string"
                  },
                  "prep_style": {
                    "type": "string"
                  },
                  "boiler_type": {
                    "type": "string"
                  },
                  "hardness_dh": {},
                  "control_type": {
                    "type": "string"
                  },
                  "connected_device": {},
                  "basket_size_grams": {
                    "type": "integer"
                  },
                  "built_in_grinder_id": {}
                },
                "additionalProperties": true
              },
              "active_program": {},
              "maintenance_summary": {
                "type": "object",
                "required": [
                  "computed_at",
                  "catalog_version",
                  "most_urgent",
                  "due_count",
                  "overdue_count",
                  "soon_count",
                  "calibration_state"
                ],
                "properties": {
                  "due_count": {
                    "type": "integer"
                  },
                  "soon_count": {
                    "type": "integer"
                  },
                  "computed_at": {
                    "type": "string"
                  },
                  "most_urgent": {
                    "type": "object",
                    "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"
                    ],
                    "properties": {
                      "done": {
                        "type": "number"
                      },
                      "soon": {
                        "type": "boolean"
                      },
                      "task": {
                        "type": "string"
                      },
                      "basis": {
                        "type": "string"
                      },
                      "class": {
                        "type": "string"
                      },
                      "every": {
                        "type": "number"
                      },
                      "label": {
                        "type": "string"
                      },
                      "muted": {
                        "type": "boolean"
                      },
                      "ratio": {
                        "type": "number"
                      },
                      "state": {
                        "type": "string"
                      },
                      "due_at": {},
                      "last_at": {},
                      "soon_at": {},
                      "remaining": {
                        "type": "number"
                      },
                      "overdue_at": {},
                      "lower_bound": {
                        "type": "boolean"
                      },
                      "muted_until": {},
                      "equipment_id": {
                        "type": "integer"
                      },
                      "every_source": {
                        "type": "string"
                      },
                      "equipment_kind": {
                        "type": "string"
                      },
                      "equipment_name": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": true
                  },
                  "overdue_count": {
                    "type": "integer"
                  },
                  "catalog_version": {
                    "type": "string"
                  },
                  "calibration_state": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              },
              "recent_recommendations": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "created_at",
                    "bean_id",
                    "grinder_id",
                    "machine_id",
                    "based_on_shot",
                    "lever",
                    "direction",
                    "rationale",
                    "confidence",
                    "cited_rules",
                    "kb_version"
                  ],
                  "properties": {
                    "lever": {
                      "type": "string"
                    },
                    "bean_id": {
                      "type": "integer"
                    },
                    "direction": {
                      "type": "string"
                    },
                    "rationale": {
                      "type": "string"
                    },
                    "confidence": {
                      "type": "string"
                    },
                    "created_at": {
                      "type": "string"
                    },
                    "grinder_id": {
                      "type": "integer"
                    },
                    "kb_version": {
                      "type": "string"
                    },
                    "machine_id": {
                      "type": "integer"
                    },
                    "cited_rules": {
                      "type": "string"
                    },
                    "based_on_shot": {}
                  },
                  "additionalProperties": true
                }
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "log_shot",
          "title": "Log a shot",
          "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": {
            "type": "object",
            "required": [
              "dose_g",
              "yield_g",
              "time_s",
              "finish_action"
            ],
            "properties": {
              "tds": {
                "type": "number",
                "description": "Total Dissolved Solids percentage (e.g. 9.1 or 1.35)"
              },
              "bag_id": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "Which bag of the coffee the shot came from; defaults to its current (open) bag. Bag numbers are on list_beans' bags[]"
              },
              "dose_g": {
                "type": "number"
              },
              "rating": {
                "type": "integer",
                "maximum": 5,
                "minimum": 1
              },
              "tasted": {
                "enum": [
                  0,
                  1
                ],
                "type": "integer",
                "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."
              },
              "time_s": {
                "type": "number"
              },
              "bean_id": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "Override: log against this bean instead of the active one (null = active)"
              },
              "verdict": {
                "type": "string"
              },
              "yield_g": {
                "type": "number"
              },
              "water_id": {
                "type": "integer",
                "description": "Optional references to waters formulation"
              },
              "best_brew": {
                "enum": [
                  0,
                  1
                ],
                "type": "integer",
                "description": "1 if marked as best brew, 0 otherwise"
              },
              "favourite": {
                "enum": [
                  0,
                  1
                ],
                "type": "integer",
                "description": "1 if favourite, 0 otherwise"
              },
              "pulled_at": {
                "type": [
                  "string",
                  "null"
                ],
                "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, because the default diagnosis target is the chronologically latest shot."
              },
              "beverage_g": {
                "type": "number",
                "description": "Yield mass excluding cup/vessel weight in grams"
              },
              "grinder_id": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "Override: grinder used, if not the active one (null = active)"
              },
              "machine_id": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "Override: machine used, if not the active one (null = active)"
              },
              "program_id": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "Override: machine program used, if not the active one (null = active)"
              },
              "temp_taste": {
                "enum": [
                  "hot",
                  "warm",
                  "cold"
                ],
                "type": "string"
              },
              "vessel_name": {
                "type": "string",
                "description": "Cup/vessel name"
              },
              "bloom_time_s": {
                "type": "number",
                "description": "Pre-wetting or bloom duration in seconds"
              },
              "drink_intent": {
                "enum": [
                  "straight",
                  "milk"
                ],
                "type": "string"
              },
              "flavor_notes": {
                "type": "string",
                "maxLength": 4096
              },
              "flow_profile": {
                "type": "string",
                "maxLength": 16384,
                "description": "Opaque flow profile data (JSON/TEXT)"
              },
              "method_tools": {
                "type": "string",
                "maxLength": 4096,
                "description": "JSON representation of method tools used (e.g., paper filters, screen)"
              },
              "observations": {
                "type": "object",
                "maxProperties": 64
              },
              "sensory_tags": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 128
                },
                "maxItems": 64
              },
              "finish_action": {
                "enum": [
                  "hard_stop",
                  "passive_drip"
                ],
                "type": "string"
              },
              "temperature_c": {
                "type": "number",
                "description": "Brew temperature in Celsius"
              },
              "data_confidence": {
                "enum": [
                  "measured",
                  "recalled",
                  "estimated"
                ],
                "type": "string",
                "description": "measured = weighed/timed live; recalled = from memory; estimated = a best guess (e.g. \"~25s\" after missing the timer)"
              },
              "vessel_weight_g": {
                "type": "number",
                "description": "Cup/vessel weight in grams"
              },
              "machine_settings": {
                "type": "object",
                "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
              },
              "pressure_profile": {
                "type": "string",
                "maxLength": 16384,
                "description": "Pressure profile description or values"
              },
              "first_drip_time_s": {
                "type": "number",
                "description": "Time to first drip in seconds"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "shot_id",
              "message"
            ],
            "properties": {
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "shot_id": {
                "type": "integer"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "lock_recipe",
          "title": "Lock a recipe",
          "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": {
            "type": "object",
            "required": [
              "from_shot_id",
              "drink_intent"
            ],
            "properties": {
              "drink_intent": {
                "enum": [
                  "straight",
                  "milk"
                ],
                "type": "string"
              },
              "from_shot_id": {
                "type": "integer"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "recipe_id",
              "message"
            ],
            "properties": {
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "recipe_id": {
                "type": "integer"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "delete_shot",
          "title": "Delete a shot",
          "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": {
            "type": "object",
            "required": [
              "shot_id"
            ],
            "properties": {
              "shot_id": {
                "type": "integer",
                "description": "ID of the shot to delete"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "deleted_shot_id",
              "message"
            ],
            "properties": {
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "deleted_shot_id": {
                "type": "integer"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "update_shot",
          "title": "Update a shot",
          "description": "Correct fields on an already-logged shot in place, with 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": {
            "type": "object",
            "required": [
              "shot_id",
              "fields"
            ],
            "properties": {
              "fields": {
                "type": "object",
                "properties": {
                  "tds": {
                    "type": "number"
                  },
                  "bag_id": {
                    "type": "integer",
                    "description": "Re-file the shot onto this bag; must be a bag of the shot's bean"
                  },
                  "dose_g": {
                    "type": "number"
                  },
                  "rating": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "maximum": 5,
                    "minimum": 1,
                    "description": "1-5; null clears the rating"
                  },
                  "tasted": {
                    "enum": [
                      0,
                      1
                    ],
                    "type": "integer",
                    "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"
                  },
                  "time_s": {
                    "type": "number"
                  },
                  "bean_id": {
                    "type": "integer",
                    "description": "Re-file the shot onto this bean (its current bag, unless bag_id is also given)"
                  },
                  "verdict": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "null clears the verdict"
                  },
                  "yield_g": {
                    "type": "number"
                  },
                  "water_id": {
                    "type": "integer"
                  },
                  "best_brew": {
                    "enum": [
                      0,
                      1
                    ],
                    "type": "integer"
                  },
                  "favourite": {
                    "enum": [
                      0,
                      1
                    ],
                    "type": "integer"
                  },
                  "pulled_at": {
                    "type": "string",
                    "description": "Corrected timestamp (ISO 8601 or \"YYYY-MM-DD HH:MM:SS\")"
                  },
                  "beverage_g": {
                    "type": "number"
                  },
                  "grinder_id": {
                    "type": "integer"
                  },
                  "machine_id": {
                    "type": "integer"
                  },
                  "program_id": {
                    "type": "integer"
                  },
                  "temp_taste": {
                    "enum": [
                      "hot",
                      "warm",
                      "cold"
                    ],
                    "type": "string"
                  },
                  "grind_label": {
                    "type": "string",
                    "description": "Corrected grind setting label; numeric position is re-derived"
                  },
                  "vessel_name": {
                    "type": "string"
                  },
                  "drink_intent": {
                    "enum": [
                      "straight",
                      "milk"
                    ],
                    "type": "string"
                  },
                  "flavor_notes": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 4096,
                    "description": "null clears the notes"
                  },
                  "observations": {
                    "type": "object",
                    "maxProperties": 64
                  },
                  "sensory_tags": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 128
                    },
                    "maxItems": 64
                  },
                  "finish_action": {
                    "enum": [
                      "hard_stop",
                      "passive_drip"
                    ],
                    "type": "string"
                  },
                  "temperature_c": {
                    "type": "number"
                  },
                  "data_confidence": {
                    "enum": [
                      "measured",
                      "recalled",
                      "estimated"
                    ],
                    "type": "string",
                    "description": "estimated marks the metrics as a best guess instead of burying the caveat in notes"
                  },
                  "vessel_weight_g": {
                    "type": "number"
                  },
                  "machine_settings": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "The machine's selector positions for this shot, {key: position}; replaces what was stamped, null clears it",
                    "maxProperties": 16
                  }
                },
                "description": "Only the fields to change"
              },
              "shot_id": {
                "type": "integer",
                "description": "ID of the shot to correct"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "shot_id",
              "updated_fields",
              "message"
            ],
            "properties": {
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "shot_id": {
                "type": "integer"
              },
              "updated_fields": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "list_recipes",
          "title": "List locked recipes",
          "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": {
            "type": "object",
            "properties": {
              "status": {
                "enum": [
                  "current",
                  "archived",
                  "all"
                ],
                "type": "string",
                "description": "Filter by status: current, archived, or all. Defaults to current."
              },
              "bean_id": {
                "type": "integer"
              },
              "grinder_id": {
                "type": "integer"
              },
              "machine_id": {
                "type": "integer"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "recipes"
            ],
            "properties": {
              "recipes": {
                "type": "array",
                "items": {
                  "type": "object",
                  "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",
                    "machine_settings",
                    "bean_name",
                    "roaster_name",
                    "grinder_name",
                    "machine_name",
                    "grind_reading"
                  ],
                  "properties": {
                    "id": {
                      "type": "integer"
                    },
                    "dose_g": {
                      "type": [
                        "integer",
                        "number"
                      ]
                    },
                    "status": {
                      "type": "string"
                    },
                    "bean_id": {
                      "type": "integer"
                    },
                    "profile": {
                      "type": "string"
                    },
                    "bean_name": {
                      "type": "string"
                    },
                    "locked_at": {
                      "type": "string"
                    },
                    "grinder_id": {
                      "type": "integer"
                    },
                    "machine_id": {
                      "type": "integer"
                    },
                    "program_id": {
                      "type": [
                        "null",
                        "integer"
                      ]
                    },
                    "grind_label": {
                      "type": "string"
                    },
                    "drink_intent": {
                      "type": "string"
                    },
                    "grinder_name": {
                      "type": "string"
                    },
                    "machine_name": {
                      "type": "string"
                    },
                    "roaster_name": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "finish_action": {
                      "type": "string"
                    },
                    "grind_reading": {
                      "type": [
                        "null",
                        "object"
                      ],
                      "required": [],
                      "properties": {
                        "label": {},
                        "unmeasured": {
                          "type": "integer"
                        },
                        "epoch_tasks": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "epochs_since": {
                          "type": "integer"
                        },
                        "offset_clicks": {},
                        "untranslatable": {
                          "type": "boolean"
                        },
                        "offset_direction": {}
                      },
                      "additionalProperties": true
                    },
                    "target_time_s": {
                      "type": "integer"
                    },
                    "target_yield_g": {
                      "type": [
                        "integer",
                        "number"
                      ]
                    },
                    "machine_settings": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "additionalProperties": true
                    },
                    "grind_position_value": {
                      "type": "integer"
                    }
                  },
                  "additionalProperties": true
                }
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_stats",
          "title": "Get statistics",
          "description": "Get compact flat usage stats for a grinder, machine, or bean.",
          "inputSchema": {
            "type": "object",
            "required": [
              "scope",
              "id"
            ],
            "properties": {
              "id": {
                "type": "integer",
                "description": "The entity ID"
              },
              "scope": {
                "enum": [
                  "grinder",
                  "machine",
                  "bean"
                ],
                "type": "string",
                "description": "The stats scope"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "brews"
            ],
            "properties": {
              "brews": {
                "type": "integer"
              },
              "last_bean": {
                "type": "string"
              },
              "last_used": {
                "type": "string"
              },
              "grams_ground": {
                "type": "integer"
              },
              "effective_age": {
                "type": "integer"
              },
              "beans_consumed": {
                "type": "integer"
              },
              "grams_consumed": {
                "type": "integer"
              },
              "grams_remaining": {
                "type": "integer"
              },
              "last_grind_setting": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_grinders",
          "title": "List grinders",
          "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": {
            "type": "object",
            "properties": {
              "status": {
                "enum": [
                  "current",
                  "archived",
                  "all"
                ],
                "type": "string",
                "description": "Filter by status: current, archived, or all. Defaults to current."
              },
              "maintenance": {
                "enum": [
                  "compact",
                  "full"
                ],
                "type": "string",
                "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)."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "grinders"
            ],
            "properties": {
              "grinders": {
                "type": "array",
                "items": {
                  "type": "object",
                  "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"
                  ],
                  "properties": {
                    "id": {
                      "type": "integer"
                    },
                    "name": {
                      "type": "string"
                    },
                    "notes": {
                      "type": [
                        "null",
                        "string"
                      ]
                    },
                    "source": {
                      "type": [
                        "null",
                        "string"
                      ]
                    },
                    "archived": {
                      "type": "integer"
                    },
                    "burr_type": {
                      "type": "string"
                    },
                    "max_value": {
                      "type": [
                        "null",
                        "integer"
                      ]
                    },
                    "min_value": {
                      "type": [
                        "null",
                        "integer"
                      ]
                    },
                    "catalog_id": {
                      "type": [
                        "null",
                        "string"
                      ]
                    },
                    "motor_type": {
                      "type": "string"
                    },
                    "maintenance": {
                      "type": "object",
                      "required": [
                        "tasks",
                        "due",
                        "calibration",
                        "sensitivity",
                        "entries",
                        "entries_total",
                        "catalog_version",
                        "computed_at",
                        "catalog",
                        "hardness"
                      ],
                      "properties": {
                        "due": {
                          "type": "object",
                          "required": [
                            "burr_clean"
                          ],
                          "properties": {
                            "burr_clean": {
                              "type": "object",
                              "required": [
                                "state",
                                "ratio",
                                "basis",
                                "every",
                                "done",
                                "remaining",
                                "lower_bound",
                                "soon",
                                "soon_at",
                                "due_at",
                                "overdue_at",
                                "last_at",
                                "every_source",
                                "muted",
                                "muted_until"
                              ],
                              "properties": {
                                "done": {
                                  "type": [
                                    "null",
                                    "integer"
                                  ]
                                },
                                "soon": {
                                  "type": "boolean"
                                },
                                "basis": {
                                  "type": [
                                    "null",
                                    "string"
                                  ]
                                },
                                "every": {
                                  "type": [
                                    "null",
                                    "integer"
                                  ]
                                },
                                "muted": {
                                  "type": "boolean"
                                },
                                "ratio": {
                                  "type": [
                                    "integer",
                                    "number"
                                  ]
                                },
                                "state": {
                                  "type": "string"
                                },
                                "due_at": {
                                  "type": [
                                    "null",
                                    "string"
                                  ]
                                },
                                "last_at": {
                                  "type": [
                                    "null",
                                    "string"
                                  ]
                                },
                                "soon_at": {
                                  "type": [
                                    "null",
                                    "string"
                                  ]
                                },
                                "remaining": {
                                  "type": [
                                    "null",
                                    "integer"
                                  ]
                                },
                                "overdue_at": {
                                  "type": [
                                    "null",
                                    "string"
                                  ]
                                },
                                "lower_bound": {
                                  "type": "boolean"
                                },
                                "muted_until": {},
                                "every_source": {
                                  "type": [
                                    "null",
                                    "string"
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true
                        },
                        "tasks": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "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"
                            ],
                            "properties": {
                              "sub": {
                                "type": "string"
                              },
                              "why": {
                                "type": "string"
                              },
                              "kind": {
                                "type": "string"
                              },
                              "class": {
                                "type": "string"
                              },
                              "every": {
                                "type": [
                                  "null",
                                  "object"
                                ],
                                "required": [],
                                "properties": {
                                  "days": {
                                    "type": "integer"
                                  },
                                  "grams": {
                                    "type": "integer"
                                  },
                                  "shots": {
                                    "type": "integer"
                                  }
                                },
                                "additionalProperties": true
                              },
                              "guide": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "required": [],
                                "properties": {
                                  "id": {
                                    "type": "string"
                                  },
                                  "basis": {
                                    "type": "string"
                                  },
                                  "scope": {
                                    "type": "string"
                                  },
                                  "steps": {
                                    "type": "integer"
                                  },
                                  "title": {
                                    "type": "string"
                                  },
                                  "market": {},
                                  "variant": {
                                    "type": "string"
                                  },
                                  "warnings": {
                                    "type": "integer"
                                  },
                                  "also_covers": {},
                                  "duration_note": {},
                                  "machine_alert": {},
                                  "duration_minutes": {}
                                },
                                "additionalProperties": true
                              },
                              "label": {
                                "type": "string"
                              },
                              "value": {
                                "type": "string"
                              },
                              "status": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "trigger": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "schedule": {
                                "type": [
                                  "null",
                                  "object"
                                ],
                                "required": [],
                                "properties": {
                                  "every": {},
                                  "enabled": {
                                    "type": "boolean"
                                  },
                                  "muted_until": {}
                                },
                                "additionalProperties": true
                              },
                              "opened_by": {
                                "type": [
                                  "null",
                                  "string"
                                ]
                              },
                              "scheduled": {
                                "type": "boolean"
                              },
                              "offset_unit": {
                                "type": "string"
                              },
                              "every_source": {
                                "type": [
                                  "null",
                                  "object"
                                ],
                                "required": [],
                                "properties": {
                                  "days": {
                                    "type": "string"
                                  },
                                  "grams": {
                                    "type": "string"
                                  },
                                  "shots": {
                                    "type": "string"
                                  }
                                },
                                "additionalProperties": true
                              },
                              "disturbs_note": {
                                "type": "string"
                              },
                              "disturbs_zero": {
                                "type": "boolean"
                              },
                              "details_fields": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "required": [
                                    "key",
                                    "type",
                                    "label",
                                    "hint",
                                    "required"
                                  ],
                                  "properties": {
                                    "key": {
                                      "type": "string"
                                    },
                                    "hint": {
                                      "type": "string"
                                    },
                                    "type": {
                                      "type": "string"
                                    },
                                    "label": {
                                      "type": "string"
                                    },
                                    "required": {
                                      "type": "boolean"
                                    }
                                  },
                                  "additionalProperties": true
                                }
                              },
                              "details_version": {
                                "type": "integer"
                              },
                              "disturbs_prompt": {
                                "type": [
                                  "null",
                                  "string"
                                ]
                              },
                              "offset_integral": {
                                "type": "boolean"
                              }
                            },
                            "additionalProperties": true
                          }
                        },
                        "catalog": {
                          "type": "object",
                          "required": [
                            "id",
                            "brand",
                            "model",
                            "via",
                            "match",
                            "declined"
                          ],
                          "properties": {
                            "id": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "via": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "brand": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "match": {
                              "type": [
                                "null",
                                "object"
                              ],
                              "required": [],
                              "properties": {
                                "by": {
                                  "type": "string"
                                },
                                "id": {
                                  "type": "string"
                                },
                                "brand": {
                                  "type": "string"
                                },
                                "model": {
                                  "type": "string"
                                }
                              },
                              "additionalProperties": true
                            },
                            "model": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "declined": {
                              "type": "boolean"
                            }
                          },
                          "additionalProperties": true
                        },
                        "entries": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "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"
                            ],
                            "properties": {
                              "id": {
                                "type": "integer"
                              },
                              "note": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "task": {
                                "type": "string"
                              },
                              "details": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "required": [],
                                "properties": {
                                  "to": {
                                    "type": "object",
                                    "required": [
                                      "setting_scheme",
                                      "nominal_step",
                                      "components_spec"
                                    ],
                                    "properties": {
                                      "nominal_step": {
                                        "type": [
                                          "number",
                                          "integer"
                                        ]
                                      },
                                      "setting_scheme": {
                                        "type": "string"
                                      },
                                      "components_spec": {
                                        "type": [
                                          "null",
                                          "string"
                                        ]
                                      }
                                    },
                                    "additionalProperties": true
                                  },
                                  "from": {
                                    "type": "object",
                                    "required": [
                                      "setting_scheme",
                                      "nominal_step",
                                      "components_spec"
                                    ],
                                    "properties": {
                                      "nominal_step": {
                                        "type": [
                                          "number",
                                          "integer"
                                        ]
                                      },
                                      "setting_scheme": {
                                        "type": "string"
                                      },
                                      "components_spec": {
                                        "type": [
                                          "null",
                                          "string"
                                        ]
                                      }
                                    },
                                    "additionalProperties": true
                                  }
                                },
                                "additionalProperties": true
                              },
                              "evidence": {
                                "type": [
                                  "null",
                                  "string"
                                ]
                              },
                              "guide_id": {},
                              "offset_at": {
                                "type": [
                                  "null",
                                  "string"
                                ]
                              },
                              "created_at": {
                                "type": "string"
                              },
                              "task_label": {
                                "type": "string"
                              },
                              "equipment_id": {
                                "type": "integer"
                              },
                              "offset_value": {
                                "type": [
                                  "null",
                                  "integer"
                                ]
                              },
                              "performed_at": {
                                "type": "string"
                              },
                              "details_known": {
                                "type": "boolean"
                              },
                              "disturbs_zero": {
                                "type": "integer"
                              },
                              "offset_source": {
                                "type": [
                                  "null",
                                  "string"
                                ]
                              },
                              "equipment_kind": {
                                "type": "string"
                              },
                              "details_version": {
                                "type": "integer"
                              }
                            },
                            "additionalProperties": true
                          }
                        },
                        "hardness": {},
                        "calibration": {
                          "type": "object",
                          "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"
                          ],
                          "properties": {
                            "state": {
                              "type": "string"
                            },
                            "epoch_at": {
                              "type": [
                                "null",
                                "string"
                              ]
                            },
                            "epoch_id": {
                              "type": [
                                "null",
                                "integer"
                              ]
                            },
                            "evidence": {
                              "type": [
                                "null",
                                "string"
                              ]
                            },
                            "offset_at": {
                              "type": [
                                "null",
                                "string"
                              ]
                            },
                            "epoch_task": {
                              "type": [
                                "null",
                                "string"
                              ]
                            },
                            "offset_unit": {
                              "type": "string"
                            },
                            "offset_value": {
                              "type": [
                                "null",
                                "integer"
                              ]
                            },
                            "disturbs_note": {
                              "type": [
                                "null",
                                "string"
                              ]
                            },
                            "offset_source": {
                              "type": [
                                "null",
                                "string"
                              ]
                            },
                            "stale_recipe_count": {
                              "type": "integer"
                            },
                            "reference_recipe_id": {
                              "type": [
                                "null",
                                "integer"
                              ]
                            },
                            "untranslatable_recipe_count": {
                              "type": "integer"
                            }
                          },
                          "additionalProperties": true
                        },
                        "computed_at": {
                          "type": "string"
                        },
                        "sensitivity": {},
                        "entries_total": {
                          "type": "integer"
                        },
                        "catalog_version": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": true
                    },
                    "verified_at": {
                      "type": [
                        "null",
                        "string"
                      ]
                    },
                    "nominal_step": {
                      "type": [
                        "integer",
                        "number"
                      ]
                    },
                    "setting_label": {
                      "type": [
                        "null",
                        "string"
                      ]
                    },
                    "position_value": {
                      "type": [
                        "null",
                        "integer"
                      ]
                    },
                    "setting_scheme": {
                      "type": "string"
                    },
                    "components_spec": {
                      "type": [
                        "null",
                        "string"
                      ]
                    },
                    "microns_per_step": {
                      "type": [
                        "null",
                        "integer"
                      ]
                    },
                    "setting_components": {
                      "type": [
                        "null",
                        "string"
                      ]
                    },
                    "built_in_machine_id": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "direction_convention": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": true
                }
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_machines",
          "title": "List espresso machines",
          "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": {
            "type": "object",
            "properties": {
              "status": {
                "enum": [
                  "current",
                  "archived",
                  "all"
                ],
                "type": "string",
                "description": "Filter by status: current, archived, or all. Defaults to current."
              },
              "maintenance": {
                "enum": [
                  "compact",
                  "full"
                ],
                "type": "string",
                "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)."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "machines"
            ],
            "properties": {
              "machines": {
                "type": "array",
                "items": {
                  "type": "object",
                  "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"
                  ],
                  "properties": {
                    "id": {
                      "type": "integer"
                    },
                    "name": {
                      "type": "string"
                    },
                    "notes": {
                      "type": [
                        "null",
                        "string"
                      ]
                    },
                    "archived": {
                      "type": "integer"
                    },
                    "programs": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "id",
                          "program_number",
                          "program_type",
                          "target_volume_g",
                          "target_time_s",
                          "volume_source",
                          "description",
                          "is_active"
                        ],
                        "properties": {
                          "id": {
                            "type": "integer"
                          },
                          "is_active": {
                            "type": "integer"
                          },
                          "description": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "program_type": {
                            "type": "string"
                          },
                          "target_time_s": {},
                          "volume_source": {
                            "type": "string"
                          },
                          "program_number": {
                            "type": "integer"
                          },
                          "target_volume_g": {
                            "type": "integer"
                          }
                        },
                        "additionalProperties": true
                      }
                    },
                    "settings": {
                      "type": [
                        "array",
                        "null"
                      ],
                      "items": {
                        "type": "object",
                        "required": [
                          "key",
                          "label",
                          "type",
                          "options",
                          "min",
                          "max",
                          "step",
                          "unit",
                          "default",
                          "value",
                          "provenance"
                        ],
                        "properties": {
                          "key": {
                            "type": "string"
                          },
                          "max": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "min": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "step": {},
                          "type": {
                            "type": "string"
                          },
                          "unit": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "label": {
                            "type": "string"
                          },
                          "value": {
                            "type": [
                              "number",
                              "null",
                              "string"
                            ]
                          },
                          "default": {
                            "type": [
                              "number",
                              "null",
                              "string"
                            ]
                          },
                          "options": {
                            "type": [
                              "null",
                              "array"
                            ],
                            "items": {
                              "type": "object",
                              "required": [
                                "value",
                                "label",
                                "meaning"
                              ],
                              "properties": {
                                "label": {
                                  "type": "string"
                                },
                                "value": {
                                  "type": "string"
                                },
                                "meaning": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "provenance": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "required": [
                              "source",
                              "quote",
                              "default_source",
                              "default_quote"
                            ],
                            "properties": {
                              "quote": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "source": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "default_quote": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "default_source": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "additionalProperties": true
                          }
                        },
                        "additionalProperties": true
                      }
                    },
                    "prep_type": {
                      "type": "string"
                    },
                    "catalog_id": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "prep_style": {
                      "type": "string"
                    },
                    "tools_list": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "boiler_type": {
                      "type": [
                        "null",
                        "string"
                      ]
                    },
                    "hardness_dh": {
                      "type": [
                        "null",
                        "number"
                      ]
                    },
                    "maintenance": {
                      "type": "object",
                      "required": [
                        "tasks",
                        "due",
                        "calibration",
                        "sensitivity",
                        "entries",
                        "entries_total",
                        "catalog_version",
                        "computed_at",
                        "catalog",
                        "hardness"
                      ],
                      "properties": {
                        "due": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "required": [],
                          "properties": {},
                          "additionalProperties": {
                            "type": "object",
                            "required": [
                              "state",
                              "ratio",
                              "basis",
                              "every",
                              "done",
                              "remaining",
                              "lower_bound",
                              "soon",
                              "soon_at",
                              "due_at",
                              "overdue_at",
                              "last_at",
                              "every_source",
                              "muted",
                              "muted_until"
                            ],
                            "properties": {
                              "done": {
                                "type": [
                                  "null",
                                  "number",
                                  "integer"
                                ]
                              },
                              "soon": {
                                "type": "boolean"
                              },
                              "basis": {
                                "type": [
                                  "null",
                                  "string"
                                ]
                              },
                              "every": {
                                "type": [
                                  "null",
                                  "number",
                                  "integer"
                                ]
                              },
                              "muted": {
                                "type": "boolean"
                              },
                              "ratio": {
                                "type": [
                                  "integer",
                                  "number"
                                ]
                              },
                              "state": {
                                "type": "string"
                              },
                              "due_at": {
                                "type": [
                                  "null",
                                  "string"
                                ]
                              },
                              "last_at": {
                                "type": [
                                  "null",
                                  "string"
                                ]
                              },
                              "soon_at": {
                                "type": [
                                  "null",
                                  "string"
                                ]
                              },
                              "remaining": {
                                "type": [
                                  "null",
                                  "number",
                                  "integer"
                                ]
                              },
                              "overdue_at": {
                                "type": [
                                  "null",
                                  "string"
                                ]
                              },
                              "lower_bound": {
                                "type": "boolean"
                              },
                              "muted_until": {
                                "type": [
                                  "null",
                                  "string"
                                ]
                              },
                              "every_source": {
                                "type": [
                                  "null",
                                  "string"
                                ]
                              }
                            },
                            "additionalProperties": true
                          }
                        },
                        "tasks": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "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"
                            ],
                            "properties": {
                              "sub": {
                                "type": "string"
                              },
                              "why": {
                                "type": "string"
                              },
                              "kind": {
                                "type": "string"
                              },
                              "class": {
                                "type": "string"
                              },
                              "every": {
                                "type": [
                                  "null",
                                  "object"
                                ],
                                "required": [],
                                "properties": {
                                  "days": {
                                    "type": "integer"
                                  },
                                  "shots": {
                                    "type": "integer"
                                  },
                                  "litres": {
                                    "type": [
                                      "integer",
                                      "number"
                                    ]
                                  }
                                },
                                "additionalProperties": true
                              },
                              "guide": {
                                "type": [
                                  "null",
                                  "object"
                                ],
                                "required": [],
                                "properties": {
                                  "id": {
                                    "type": "string"
                                  },
                                  "basis": {
                                    "type": "string"
                                  },
                                  "scope": {
                                    "type": "string"
                                  },
                                  "steps": {
                                    "type": "integer"
                                  },
                                  "title": {
                                    "type": "string"
                                  },
                                  "market": {},
                                  "variant": {},
                                  "warnings": {
                                    "type": "integer"
                                  },
                                  "also_covers": {
                                    "type": [
                                      "array",
                                      "null"
                                    ],
                                    "items": {
                                      "type": "string"
                                    }
                                  },
                                  "duration_note": {},
                                  "machine_alert": {
                                    "type": [
                                      "null",
                                      "object"
                                    ],
                                    "required": [],
                                    "properties": {
                                      "clears": {
                                        "type": [
                                          "null",
                                          "string"
                                        ]
                                      },
                                      "counts": {
                                        "type": "string"
                                      },
                                      "source": {
                                        "type": "string"
                                      },
                                      "shown_as": {
                                        "type": "string"
                                      },
                                      "indicator": {
                                        "type": "string"
                                      },
                                      "threshold": {},
                                      "can_disable": {},
                                      "depends_on_setting": {}
                                    },
                                    "additionalProperties": true
                                  },
                                  "duration_minutes": {
                                    "type": [
                                      "null",
                                      "integer"
                                    ]
                                  }
                                },
                                "additionalProperties": true
                              },
                              "label": {
                                "type": "string"
                              },
                              "value": {
                                "type": "string"
                              },
                              "status": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "trigger": {
                                "type": [
                                  "null",
                                  "string"
                                ]
                              },
                              "schedule": {
                                "type": [
                                  "null",
                                  "object"
                                ],
                                "required": [],
                                "properties": {
                                  "every": {
                                    "type": "object",
                                    "required": [
                                      "litres"
                                    ],
                                    "properties": {
                                      "days": {
                                        "type": "integer"
                                      },
                                      "litres": {
                                        "type": "number"
                                      }
                                    },
                                    "additionalProperties": true
                                  },
                                  "enabled": {
                                    "type": "boolean"
                                  },
                                  "muted_until": {
                                    "type": [
                                      "string",
                                      "null"
                                    ]
                                  }
                                },
                                "additionalProperties": true
                              },
                              "opened_by": {},
                              "scheduled": {
                                "type": "boolean"
                              },
                              "offset_unit": {
                                "type": "string"
                              },
                              "every_source": {
                                "type": [
                                  "null",
                                  "object"
                                ],
                                "required": [],
                                "properties": {
                                  "days": {
                                    "type": "string"
                                  },
                                  "shots": {
                                    "type": "string"
                                  },
                                  "litres": {
                                    "type": "string"
                                  }
                                },
                                "additionalProperties": true
                              },
                              "disturbs_note": {
                                "type": "string"
                              },
                              "disturbs_zero": {
                                "type": "boolean"
                              },
                              "details_fields": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "required": [
                                    "key",
                                    "type",
                                    "label",
                                    "hint",
                                    "required"
                                  ],
                                  "properties": {
                                    "key": {
                                      "type": "string"
                                    },
                                    "hint": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "type": {
                                      "type": "string"
                                    },
                                    "label": {
                                      "type": "string"
                                    },
                                    "source": {
                                      "type": "string"
                                    },
                                    "options": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "required": [
                                          "id",
                                          "label"
                                        ],
                                        "properties": {
                                          "id": {
                                            "type": "string"
                                          },
                                          "label": {
                                            "type": "string"
                                          }
                                        },
                                        "additionalProperties": true
                                      }
                                    },
                                    "required": {
                                      "type": "boolean"
                                    }
                                  },
                                  "additionalProperties": true
                                }
                              },
                              "details_version": {
                                "type": "integer"
                              },
                              "disturbs_prompt": {},
                              "offset_integral": {
                                "type": "boolean"
                              }
                            },
                            "additionalProperties": true
                          }
                        },
                        "catalog": {
                          "type": "object",
                          "required": [
                            "id",
                            "brand",
                            "model",
                            "via",
                            "match",
                            "declined"
                          ],
                          "properties": {
                            "id": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "via": {},
                            "brand": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "match": {},
                            "model": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "declined": {
                              "type": "boolean"
                            }
                          },
                          "additionalProperties": true
                        },
                        "entries": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "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"
                            ],
                            "properties": {
                              "id": {
                                "type": "integer"
                              },
                              "note": {},
                              "task": {
                                "type": "string"
                              },
                              "details": {
                                "type": "object",
                                "required": [],
                                "properties": {
                                  "label": {
                                    "type": "string"
                                  },
                                  "product": {
                                    "type": "string"
                                  },
                                  "filter_id": {
                                    "type": "string"
                                  }
                                },
                                "additionalProperties": true
                              },
                              "evidence": {},
                              "guide_id": {
                                "type": [
                                  "null",
                                  "string"
                                ]
                              },
                              "offset_at": {},
                              "created_at": {
                                "type": "string"
                              },
                              "task_label": {
                                "type": "string"
                              },
                              "equipment_id": {
                                "type": "integer"
                              },
                              "offset_value": {},
                              "performed_at": {
                                "type": "string"
                              },
                              "details_known": {
                                "type": "boolean"
                              },
                              "disturbs_zero": {
                                "type": "integer"
                              },
                              "offset_source": {},
                              "equipment_kind": {
                                "type": "string"
                              },
                              "details_version": {
                                "type": "integer"
                              }
                            },
                            "additionalProperties": true
                          }
                        },
                        "hardness": {
                          "type": "object",
                          "required": [
                            "dh",
                            "dkh",
                            "source",
                            "dkh_source"
                          ],
                          "properties": {
                            "dh": {
                              "type": [
                                "null",
                                "number"
                              ]
                            },
                            "dkh": {
                              "type": [
                                "null",
                                "number"
                              ]
                            },
                            "source": {
                              "type": [
                                "null",
                                "string"
                              ]
                            },
                            "dkh_source": {
                              "type": [
                                "null",
                                "string"
                              ]
                            }
                          },
                          "additionalProperties": true
                        },
                        "calibration": {
                          "type": "object",
                          "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"
                          ],
                          "properties": {
                            "state": {
                              "type": "string"
                            },
                            "epoch_at": {},
                            "epoch_id": {},
                            "evidence": {},
                            "offset_at": {},
                            "epoch_task": {},
                            "offset_unit": {},
                            "offset_value": {},
                            "disturbs_note": {},
                            "offset_source": {},
                            "stale_recipe_count": {
                              "type": "integer"
                            },
                            "reference_recipe_id": {},
                            "untranslatable_recipe_count": {
                              "type": "integer"
                            }
                          },
                          "additionalProperties": true
                        },
                        "computed_at": {
                          "type": "string"
                        },
                        "sensitivity": {},
                        "entries_total": {
                          "type": "integer"
                        },
                        "catalog_version": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": true
                    },
                    "control_type": {
                      "type": "string"
                    },
                    "basket_size_grams": {
                      "type": [
                        "null",
                        "integer"
                      ]
                    },
                    "built_in_grinder_id": {
                      "type": [
                        "null",
                        "integer"
                      ]
                    }
                  },
                  "additionalProperties": true
                }
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_beans",
          "title": "List coffees",
          "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": {
            "type": "object",
            "properties": {
              "status": {
                "enum": [
                  "current",
                  "archived",
                  "all"
                ],
                "type": "string",
                "description": "Filter by status: current, archived, or all. Defaults to current."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "beans"
            ],
            "properties": {
              "beans": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "name",
                    "roaster",
                    "catalog_coffee_id",
                    "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",
                    "age_verdict_code",
                    "grams_remaining",
                    "days_since_opened",
                    "days_off_roast",
                    "frozen_days_excluded",
                    "current_bag_id",
                    "bags",
                    "origins"
                  ],
                  "properties": {
                    "id": {
                      "type": "integer"
                    },
                    "ean": {},
                    "url": {},
                    "bags": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "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",
                          "product_id",
                          "lot_revision_id",
                          "effective_age_days",
                          "age_verdict",
                          "age_verdict_code",
                          "grams_remaining",
                          "days_since_opened",
                          "days_off_roast",
                          "frozen_days_excluded"
                        ],
                        "properties": {
                          "id": {
                            "type": "integer"
                          },
                          "ean": {},
                          "cost": {
                            "type": [
                              "null",
                              "integer"
                            ]
                          },
                          "state": {
                            "type": "string"
                          },
                          "bean_id": {
                            "type": "integer"
                          },
                          "qr_code": {},
                          "storage": {},
                          "archived": {
                            "type": "integer"
                          },
                          "buy_date": {},
                          "currency": {
                            "type": [
                              "null",
                              "string"
                            ]
                          },
                          "finished": {
                            "type": "integer"
                          },
                          "bag_notes": {
                            "type": [
                              "null",
                              "string"
                            ]
                          },
                          "frozen_at": {},
                          "product_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "roast_date": {
                            "type": "string"
                          },
                          "age_verdict": {
                            "type": "string"
                          },
                          "frozen_note": {},
                          "opened_date": {},
                          "unfrozen_at": {},
                          "bag_weight_g": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "best_by_date": {},
                          "days_off_roast": {
                            "type": "integer"
                          },
                          "frozen_storage": {},
                          "grams_remaining": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "lot_revision_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "shots_remaining": {
                            "type": "integer"
                          },
                          "age_verdict_code": {
                            "type": "string"
                          },
                          "days_since_opened": {},
                          "effective_age_days": {
                            "type": "integer"
                          },
                          "weight_adjustment_g": {
                            "type": "integer"
                          },
                          "frozen_days_excluded": {
                            "type": "integer"
                          },
                          "shots_remaining_basis": {
                            "type": "string"
                          },
                          "shots_remaining_dose_g": {
                            "type": [
                              "integer",
                              "number"
                            ]
                          },
                          "shots_remaining_sample": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          }
                        },
                        "additionalProperties": true
                      }
                    },
                    "body": {},
                    "cost": {},
                    "name": {
                      "type": "string"
                    },
                    "notes": {
                      "type": [
                        "null",
                        "string"
                      ]
                    },
                    "state": {
                      "type": "string"
                    },
                    "origin": {},
                    "rating": {},
                    "acidity": {},
                    "origins": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "country",
                          "country_code",
                          "region",
                          "farm",
                          "farmer",
                          "variety",
                          "processing",
                          "elevation_m",
                          "elevation_max_m",
                          "harvest",
                          "percentage"
                        ],
                        "properties": {
                          "farm": {},
                          "farmer": {},
                          "region": {
                            "type": "string"
                          },
                          "country": {
                            "type": "string"
                          },
                          "harvest": {},
                          "variety": {
                            "type": "string"
                          },
                          "percentage": {
                            "type": "integer"
                          },
                          "processing": {},
                          "elevation_m": {},
                          "country_code": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "elevation_max_m": {}
                        },
                        "additionalProperties": true
                      }
                    },
                    "qr_code": {},
                    "roaster": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "storage": {},
                    "variety": {},
                    "archived": {
                      "type": "integer"
                    },
                    "buy_date": {},
                    "currency": {},
                    "finished": {
                      "type": "integer"
                    },
                    "aromatics": {},
                    "bag_notes": {
                      "type": [
                        "null",
                        "string"
                      ]
                    },
                    "favourite": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "frozen_at": {},
                    "sweetness": {},
                    "roast_date": {
                      "type": "string"
                    },
                    "age_verdict": {
                      "type": "string"
                    },
                    "arabica_pct": {},
                    "frozen_note": {},
                    "opened_date": {},
                    "roast_level": {
                      "type": "string"
                    },
                    "unfrozen_at": {},
                    "bag_weight_g": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "best_by_date": {},
                    "process_type": {
                      "type": "string"
                    },
                    "decaffeinated": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "dial_category": {
                      "type": "string"
                    },
                    "roasting_type": {},
                    "cupping_points": {},
                    "current_bag_id": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "days_off_roast": {
                      "type": "integer"
                    },
                    "frozen_storage": {},
                    "grams_remaining": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "shots_remaining": {
                      "type": "integer"
                    },
                    "age_verdict_code": {
                      "type": "string"
                    },
                    "catalog_coffee_id": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "days_since_opened": {},
                    "effective_age_days": {
                      "type": "integer"
                    },
                    "weight_adjustment_g": {
                      "type": "integer"
                    },
                    "frozen_days_excluded": {
                      "type": "integer"
                    },
                    "rest_window_days_max": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "rest_window_days_min": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "shots_remaining_basis": {
                      "type": "string"
                    },
                    "shots_remaining_dose_g": {
                      "type": [
                        "integer",
                        "number"
                      ]
                    },
                    "shots_remaining_sample": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    }
                  },
                  "additionalProperties": true
                }
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "grinder_math",
          "title": "Grinder math",
          "description": "Determine steps/clicks difference and directions between setting labels (C3).",
          "inputSchema": {
            "type": "object",
            "required": [
              "grinder_id",
              "from_label",
              "to_label"
            ],
            "properties": {
              "to_label": {
                "type": "string"
              },
              "from_label": {
                "type": "string"
              },
              "grinder_id": {
                "type": "integer"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "direction",
              "steps",
              "step_unit",
              "burr_gap_travel_microns",
              "relative_coarseness_note"
            ],
            "properties": {
              "steps": {
                "type": "integer"
              },
              "direction": {
                "type": "string"
              },
              "step_unit": {
                "type": "string"
              },
              "burr_gap_travel_microns": {
                "type": "integer"
              },
              "relative_coarseness_note": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "compute_age",
          "title": "Compute coffee age",
          "description": "Compute a bag's age in days off roast and its resting/staling verdict, for the coffee's current bag by default or for the bag named.",
          "inputSchema": {
            "type": "object",
            "required": [
              "bean_id"
            ],
            "properties": {
              "bag_id": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "A bag of that coffee (from list_beans' bags[]); null = its current bag"
              },
              "bean_id": {
                "type": "integer"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "bean_id",
              "bag_id",
              "roast_date",
              "age_days",
              "days_off_roast",
              "days_since_opened",
              "frozen_days_excluded",
              "effective_age_days",
              "rest_window",
              "verdict",
              "verdict_code",
              "grams_remaining",
              "warnings"
            ],
            "properties": {
              "bag_id": {
                "type": "integer"
              },
              "bean_id": {
                "type": "integer"
              },
              "verdict": {
                "type": "string"
              },
              "age_days": {
                "type": "integer"
              },
              "warnings": {
                "type": "array"
              },
              "roast_date": {
                "type": "string"
              },
              "rest_window": {
                "type": "string"
              },
              "verdict_code": {
                "type": "string"
              },
              "days_off_roast": {
                "type": "integer"
              },
              "grams_remaining": {},
              "days_since_opened": {},
              "effective_age_days": {
                "type": "integer"
              },
              "frozen_days_excluded": {
                "type": "integer"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "diagnose_shot",
          "title": "Diagnose a shot",
          "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": {
            "type": "object",
            "properties": {
              "shot_id": {
                "type": "integer",
                "description": "Optional shot ID; defaults to last pulled shot."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "category",
              "facts",
              "hypotheses",
              "warnings",
              "one_variable_only",
              "kb_version",
              "warning_codes",
              "bean_context"
            ],
            "properties": {
              "facts": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "text",
                    "source"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "source": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": true
                }
              },
              "category": {
                "type": "string"
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "hypotheses": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "cause",
                    "lever",
                    "direction",
                    "confidence",
                    "experiment",
                    "cited_rules"
                  ],
                  "properties": {
                    "cause": {
                      "type": "string"
                    },
                    "lever": {
                      "type": "string"
                    },
                    "direction": {
                      "type": "string"
                    },
                    "confidence": {
                      "type": "string"
                    },
                    "experiment": {
                      "type": "string"
                    },
                    "cited_rules": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "target_label": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": true
                }
              },
              "kb_version": {
                "type": "string"
              },
              "bean_context": {
                "type": "object",
                "required": [
                  "bean_id",
                  "bag_id",
                  "bean_name",
                  "roast_level",
                  "effective_age_days",
                  "dial_category"
                ],
                "properties": {
                  "bag_id": {
                    "type": "integer"
                  },
                  "bean_id": {
                    "type": "integer"
                  },
                  "bean_name": {
                    "type": "string"
                  },
                  "roast_level": {
                    "type": "string"
                  },
                  "dial_category": {
                    "type": "string"
                  },
                  "effective_age_days": {
                    "type": "integer"
                  }
                },
                "additionalProperties": true
              },
              "warning_codes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "one_variable_only": {
                "type": "boolean"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "suggest_next_step",
          "title": "Suggest the next step",
          "description": "Retrieve the single next experiment step from the reasoning engine.",
          "inputSchema": {
            "type": "object",
            "required": [
              "bean_id"
            ],
            "properties": {
              "bean_id": {
                "type": "integer"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "next_step",
              "category",
              "warnings",
              "warning_codes"
            ],
            "properties": {
              "category": {
                "type": "string"
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "next_step": {
                "type": "string"
              },
              "warning_codes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "log_recommendation",
          "title": "Log a recommendation",
          "description": "Log a recommended dialing change to allow contradiction/oscillation checking (G2).",
          "inputSchema": {
            "type": "object",
            "required": [
              "lever",
              "direction",
              "rationale",
              "confidence"
            ],
            "properties": {
              "lever": {
                "enum": [
                  "grind",
                  "yield",
                  "temp",
                  "program",
                  "prep",
                  "none"
                ],
                "type": "string"
              },
              "direction": {
                "enum": [
                  "finer",
                  "coarser",
                  "more",
                  "less",
                  "same"
                ],
                "type": "string"
              },
              "rationale": {
                "type": "string"
              },
              "confidence": {
                "enum": [
                  "low",
                  "medium",
                  "high"
                ],
                "type": "string"
              },
              "cited_rules": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "based_on_shot": {
                "type": "integer"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "message"
            ],
            "properties": {
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "get_rule",
          "title": "Get a dialing rule",
          "description": "Retrieve the detailed text of a specific rule from the knowledge base by its rule ID.",
          "inputSchema": {
            "type": "object",
            "required": [
              "rule_id"
            ],
            "properties": {
              "rule_id": {
                "type": "string",
                "description": "The ID of the rule to fetch, e.g. CAT.DARK"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "rule_id",
              "text"
            ],
            "properties": {
              "text": {
                "type": "string"
              },
              "rule_id": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_kb_version",
          "title": "Get knowledge base version",
          "description": "Retrieve the current version of the knowledge base.",
          "inputSchema": {
            "type": "object",
            "properties": {}
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "kb_version"
            ],
            "properties": {
              "kb_version": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "kb_changelog",
          "title": "Knowledge base changelog",
          "description": "Retrieve the changelog showing updates and version differences for the knowledge base.",
          "inputSchema": {
            "type": "object",
            "properties": {}
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "changelog"
            ],
            "properties": {
              "changelog": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "diagnose_preview",
          "title": "Preview a diagnosis",
          "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, for 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": {
            "type": "object",
            "properties": {
              "dose_g": {
                "type": "number",
                "description": "Dose in grams"
              },
              "rating": {
                "type": "integer",
                "description": "Stars 1 to 5, as tapped and not yet saved. With shot_id: replaces the stored rating for this preview (omit to use stored; 0 = unrated)."
              },
              "source": {
                "enum": [
                  "measured",
                  "recalled",
                  "assumed"
                ],
                "type": "string",
                "description": "Grinder position source. Affects G1 warning (raw mode only)"
              },
              "time_s": {
                "type": "number",
                "description": "Extraction time in seconds"
              },
              "bean_id": {
                "type": "integer",
                "description": "Coffee bean ID (must belong to this account)"
              },
              "shot_id": {
                "type": "integer",
                "description": "Preview a logged shot by ID (dry-run; ignores the metric params below)"
              },
              "yield_g": {
                "type": "number",
                "description": "Yield in grams"
              },
              "grinder_id": {
                "type": "integer",
                "description": "Grinder ID (must belong to this account)"
              },
              "machine_id": {
                "type": "integer",
                "description": "Machine ID (must belong to this account)"
              },
              "grind_label": {
                "type": "string",
                "description": "Grinder setting label, e.g. \"1.1.3\""
              },
              "sensory_tags": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Sensory observations, e.g. [\"sour\",\"bitter\"]. With shot_id: replaces the stored tags for this preview (omit to use stored; [] = none)."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "category",
              "facts",
              "hypotheses",
              "warnings",
              "one_variable_only",
              "kb_version",
              "warning_codes",
              "bean_context"
            ],
            "properties": {
              "facts": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "text",
                    "source"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "source": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": true
                }
              },
              "category": {
                "type": "string"
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "hypotheses": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "cause",
                    "lever",
                    "direction",
                    "confidence",
                    "experiment",
                    "cited_rules"
                  ],
                  "properties": {
                    "cause": {
                      "type": "string"
                    },
                    "lever": {
                      "type": "string"
                    },
                    "direction": {
                      "type": "string"
                    },
                    "confidence": {
                      "type": "string"
                    },
                    "experiment": {
                      "type": "string"
                    },
                    "cited_rules": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "target_label": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": true
                }
              },
              "kb_version": {
                "type": "string"
              },
              "bean_context": {
                "type": "object",
                "required": [
                  "bean_id",
                  "bag_id",
                  "bean_name",
                  "roast_level",
                  "effective_age_days",
                  "dial_category"
                ],
                "properties": {
                  "bag_id": {
                    "type": "integer"
                  },
                  "bean_id": {
                    "type": "integer"
                  },
                  "bean_name": {
                    "type": "string"
                  },
                  "roast_level": {
                    "type": "string"
                  },
                  "dial_category": {
                    "type": "string"
                  },
                  "effective_age_days": {
                    "type": "integer"
                  }
                },
                "additionalProperties": true
              },
              "warning_codes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "one_variable_only": {
                "type": "boolean"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_shots",
          "title": "List shots",
          "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": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer",
                "default": 50,
                "maximum": 500,
                "minimum": 1,
                "description": "Number of records to return (1-500)"
              },
              "offset": {
                "type": "integer",
                "default": 0,
                "minimum": 0,
                "description": "Offset for pagination"
              },
              "filters": {
                "type": "object",
                "properties": {
                  "best": {
                    "enum": [
                      0,
                      1
                    ],
                    "type": "integer",
                    "description": "Filter by best brew status"
                  },
                  "bag_id": {
                    "type": "integer",
                    "description": "Filter by bag number (one purchase of a coffee)"
                  },
                  "bean_id": {
                    "type": "integer",
                    "description": "Filter by coffee bean ID"
                  },
                  "date_to": {
                    "type": "string",
                    "description": "Filter shots pulled on or before YYYY-MM-DD"
                  },
                  "date_from": {
                    "type": "string",
                    "description": "Filter shots pulled on or after YYYY-MM-DD"
                  },
                  "favourite": {
                    "enum": [
                      0,
                      1
                    ],
                    "type": "integer",
                    "description": "Filter by favourite status"
                  },
                  "grinder_id": {
                    "type": "integer",
                    "description": "Filter by grinder ID"
                  },
                  "machine_id": {
                    "type": "integer",
                    "description": "Filter by machine ID"
                  },
                  "taste_pending": {
                    "enum": [
                      0,
                      1
                    ],
                    "type": "integer",
                    "description": "1 = shots logged without sensory tags, a rating, or the tasted flip (tasting still owed); 0 = tasted shots"
                  }
                }
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "shots",
              "total"
            ],
            "properties": {
              "shots": {
                "type": "array",
                "items": {
                  "type": "object",
                  "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"
                  ],
                  "properties": {
                    "id": {
                      "type": "integer"
                    },
                    "tds": {},
                    "bag_id": {
                      "type": "integer"
                    },
                    "dose_g": {
                      "type": "integer"
                    },
                    "ey_pct": {},
                    "rating": {},
                    "tasted": {
                      "type": "integer"
                    },
                    "time_s": {
                      "type": "integer"
                    },
                    "bean_id": {
                      "type": "integer"
                    },
                    "verdict": {},
                    "yield_g": {
                      "type": "integer"
                    },
                    "water_id": {},
                    "bean_name": {
                      "type": "string"
                    },
                    "best_brew": {
                      "type": "integer"
                    },
                    "favourite": {
                      "type": "integer"
                    },
                    "pulled_at": {
                      "type": "string"
                    },
                    "beverage_g": {},
                    "grinder_id": {
                      "type": "integer"
                    },
                    "machine_id": {
                      "type": "integer"
                    },
                    "program_id": {},
                    "temp_taste": {
                      "type": "string"
                    },
                    "grind_label": {
                      "type": "string"
                    },
                    "vessel_name": {},
                    "bloom_time_s": {},
                    "drink_intent": {
                      "type": "string"
                    },
                    "flavor_notes": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "observations": {
                      "type": "string"
                    },
                    "sensory_tags": {
                      "type": "string"
                    },
                    "finish_action": {
                      "type": "string"
                    },
                    "flow_rate_gps": {
                      "type": "number"
                    },
                    "taste_pending": {
                      "type": "integer"
                    },
                    "temperature_c": {},
                    "data_confidence": {
                      "type": "string"
                    },
                    "vessel_weight_g": {},
                    "grind_components": {
                      "type": "string"
                    },
                    "machine_settings": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "additionalProperties": true
                    },
                    "first_drip_time_s": {},
                    "grind_position_value": {
                      "type": "integer"
                    }
                  },
                  "additionalProperties": true
                }
              },
              "total": {
                "type": "integer"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "register_bag",
          "title": "Register a bag",
          "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": {
            "type": "object",
            "required": [
              "bean_id",
              "roast_date"
            ],
            "properties": {
              "ean": {
                "type": "string"
              },
              "cost": {
                "type": "number"
              },
              "state": {
                "enum": [
                  "sealed",
                  "open",
                  "frozen",
                  "finished"
                ],
                "type": "string",
                "description": "Defaults to sealed; the first log_shot against it opens it"
              },
              "bean_id": {
                "type": "integer",
                "description": "This account's own coffee number, from list_beans. Never guess one."
              },
              "qr_code": {
                "type": "string"
              },
              "storage": {
                "type": "string"
              },
              "buy_date": {
                "type": "string",
                "description": "Calendar day in YYYY-MM-DD format: a day, not a timestamp"
              },
              "currency": {
                "type": "string"
              },
              "bag_notes": {
                "type": "string",
                "maxLength": 4096,
                "description": "Notes about THIS bag (a batch note, where it was bought). The coffee's own description lives on the coffee, in notes."
              },
              "product_id": {
                "type": "string",
                "description": "Set by the apps. Leave out."
              },
              "roast_date": {
                "type": "string",
                "description": "Calendar day in YYYY-MM-DD format: a day, not a timestamp"
              },
              "opened_date": {
                "type": "string",
                "description": "Calendar day in YYYY-MM-DD format: a day, not a timestamp"
              },
              "bag_weight_g": {
                "type": "number",
                "description": "Bag weight in grams"
              },
              "best_by_date": {
                "type": "string",
                "description": "Calendar day in YYYY-MM-DD format: a day, not a timestamp"
              },
              "lot_revision_id": {
                "type": "string",
                "description": "Set by the apps. Leave out."
              },
              "catalog_coffee_id": {
                "type": "string",
                "description": "Set by the apps. Leave out."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "bag_id",
              "bean_id",
              "message"
            ],
            "properties": {
              "bag_id": {
                "type": "integer"
              },
              "status": {
                "type": "string"
              },
              "bean_id": {
                "type": "integer"
              },
              "message": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "update_bag",
          "title": "Update a bag",
          "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": {
            "type": "object",
            "required": [
              "bag_id",
              "fields"
            ],
            "properties": {
              "bag_id": {
                "type": "integer",
                "description": "This account's own bag number, from list_beans' bags[]. Never guess one."
              },
              "fields": {
                "type": "object",
                "properties": {
                  "ean": {
                    "type": "string"
                  },
                  "cost": {
                    "type": "number"
                  },
                  "state": {
                    "enum": [
                      "sealed",
                      "open",
                      "frozen",
                      "finished"
                    ],
                    "type": "string"
                  },
                  "qr_code": {
                    "type": "string"
                  },
                  "storage": {
                    "type": "string"
                  },
                  "buy_date": {
                    "type": "string",
                    "description": "Calendar day in YYYY-MM-DD format: a day, not a timestamp"
                  },
                  "currency": {
                    "type": "string"
                  },
                  "finished": {
                    "type": "integer",
                    "description": "1 if finished, 0 otherwise"
                  },
                  "bag_notes": {
                    "type": "string",
                    "maxLength": 4096
                  },
                  "frozen_at": {
                    "type": "string",
                    "description": "Calendar day the bag went into the freezer, YYYY-MM-DD: a day, not a timestamp"
                  },
                  "roast_date": {
                    "type": "string",
                    "description": "Calendar day in YYYY-MM-DD format: a day, not a timestamp"
                  },
                  "frozen_note": {
                    "type": "string"
                  },
                  "opened_date": {
                    "type": "string",
                    "description": "Calendar day in YYYY-MM-DD format: a day, not a timestamp"
                  },
                  "unfrozen_at": {
                    "type": "string",
                    "description": "Calendar day the bag came out, YYYY-MM-DD: a day, not a timestamp"
                  },
                  "bag_weight_g": {
                    "type": "number",
                    "description": "Bag weight in grams"
                  },
                  "best_by_date": {
                    "type": "string",
                    "description": "Calendar day in YYYY-MM-DD format: a day, not a timestamp"
                  },
                  "frozen_storage": {
                    "type": "string"
                  },
                  "grams_remaining": {
                    "type": "number",
                    "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."
                  },
                  "weight_adjustment_g": {
                    "type": "number",
                    "description": "Grams consumed or lost OUTSIDE logged shots (spillage, unlogged brews). grams_remaining = bag_weight_g − logged doses − this. Negative adds weight back."
                  }
                }
              },
              "reason": {
                "type": "string",
                "description": "Optional free-text note, appended to this bag's notes as an ordinary line. Omit it and nothing is written."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "message"
            ],
            "properties": {
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "merge_beans",
          "title": "Merge two coffees",
          "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": {
            "type": "object",
            "required": [
              "from_bean_id",
              "into_bean_id"
            ],
            "properties": {
              "reason": {
                "type": "string",
                "description": "Optional note, recorded on the surviving coffee's notes with the merge"
              },
              "from_bean_id": {
                "type": "integer",
                "description": "The duplicate: the coffee number that will be emptied and archived"
              },
              "into_bean_id": {
                "type": "integer",
                "description": "The coffee number that keeps everything"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "into_bean_id",
              "moved",
              "replaced_recipes",
              "active_followed",
              "message"
            ],
            "properties": {
              "moved": {
                "type": "object",
                "required": [
                  "bags",
                  "shots",
                  "recipes",
                  "recommendations"
                ],
                "properties": {
                  "bags": {
                    "type": "integer"
                  },
                  "shots": {
                    "type": "integer"
                  },
                  "recipes": {
                    "type": "integer"
                  },
                  "recommendations": {
                    "type": "integer"
                  }
                },
                "additionalProperties": true
              },
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "into_bean_id": {
                "type": "integer"
              },
              "active_followed": {
                "type": "boolean"
              },
              "replaced_recipes": {
                "type": "integer"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [
        {
          "name": "locked-recipes",
          "uri": "coffee://recipes/locked",
          "description": "List of all authoritatively dialed and locked recipes."
        },
        {
          "name": "current-dialing-state",
          "uri": "coffee://state/current",
          "description": "The active coffee bean, active grinder position, and machine context."
        }
      ],
      "prompts": [
        {
          "name": "dial_in_coffee",
          "description": "Prepares the AI system to dial in coffee.",
          "arguments": []
        },
        {
          "name": "new_bag_intake",
          "description": "Prompts the user to register a bag, whether of a coffee already on file (register_bag) or of a new one (register_coffee).",
          "arguments": []
        },
        {
          "name": "compare_two_coffees",
          "description": "Compares dialing characteristics and historical shot behaviors between two coffee beans.",
          "arguments": []
        }
      ]
    },
    "instructions": null
  },
  "changes": {
    "total": 1,
    "latest": [
      {
        "observed_at": "2026-11-22T16:24:03.320Z",
        "from_sha": "de1a445d6c10b7d18f252030d2cceb9c6ad2579d7a552f005541133c154fc855",
        "to_sha": "96628d8d9863f1f7217d26f0ec4b336818704b686f4643fb988b30993696f67a",
        "summary": {
          "tool_added": 1
        },
        "diff": [
          {
            "op": "added",
            "kind": "tool",
            "name": "diagnose_preview",
            "path": "/inputSchema/properties/rating",
            "after": {
              "type": "integer",
              "description": "Stars 1 to 5, as tapped and not yet saved. With shot_id: replaces the stored rating for this preview (omit to use stored; 0 = unrated)."
            }
          }
        ],
        "withheld": false
      }
    ]
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}