Skip to main content
Glama

RestaurantDoctorAI

Break-even calculator

restaurantdoctor_break_even
Read-onlyIdempotent

Works out a restaurant's break-even sales from the owner's figures for one typical month, as the free break-even calculator on restaurantdoctorai.com does: the sales a month needs to pay every bill, also a week, a day open and guests a day; how far the month was above or short of it; what was left over after every bill; what a point of cost moves it by; with and without the owner's own pay; and if prices were 10% lower or higher (an illustration). Hourly pay can rise with sales or stay fixed, or both ways as a range. Takes the month's figures in any currency; a figure not sent is never counted as 0. Returns the result, the working and a link that opens the calculator with the figures in. The figures aren't stored; only an anonymous daily count of calculator runs is kept.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "restaurantdoctor_break_even"
  }
}

Input Schema

NameRequiredDescriptionDefault
goalNo
salesNo
hourlyNounsure
ownerPayNo
hourlyPayNo
purchasesNo
fixedBillsNo
daysPerWeekNo
averageSpendNo
closingStockNo
openingStockNo
otherVariableNo

Output Schema

NameRequiredDescriptionDefault
linkYesOpens the calculator with these figures.
notesYes
checksYesFigures that look like a slip.
hourlyYes
resultYesThe page's result, line by line.
whatIfYes
figuresYesA month, in the currency of the figures sent.
leftOverYesLeft over after every bill and ownerPay at these sales, before income tax: below 0 when short. Not profit.
standingYesNet sales against break-even (at: almost exactly; never: no break-even either way).
freeCheckYes
scenariosYesHourly pay one way, or both (rising first).
workedOutYesHow it was worked out.
daysAMonthYes
pointValueYes1% of sales: what a point of cost saved leaves a month.
usedStockCountsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed27 schema fields changed
    • changedInput schema / properties / averageSpend / anyOf
      Previous value: -[
      -  {
      -    "description": "Optional: average spend per guest, the POS average check or net sales ÷ guests or orders. Turns sales into guests.",
      -    "maximum": 1000000000,
      -    "minimum": 0,
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Optional: average spend per guest, the POS average check or net sales ÷ guests. Turns sales into guests.",
      +    "maximum": 1000000000,
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / daysPerWeek / anyOf
      Previous value: -[
      -  {
      -    "description": "Optional: days open a week, a whole number from 1 to 7. Turns the month into sales a day open (and guests a day, with averageSpend); left out, the day figures are left out.",
      -    "maximum": 7,
      -    "minimum": 1,
      -    "type": "integer"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Optional: days open a week, a whole number from 1 to 7. Turns the month into a day open (and guests a day, with averageSpend).",
      +    "maximum": 7,
      +    "minimum": 1,
      +    "type": "integer"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / fixedBills / anyOf
      Previous value: -[
      -  {
      -    "description": "A month of the bills that stay the same however busy it is: rent and utilities, salaries with their payroll taxes and benefits, insurance, software, marketing, loan and lease payments in full, and the owner's own pay if it isn't on payroll (left out, break-even assumes they work for free). No depreciation. Yearly bills ÷ 12. Needed for a result; if missing, the reply asks for it.",
      -    "maximum": 1000000000,
      -    "minimum": 0,
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "A month of the bills that stay the same: rent and utilities, salaries with their payroll taxes and benefits, insurance, software, marketing, loan and lease payments in full. No depreciation. Yearly bills ÷ 12. Not the owner's pay. Needed; if missing, the reply asks for it.",
      +    "maximum": 1000000000,
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / goal / anyOf
      Previous value: -[
      -  {
      -    "description": "Optional: what the owner would like left over each month after every bill, before income tax. Adds the sales a month that would take.",
      -    "maximum": 1000000000,
      -    "minimum": 0,
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Optional: what the owner would like left over a month after every bill, before income tax. Adds the sales for it.",
      +    "maximum": 1000000000,
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / hourly / anyOf
      Previous value: -[
      -  {
      -    "description": "Whether hourly staff time goes up and down with sales: yes if shifts are added and cut as it gets busy or quiet; no if about the same team works every shift, so hourly pay is a bill that stays the same; unsure (the default) works it out both ways, as a range.",
      -    "enum": [
      -      "yes",
      -      "no",
      -      "unsure"
      -    ],
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Whether hourly staff time goes up and down with sales: yes, shifts are added and cut as it gets busy or quiet; no, about the same team every shift (a bill that stays the same); unsure (the default): both ways, as a range.",
      +    "enum": [
      +      "yes",
      +      "no",
      +      "unsure"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / hourlyPay / anyOf
      Previous value: -[
      -  {
      -    "description": "That month's hourly wages from payroll, plus the employer's payroll taxes and benefits on them; no tips. Paid every two weeks: one pay run × 26 ÷ 12. Needed for a result (0 with no hourly staff); if missing, the reply asks for it.",
      -    "maximum": 1000000000,
      -    "minimum": 0,
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "That month's hourly wages from payroll, plus the employer's payroll taxes and benefits; no tips. Paid every two weeks: one pay run × 26 ÷ 12. Needed (0 with no hourly staff); if missing, the reply asks for it.",
      +    "maximum": 1000000000,
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / openingStock / anyOf
      Previous value: -[
      -  {
      -    "description": "Optional: stock at cost at the start of the month. Used only with closingStock: food and drink then becomes what was used, opening + purchases - closing. Skip both if stock stayed about the same.",
      -    "maximum": 1000000000,
      -    "minimum": 0,
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Optional: stock at cost at the start of the month. Used only with closingStock: food and drink is then opening + purchases - closing. Skip both if stock stayed steady.",
      +    "maximum": 1000000000,
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / otherVariable / anyOf
      Previous value: -[
      -  {
      -    "description": "That month's other costs that rise with every sale: card fees, delivery app commissions (app sales minus payouts, both without tax and tips), to-go packaging, any percentage rent, royalties or ad fund fees. Nothing already in the food and drink invoices. Needed for a result (0 if none); if missing, the reply asks for it.",
      -    "maximum": 1000000000,
      -    "minimum": 0,
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "That month's other costs that rise with every sale: card fees, app commissions (app sales minus payouts, without tax and tips), packaging, percentage rent, royalties, ad fund fees; nothing in the food and drink invoices. Needed (0 if none); if missing, the reply asks for it.",
      +    "maximum": 1000000000,
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / ownerPay
      Added value: +{
      +  "anyOf": [
      +    {
      +      "description": "Optional: the owner's own pay a month, if not on payroll. Counted as a bill; break-even is also given without it.",
      +      "maximum": 1000000000,
      +      "minimum": 0,
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • changedInput schema / properties / purchases / anyOf
      Previous value: -[
      -  {
      -    "description": "That month's food and drink supplier invoices, added up by delivery date. Needed for a result; if missing, the reply asks for it.",
      -    "maximum": 1000000000,
      -    "minimum": 0,
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "That month's food and drink supplier invoices, by delivery date. Needed; if missing, the reply asks for it.",
      +    "maximum": 1000000000,
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / sales / anyOf
      Previous value: -[
      -  {
      -    "description": "Net sales for one typical month, in the owner's own currency like every figure here: the POS sales summary, before tax and tips, delivery app orders at menu price. Not a holiday rush or a one-off: every figure is for that same month. Needed for a result, and more than 0; if missing, the reply asks for it.",
      -    "maximum": 1000000000,
      -    "minimum": 0,
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Net sales for one typical month, in the owner's own currency: the POS sales summary, before tax and tips, app orders at menu price. Not a holiday rush: every figure is for that month. Needed, more than 0; if missing, the reply asks for it.",
      +    "maximum": 1000000000,
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / checks / description
      Previous value: -"Figures that look like a slip, as the page flags them."New value: +"Figures that look like a slip."
    • changedOutput schema / properties / figures / properties / foodAndDrink / description
      Previous value: -"Used: opening + purchases - closing with both stock counts, else purchases."New value: +"Opening + purchases - closing with both stock counts, else purchases."
    • addedOutput schema / properties / figures / properties / ownerPay
      Added value: +{
      +  "anyOf": [
      +    {
      +      "description": "Null: not sent.",
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • changedOutput schema / properties / figures / required
      Previous value: -[
      -  "sales",
      -  "foodAndDrink",
      -  "hourlyPay",
      -  "otherVariable",
      -  "fixedBills"
      -]New value: +[
      +  "sales",
      +  "foodAndDrink",
      +  "hourlyPay",
      +  "otherVariable",
      +  "fixedBills",
      +  "ownerPay"
      +]
    • changedOutput schema / properties / leftOver / description
      Previous value: -"Left over after every bill at this month's sales, before income tax, to the unit: below 0 when short. Never call it profit."New value: +"Left over after every bill and ownerPay at these sales, before income tax: below 0 when short. Not profit."
    • changedOutput schema / properties / pointValue / description
      Previous value: -"1% of sales, to the unit: what each point of cost saved leaves a month."New value: +"1% of sales: what a point of cost saved leaves a month."
    • changedOutput schema / properties / result / description
      Previous value: -"The result in the page's words, in its order."New value: +"The page's result, line by line."
    • changedOutput schema / properties / scenarios / description
      Previous value: -"Hourly pay one way, or both (rising first) when the owner isn't sure and has hourly pay."New value: +"Hourly pay one way, or both (rising first)."
    • changedOutput schema / properties / scenarios / items / properties / breakEven / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "description": "Sales and guests rounded up to the unit, the rest to the nearest, as the page shows them. Null: no amount of sales breaks even this way.",
      -    "properties": {
      -      "cushion": {
      -        "description": "Net sales minus break-even: below 0 when short.",
      -        "type": "number"
      -      },
      -      "cushionPct": {
      -        "description": "The cushion, % of net sales, one decimal.",
      -        "type": "number"
      -      },
      -      "dayOpen": {
      -        "anyOf": [
      -          {
      -            "description": "Needs daysPerWeek.",
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "goalSales": {
      -        "anyOf": [
      -          {
      -            "description": "Sales a month to have the goal left over. Needs goal.",
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "guestsADay": {
      -        "anyOf": [
      -          {
      -            "description": "Needs daysPerWeek and averageSpend.",
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "guestsAMonth": {
      -        "anyOf": [
      -          {
      -            "description": "Needs averageSpend.",
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "monthly": {
      -        "type": "number"
      -      },
      -      "moreGuestsADay": {
      -        "anyOf": [
      -          {
      -            "description": "When short, with daysPerWeek and averageSpend: the guests a day that close it.",
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "perThousandOffBills": {
      -        "description": "The same, for each 1,000 a month off fixedBills.",
      -        "type": "number"
      -      },
      -      "pointOffFixed": {
      -        "description": "The same, for one point off a fixed bill (salaries).",
      -        "type": "number"
      -      },
      -      "pointOffRising": {
      -        "description": "How far break-even falls a month for one point of sales off a rising cost.",
      -        "type": "number"
      -      },
      -      "shortADayOpen": {
      -        "anyOf": [
      -          {
      -            "description": "When short, with daysPerWeek: the gap a day open.",
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "weekly": {
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "monthly",
      -      "weekly",
      -      "dayOpen",
      -      "guestsADay",
      -      "guestsAMonth",
      -      "cushion",
      -      "cushionPct",
      -      "shortADayOpen",
      -      "moreGuestsADay",
      -      "goalSales",
      -      "pointOffRising",
      -      "pointOffFixed",
      -      "perThousandOffBills"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "description": "Sales and guests rounded up, the rest to the nearest unit. Null: never breaks even this way.",
      +    "properties": {
      +      "cushion": {
      +        "description": "Net sales minus break-even.",
      +        "type": "number"
      +      },
      +      "cushionPct": {
      +        "description": "The cushion, % of net sales.",
      +        "type": "number"
      +      },
      +      "dayOpen": {
      +        "anyOf": [
      +          {
      +            "description": "Needs daysPerWeek.",
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "goalSales": {
      +        "anyOf": [
      +          {
      +            "description": "Sales a month for the goal. Needs goal.",
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "guestsADay": {
      +        "anyOf": [
      +          {
      +            "description": "Needs daysPerWeek and averageSpend.",
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "guestsADayWithoutPay": {
      +        "anyOf": [
      +          {
      +            "description": "Needs ownerPay, daysPerWeek, averageSpend.",
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "guestsAMonth": {
      +        "anyOf": [
      +          {
      +            "description": "Needs averageSpend.",
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "monthly": {
      +        "type": "number"
      +      },
      +      "moreGuestsADay": {
      +        "anyOf": [
      +          {
      +            "description": "When short, with daysPerWeek and averageSpend: guests a day to close it.",
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "perThousandOffBills": {
      +        "description": "The same, 1,000 a month off the bills.",
      +        "type": "number"
      +      },
      +      "pointOffFixed": {
      +        "description": "The same, a point off a fixed bill.",
      +        "type": "number"
      +      },
      +      "pointOffRising": {
      +        "description": "Fall in break-even for a point of sales off a rising cost.",
      +        "type": "number"
      +      },
      +      "shortADayOpen": {
      +        "anyOf": [
      +          {
      +            "description": "When short, with daysPerWeek: the gap a day open.",
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "weekly": {
      +        "type": "number"
      +      },
      +      "withoutPay": {
      +        "anyOf": [
      +          {
      +            "description": "Without ownerPay. Needs it.",
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "required": [
      +      "monthly",
      +      "weekly",
      +      "dayOpen",
      +      "guestsADay",
      +      "guestsAMonth",
      +      "withoutPay",
      +      "guestsADayWithoutPay",
      +      "cushion",
      +      "cushionPct",
      +      "shortADayOpen",
      +      "moreGuestsADay",
      +      "goalSales",
      +      "pointOffRising",
      +      "pointOffFixed",
      +      "perThousandOffBills"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / scenarios / items / properties / costsThatRisePct / description
      Previous value: -"% of net sales, one decimal. At 100 or more, no amount of sales breaks even."New value: +"% of net sales. At 100 or more, it never breaks even."
    • changedOutput schema / properties / scenarios / items / properties / hourlyPay / description
      Previous value: -"With the costs that rise with sales, or as a fixed bill."New value: +"Rising with sales, or a fixed bill."
    • addedOutput schema / properties / scenarios / items / properties / prices
      Added value: +{
      +  "description": "Prices -10%, as now, +10%: same guests, plates, hourly pay, bills. An illustration.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "changePct": {
      +        "type": "number"
      +      },
      +      "guestsADay": {
      +        "anyOf": [
      +          {
      +            "description": "Needs daysPerWeek, averageSpend.",
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "monthly": {
      +        "anyOf": [
      +          {
      +            "description": "Null: never.",
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "required": [
      +      "changePct",
      +      "monthly",
      +      "guestsADay"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / scenarios / items / required
      Previous value: -[
      -  "hourlyPay",
      -  "costsThatRisePct",
      -  "breakEven"
      -]New value: +[
      +  "hourlyPay",
      +  "costsThatRisePct",
      +  "breakEven",
      +  "prices"
      +]
    • changedOutput schema / properties / standing / description
      Previous value: -"Net sales against break-even (at: almost exactly); never: no amount of sales breaks even, either way."New value: +"Net sales against break-even (at: almost exactly; never: no break-even either way)."
    • addedOutput schema / properties / whatIf
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "hourly",
      -  "standing",
      -  "figures",
      -  "usedStockCounts",
      -  "daysAMonth",
      -  "scenarios",
      -  "leftOver",
      -  "pointValue",
      -  "result",
      -  "checks",
      -  "notes",
      -  "workedOut",
      -  "link",
      -  "freeCheck"
      -]New value: +[
      +  "hourly",
      +  "standing",
      +  "figures",
      +  "usedStockCounts",
      +  "daysAMonth",
      +  "scenarios",
      +  "leftOver",
      +  "pointValue",
      +  "result",
      +  "checks",
      +  "whatIf",
      +  "notes",
      +  "workedOut",
      +  "link",
      +  "freeCheck"
      +]
  2. Changed63 schema fields changed
    • addedInput schema / properties / averageSpend / anyOf
      Added value: +[
      +  {
      +    "description": "Optional: average spend per guest, the POS average check or net sales ÷ guests or orders. Turns sales into guests.",
      +    "maximum": 1000000000,
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / averageSpend / description
      Removed value: -"Optional: average spend per guest, the POS average check or net sales ÷ guests or orders. Turns sales into guests."
    • removedInput schema / properties / averageSpend / maximum
      Removed value: -1000000000
    • removedInput schema / properties / averageSpend / minimum
      Removed value: -0
    • removedInput schema / properties / averageSpend / type
      Removed value: -"number"
    • addedInput schema / properties / closingStock / anyOf
      Added value: +[
      +  {
      +    "description": "Optional: stock at cost at the end of the month. Used only with openingStock.",
      +    "maximum": 1000000000,
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / closingStock / description
      Removed value: -"Optional: stock at cost at the end of the month. Used only with openingStock."
    • removedInput schema / properties / closingStock / maximum
      Removed value: -1000000000
    • removedInput schema / properties / closingStock / minimum
      Removed value: -0
    • removedInput schema / properties / closingStock / type
      Removed value: -"number"
    • addedInput schema / properties / daysPerWeek / anyOf
      Added value: +[
      +  {
      +    "description": "Optional: days open a week, a whole number from 1 to 7. Turns the month into sales a day open (and guests a day, with averageSpend); left out, the day figures are left out.",
      +    "maximum": 7,
      +    "minimum": 1,
      +    "type": "integer"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / daysPerWeek / description
      Removed value: -"Optional: days open a week, a whole number from 1 to 7. Turns the month into sales a day open (and guests a day, with averageSpend); left out, the day figures are left out."
    • removedInput schema / properties / daysPerWeek / maximum
      Removed value: -7
    • removedInput schema / properties / daysPerWeek / minimum
      Removed value: -1
    • removedInput schema / properties / daysPerWeek / type
      Removed value: -"integer"
    • addedInput schema / properties / fixedBills / anyOf
      Added value: +[
      +  {
      +    "description": "A month of the bills that stay the same however busy it is: rent and utilities, salaries with their payroll taxes and benefits, insurance, software, marketing, loan and lease payments in full, and the owner's own pay if it isn't on payroll (left out, break-even assumes they work for free). No depreciation. Yearly bills ÷ 12. Needed for a result; if missing, the reply asks for it.",
      +    "maximum": 1000000000,
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / fixedBills / description
      Removed value: -"A month of the bills that stay the same however busy it is: rent and utilities, salaries with their payroll taxes and benefits, insurance, software, marketing, loan and lease payments in full, and the owner's own pay if it isn't on payroll (left out, break-even assumes they work for free). No depreciation. Yearly bills ÷ 12. Needed for a result; if missing, the reply asks for it."
    • removedInput schema / properties / fixedBills / maximum
      Removed value: -1000000000
    • removedInput schema / properties / fixedBills / minimum
      Removed value: -0
    • removedInput schema / properties / fixedBills / type
      Removed value: -"number"
    • addedInput schema / properties / goal / anyOf
      Added value: +[
      +  {
      +    "description": "Optional: what the owner would like left over each month after every bill, before income tax. Adds the sales a month that would take.",
      +    "maximum": 1000000000,
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / goal / description
      Removed value: -"Optional: what the owner would like left over each month after every bill, before income tax. Adds the sales a month that would take."
    • removedInput schema / properties / goal / maximum
      Removed value: -1000000000
    • removedInput schema / properties / goal / minimum
      Removed value: -0
    • removedInput schema / properties / goal / type
      Removed value: -"number"
    • addedInput schema / properties / hourly / anyOf
      Added value: +[
      +  {
      +    "description": "Whether hourly staff time goes up and down with sales: yes if shifts are added and cut as it gets busy or quiet; no if about the same team works every shift, so hourly pay is a bill that stays the same; unsure (the default) works it out both ways, as a range.",
      +    "enum": [
      +      "yes",
      +      "no",
      +      "unsure"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / hourly / description
      Removed value: -"Whether hourly staff time goes up and down with sales: yes if shifts are added and cut as it gets busy or quiet; no if about the same team works every shift, so hourly pay is a bill that stays the same; unsure (the default) works it out both ways, as a range."
    • removedInput schema / properties / hourly / enum
      Removed value: -[
      -  "yes",
      -  "no",
      -  "unsure"
      -]
    • removedInput schema / properties / hourly / type
      Removed value: -"string"
    • addedInput schema / properties / hourlyPay / anyOf
      Added value: +[
      +  {
      +    "description": "That month's hourly wages from payroll, plus the employer's payroll taxes and benefits on them; no tips. Paid every two weeks: one pay run × 26 ÷ 12. Needed for a result (0 with no hourly staff); if missing, the reply asks for it.",
      +    "maximum": 1000000000,
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / hourlyPay / description
      Removed value: -"That month's hourly wages from payroll, plus the employer's payroll taxes and benefits on them; no tips. Paid every two weeks: one pay run × 26 ÷ 12. Needed for a result (0 with no hourly staff); if missing, the reply asks for it."
    • removedInput schema / properties / hourlyPay / maximum
      Removed value: -1000000000
    • removedInput schema / properties / hourlyPay / minimum
      Removed value: -0
    • removedInput schema / properties / hourlyPay / type
      Removed value: -"number"
    • addedInput schema / properties / openingStock / anyOf
      Added value: +[
      +  {
      +    "description": "Optional: stock at cost at the start of the month. Used only with closingStock: food and drink then becomes what was used, opening + purchases - closing. Skip both if stock stayed about the same.",
      +    "maximum": 1000000000,
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / openingStock / description
      Removed value: -"Optional: stock at cost at the start of the month. Used only with closingStock: food and drink then becomes what was used, opening + purchases - closing. Skip both if stock stayed about the same."
    • removedInput schema / properties / openingStock / maximum
      Removed value: -1000000000
    • removedInput schema / properties / openingStock / minimum
      Removed value: -0
    • removedInput schema / properties / openingStock / type
      Removed value: -"number"
    • addedInput schema / properties / otherVariable / anyOf
      Added value: +[
      +  {
      +    "description": "That month's other costs that rise with every sale: card fees, delivery app commissions (app sales minus payouts, both without tax and tips), to-go packaging, any percentage rent, royalties or ad fund fees. Nothing already in the food and drink invoices. Needed for a result (0 if none); if missing, the reply asks for it.",
      +    "maximum": 1000000000,
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / otherVariable / description
      Removed value: -"That month's other costs that rise with every sale: card fees, delivery app commissions (app sales minus payouts, both without tax and tips), to-go packaging, any percentage rent, royalties or ad fund fees. Nothing already in the food and drink invoices. Needed for a result (0 if none); if missing, the reply asks for it."
    • removedInput schema / properties / otherVariable / maximum
      Removed value: -1000000000
    • removedInput schema / properties / otherVariable / minimum
      Removed value: -0
    • removedInput schema / properties / otherVariable / type
      Removed value: -"number"
    • addedInput schema / properties / purchases / anyOf
      Added value: +[
      +  {
      +    "description": "That month's food and drink supplier invoices, added up by delivery date. Needed for a result; if missing, the reply asks for it.",
      +    "maximum": 1000000000,
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / purchases / description
      Removed value: -"That month's food and drink supplier invoices, added up by delivery date. Needed for a result; if missing, the reply asks for it."
    • removedInput schema / properties / purchases / maximum
      Removed value: -1000000000
    • removedInput schema / properties / purchases / minimum
      Removed value: -0
    • removedInput schema / properties / purchases / type
      Removed value: -"number"
    • addedInput schema / properties / sales / anyOf
      Added value: +[
      +  {
      +    "description": "Net sales for one typical month, in the owner's own currency like every figure here: the POS sales summary, before tax and tips, delivery app orders at menu price. Not a holiday rush or a one-off: every figure is for that same month. Needed for a result, and more than 0; if missing, the reply asks for it.",
      +    "maximum": 1000000000,
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / sales / description
      Removed value: -"Net sales for one typical month, in the owner's own currency like every figure here: the POS sales summary, before tax and tips, delivery app orders at menu price. Not a holiday rush or a one-off: every figure is for that same month. Needed for a result, and more than 0; if missing, the reply asks for it."
    • removedInput schema / properties / sales / maximum
      Removed value: -1000000000
    • removedInput schema / properties / sales / minimum
      Removed value: -0
    • removedInput schema / properties / sales / type
      Removed value: -"number"
    • changedOutput schema / properties / checks / description
      Previous value: -"Figures that look like a slip, as the page flags them. They don't block the result."New value: +"Figures that look like a slip, as the page flags them."
    • changedOutput schema / properties / link / description
      Previous value: -"Opens the calculator on the website with these figures filled in."New value: +"Opens the calculator with these figures."
    • changedOutput schema / properties / pointValue / description
      Previous value: -"One point of sales (1%), to the unit: what each point of cost saved leaves a month."New value: +"1% of sales, to the unit: what each point of cost saved leaves a month."
    • changedOutput schema / properties / scenarios / description
      Previous value: -"Hourly pay counted one way, or both ways (rising first) when the owner isn't sure and has hourly pay."New value: +"Hourly pay one way, or both (rising first) when the owner isn't sure and has hourly pay."
    • changedOutput schema / properties / scenarios / items / properties / breakEven / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "description": "Break-even sales and guests rounded up to the unit, the rest to the nearest unit, as the page shows them. Null: no amount of sales breaks even this way.",
      -    "properties": {
      -      "cushion": {
      -        "description": "Net sales minus break-even: below 0 when short.",
      -        "type": "number"
      -      },
      -      "cushionPct": {
      -        "description": "The cushion, % of net sales, one decimal.",
      -        "type": "number"
      -      },
      -      "dayOpen": {
      -        "anyOf": [
      -          {
      -            "description": "Needs daysPerWeek.",
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "goalSales": {
      -        "anyOf": [
      -          {
      -            "description": "Sales a month to have the goal left over. Needs goal.",
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "guestsADay": {
      -        "anyOf": [
      -          {
      -            "description": "Needs daysPerWeek and averageSpend.",
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "guestsAMonth": {
      -        "anyOf": [
      -          {
      -            "description": "Needs averageSpend.",
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "monthly": {
      -        "type": "number"
      -      },
      -      "moreGuestsADay": {
      -        "anyOf": [
      -          {
      -            "description": "When short, with daysPerWeek and averageSpend: the guests a day that close it.",
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "perThousandOffBills": {
      -        "description": "The same, for each 1,000 a month off the bills that stay the same.",
      -        "type": "number"
      -      },
      -      "pointOffFixed": {
      -        "description": "The same, for one point off a fixed bill (salaries).",
      -        "type": "number"
      -      },
      -      "pointOffRising": {
      -        "description": "How far break-even falls a month for one point of sales off a cost that rises with sales.",
      -        "type": "number"
      -      },
      -      "shortADayOpen": {
      -        "anyOf": [
      -          {
      -            "description": "When short, with daysPerWeek: the gap a day open.",
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "weekly": {
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "monthly",
      -      "weekly",
      -      "dayOpen",
      -      "guestsADay",
      -      "guestsAMonth",
      -      "cushion",
      -      "cushionPct",
      -      "shortADayOpen",
      -      "moreGuestsADay",
      -      "goalSales",
      -      "pointOffRising",
      -      "pointOffFixed",
      -      "perThousandOffBills"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "description": "Sales and guests rounded up to the unit, the rest to the nearest, as the page shows them. Null: no amount of sales breaks even this way.",
      +    "properties": {
      +      "cushion": {
      +        "description": "Net sales minus break-even: below 0 when short.",
      +        "type": "number"
      +      },
      +      "cushionPct": {
      +        "description": "The cushion, % of net sales, one decimal.",
      +        "type": "number"
      +      },
      +      "dayOpen": {
      +        "anyOf": [
      +          {
      +            "description": "Needs daysPerWeek.",
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "goalSales": {
      +        "anyOf": [
      +          {
      +            "description": "Sales a month to have the goal left over. Needs goal.",
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "guestsADay": {
      +        "anyOf": [
      +          {
      +            "description": "Needs daysPerWeek and averageSpend.",
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "guestsAMonth": {
      +        "anyOf": [
      +          {
      +            "description": "Needs averageSpend.",
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "monthly": {
      +        "type": "number"
      +      },
      +      "moreGuestsADay": {
      +        "anyOf": [
      +          {
      +            "description": "When short, with daysPerWeek and averageSpend: the guests a day that close it.",
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "perThousandOffBills": {
      +        "description": "The same, for each 1,000 a month off fixedBills.",
      +        "type": "number"
      +      },
      +      "pointOffFixed": {
      +        "description": "The same, for one point off a fixed bill (salaries).",
      +        "type": "number"
      +      },
      +      "pointOffRising": {
      +        "description": "How far break-even falls a month for one point of sales off a rising cost.",
      +        "type": "number"
      +      },
      +      "shortADayOpen": {
      +        "anyOf": [
      +          {
      +            "description": "When short, with daysPerWeek: the gap a day open.",
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "weekly": {
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "monthly",
      +      "weekly",
      +      "dayOpen",
      +      "guestsADay",
      +      "guestsAMonth",
      +      "cushion",
      +      "cushionPct",
      +      "shortADayOpen",
      +      "moreGuestsADay",
      +      "goalSales",
      +      "pointOffRising",
      +      "pointOffFixed",
      +      "perThousandOffBills"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / scenarios / items / properties / costsThatRisePct / description
      Previous value: -"Costs that rise with sales, % of net sales, one decimal. At 100 or more, no amount of sales breaks even."New value: +"% of net sales, one decimal. At 100 or more, no amount of sales breaks even."
    • changedOutput schema / properties / scenarios / items / properties / hourlyPay / description
      Previous value: -"Counted with the costs that rise with sales, or as a bill that stays the same."New value: +"With the costs that rise with sales, or as a fixed bill."
    • changedOutput schema / properties / standing / description
      Previous value: -"The month's net sales against break-even: above it, at it almost exactly, short of it, or never (no amount of sales breaks even, either way)."New value: +"Net sales against break-even (at: almost exactly); never: no amount of sales breaks even, either way."
    • changedOutput schema / properties / workedOut / description
      Previous value: -"How it was worked out, with the figures in each step."New value: +"How it was worked out."
  3. Changed5 schema fields changed
    • changedInput schema / properties / fixedBills / description
      Previous value: -"A month of the bills that stay the same however busy it is: rent and utilities, salaries with their payroll taxes and benefits, insurance, software, marketing, loan and lease payments in full, and the owner's own pay if it isn't on payroll (left out, break-even assumes they work for free). No depreciation. Yearly bills ÷ 12. Required."New value: +"A month of the bills that stay the same however busy it is: rent and utilities, salaries with their payroll taxes and benefits, insurance, software, marketing, loan and lease payments in full, and the owner's own pay if it isn't on payroll (left out, break-even assumes they work for free). No depreciation. Yearly bills ÷ 12. Needed for a result; if missing, the reply asks for it."
    • changedInput schema / properties / hourlyPay / description
      Previous value: -"That month's hourly wages from payroll, plus the employer's payroll taxes and benefits on them; no tips. Paid every two weeks: one pay run × 26 ÷ 12. Required: 0 with no hourly staff."New value: +"That month's hourly wages from payroll, plus the employer's payroll taxes and benefits on them; no tips. Paid every two weeks: one pay run × 26 ÷ 12. Needed for a result (0 with no hourly staff); if missing, the reply asks for it."
    • changedInput schema / properties / otherVariable / description
      Previous value: -"That month's other costs that rise with every sale: card fees, delivery app commissions (app sales minus payouts, both without tax and tips), to-go packaging, any percentage rent, royalties or ad fund fees. Nothing already in the food and drink invoices. Required: 0 if none."New value: +"That month's other costs that rise with every sale: card fees, delivery app commissions (app sales minus payouts, both without tax and tips), to-go packaging, any percentage rent, royalties or ad fund fees. Nothing already in the food and drink invoices. Needed for a result (0 if none); if missing, the reply asks for it."
    • changedInput schema / properties / purchases / description
      Previous value: -"That month's food and drink supplier invoices, added up by delivery date. Required."New value: +"That month's food and drink supplier invoices, added up by delivery date. Needed for a result; if missing, the reply asks for it."
    • changedInput schema / properties / sales / description
      Previous value: -"Net sales for one typical month, in the owner's own currency like every figure here: the POS sales summary, before tax and tips, delivery app orders at menu price. Not a holiday rush or a one-off: every figure is for that same month. Required, and more than 0."New value: +"Net sales for one typical month, in the owner's own currency like every figure here: the POS sales summary, before tax and tips, delivery app orders at menu price. Not a holiday rush or a one-off: every figure is for that same month. Needed for a result, and more than 0; if missing, the reply asks for it."
  4. Changed1 schema field changed
    • changedInput schema / properties / otherVariable / description
      Previous value: -"That month's other costs that rise with every sale: card fees, delivery app commissions (app sales minus payouts), to-go packaging, any percentage rent, royalties or ad fund fees. Nothing already in the food and drink invoices. Required: 0 if none."New value: +"That month's other costs that rise with every sale: card fees, delivery app commissions (app sales minus payouts, both without tax and tips), to-go packaging, any percentage rent, royalties or ad fund fees. Nothing already in the food and drink invoices. Required: 0 if none."
  5. Added

TDQS

A3.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnlyHint, idempotentHint, destructiveHint=false), so the bar is lower; the description still adds real context by disclosing currency-agnostic input, that a missing figure is never counted as 0, that the reply returns result + working + a deep link, and that figures are not stored (only an anonymous daily run count). Only light gaps remain, e.g. no note on output format beyond 'the working'.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded and every clause carries content, but the body is a single dense run of semicolon-joined clauses ('also a week, a day open and guests a day; how far...; what was left over...; what a point of cost moves it by...') that is hard to scan, and the reference to 'the free break-even calculator on restaurantdoctorai.com' is low-value framing.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 12-parameter computation the description is broadly complete: it explains the model, the variability assumption, currency handling, missing-figure behavior, and data retention, and an output schema exists so return values need not be spelled out. The main omission is any statement of which figures are required versus optional, which the agent must recover from the schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The reported schema description coverage is low, so the description would need to compensate; it adds model-level meaning (any currency, missing ≠ 0, hourly pay that rises, stays fixed, or both) but never maps to individual parameters like goal, ownerPay, openingStock/closingStock, otherVariable. The schema itself nonetheless carries very detailed per-parameter text, so the description and schema jointly cover most semantics, landing at minimum-viable.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource ('works out a restaurant's break-even sales') and enumerates the scope precisely: month/week/day/guests, variance to break-even, profit left over, cost sensitivity, with/without owner pay, and ±10% price illustration. An agent can tell this apart from siblings like restaurantdoctor_restaurant_budget or restaurantdoctor_prime_cost without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives a rich account of what the calculator produces and implicitly when it applies (owner has one month of figures and wants break-even), but never states when to prefer this over alternative tools such as restaurantdoctor_run_free_check, restaurantdoctor_restaurant_budget or price/menu tools, nor any exclusions. Usage is inferred rather than stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources