Get the signed-in My Hot Lunchbox account: name, email, role, number of students, pending order count, account credit balances, and whether subscriptions are enabled. Start here to confirm the session works.

Discard the cached My Hot Lunchbox access token so the next tool call signs in again. Use after changing credentials, or if calls start failing with stale-session errors.

List the students on the account: id, first name, school, grade/teacher, whether they have orders, and whether the profile is inactive or still an unaccepted invite. The student id feeds every calendar and ordering tool.

Get the editable profile for one student — school, grade, teacher, delivery location, allergies and the dropdown options for each. Returns the exact model that mhlb_update_student expects back.

Get a blank student profile plus the school/grade/teacher dropdown options, ready to fill in and pass to mhlb_create_student.

Add a student to the account. Call mhlb_new_student_form first and send that model back with the fields filled in. NOTE: this write is UNVERIFIED — its request shape was derived from the web app’s compiled API client but has not been exercised against a live account. Inspect the dry-run preview before confirming.

Update a student profile. Call mhlb_get_student_form first and send that model back with your edits — the endpoint replaces the whole record, so omitted fields are lost. NOTE: this write is UNVERIFIED — its request shape was derived from the web app’s compiled API client but has not been exercised against a live account. Inspect the dry-run preview before confirming.

Remove a student from the account. Irreversible from this API — their order history goes with them. NOTE: this write is UNVERIFIED — its request shape was derived from the web app’s compiled API client but has not been exercised against a live account. Inspect the dry-run preview before confirming.

Get the lunch calendar for the account over a date range: which days are open for ordering, already ordered, paid, in the cart, subscribed or closed, per student. This is what the Lunch Calendar page shows.

Get what a student has ordered on one specific date — the items, sizes, quantities, add-ons and prices.

Get the shopping cart — lunches added but not yet paid for. Filter by order status and ordering period, or narrow to one student.

Get the valid filter values for mhlb_get_cart — the ordering periods (semesters) and status tabs, with which one is selected by default. Call this before filtering the cart.

Get the orderable menu for one student on one date — the vendor, items, sizes, add-ons, prices and the ordering deadline. This is the read half of placing an order.

Get the blank order model for a student on a specific lunch event — the exact structure that mhlb_create_order expects back, pre-populated with the available items.

Get an existing order in editable form — the model mhlb_update_order expects back.

Place a lunch order into the cart. Call mhlb_get_order_form first and send that model back with quantities set. This adds to the cart — it does not pay; use mhlb_checkout for that. NOTE: this write is UNVERIFIED — its request shape was derived from the web app’s compiled API client but has not been exercised against a live account. Inspect the dry-run preview before confirming.

Change an existing lunch order. Call mhlb_get_order first and send that model back with your edits — the endpoint replaces the whole order. NOTE: this write is UNVERIFIED — its request shape was derived from the web app’s compiled API client but has not been exercised against a live account. Inspect the dry-run preview before confirming.

Cancel a lunch order. If it was already paid for, the refund behaviour is whatever My Hot Lunchbox applies — this tool does not control it. NOTE: this write is UNVERIFIED — its request shape was derived from the web app’s compiled API client but has not been exercised against a live account. Inspect the dry-run preview before confirming.

List payment transactions on the account — date, amount, and what was paid for.

Get the line-item detail of one transaction — which lunches it paid for.

List upcoming lunch subscriptions — the recurring orders that will be placed and charged automatically.

Get the account’s subscription configuration — whether recurring ordering is on, and its terms.

Turn recurring lunch subscriptions on or off for the account. Turning it ON means future lunches are ordered and charged automatically. NOTE: this write is UNVERIFIED — its request shape was derived from the web app’s compiled API client but has not been exercised against a live account. Inspect the dry-run preview before confirming.

Stop a recurring subscription for a specific lunch order. NOTE: this write is UNVERIFIED — its request shape was derived from the web app’s compiled API client but has not been exercised against a live account. Inspect the dry-run preview before confirming.

List gift cards on the account — codes, balances and status.

Redeem a gift card code onto the account balance. NOTE: this write is UNVERIFIED — its request shape was derived from the web app’s compiled API client but has not been exercised against a live account. Inspect the dry-run preview before confirming.

Get the coupon currently applied to the account, if any.

Apply a coupon code to the account. NOTE: this write is UNVERIFIED — its request shape was derived from the web app’s compiled API client but has not been exercised against a live account. Inspect the dry-run preview before confirming.

Remove the coupon currently applied to the account. NOTE: this write is UNVERIFIED — its request shape was derived from the web app’s compiled API client but has not been exercised against a live account. Inspect the dry-run preview before confirming.

Start checkout for the cart: returns the order summary, totals, taxes, applied credits and the available payment methods. This does NOT charge anything — it is the read step before mhlb_checkout. NOTE: this write is UNVERIFIED — its request shape was derived from the web app’s compiled API client but has not been exercised against a live account. Inspect the dry-run preview before confirming.

PAY for the lunches in the cart. This charges a real payment method on the My Hot Lunchbox account. Run mhlb_init_checkout first, read the total it returns, and pass that figure as expectedTotal. Only a card ALREADY SAVED on the account can be used: paying with a new card needs a Stripe token minted by Stripe.js in a browser, which no server-side client can produce. NOTE: this write is UNVERIFIED — its request shape was derived from the web app’s compiled API client but has not been exercised against a live account. Inspect the dry-run preview before confirming.

Generate the printable lunch calendar PDF for a date range. Writes the PDF to disk and returns its path (or the bytes inline with inline: true).

Generate the printable order-details PDF for a single lunch date. Note this is one date, not a range, and studentIds is required — the endpoint fails if it is empty, or if no order matches the date and status you ask for. Get both from mhlb_get_calendar.

Generate the printable receipt PDF for one transaction. Pass the transaction object from mhlb_get_transaction — the endpoint renders that record, it does not look one up by id.