create_quote_snapshot

Notifications · Write · account-scoped · server-priced

Turn a completed labor selection into the shop's quote snapshot and get the quoteId the send tool takes.

Usage

The bridge between the read surface and send_quote_notification: a completed service_advisor_lookup ends at selectedTotal, and this tool turns that selection into MotorAdvisor's own commercial record — returning the q_… id, the public approval quoteUrl, and the priced lines.

The caller supplies identifiers, never money. Hours, names, and prices are re-read from MOTOR live at snapshot time, so a figure that was never computable cannot be snapshotted and no price in the record came from model output. The persisted record carries exact-cent money and MOTOR content identifiers only — descriptive MOTOR text is re-materialized on every render, never stored (invariant 4). MOTOR itself is only ever read; the write lands in MotorAdvisor's store and appears in the call trace as its own step.

customerContact is a lookup key, not an address: it links the shop's existing consent record to the quote so send_quote_notification can deliver it. A contact with no consent on file leaves the quote created but unlinked — sending refuses with no-consent, and the advisor shares quoteUrl by hand, exactly like the web flow.

The estimate says whom it is for (MOT-339). Pass customerName and the approval page and the quote email carry a "Prepared for" line — the name, plus customerContact printed as the email or phone it is by shape. Without a name the estimate carries no customer line; the contact alone stays a lookup key.

Manual lines (manualLines) carry the shop's own figures for work with no MOTOR book time — recharge, sublet, shop supplies — at the shop's stored rate unless a rate is given.

Parts ride on the quote (MOT-325). parts takes the parts the customer approves together with the labor, in the same shape issue_invoice bills: name, optional oemPartNumber and quantity, and the advisor's unitPriceCents — the SELL price, never MOTOR's list price, which a lookup returns as an anchor only. A part without a sell price refuses the call, exactly as the web quote refuses to send with one unpriced. The response reports the parts, laborTotal, partsTotal and the full total the customer will approve; the customer's approval page lists the parts under the labor.

The snapshot is created open — it reads as sent only after send_quote_notification actually delivers it. When this quote replaces an earlier one (findings grew the work), pass supersedes with the old q_… id: approval of this quote retires the old one to a terminal superseded status and its approval link goes dead, so two live approvals can never both be billed.

Parameters

Description advertised to clients

The exact description a fully entitled MCP client discovers — the workflow contracts travel with the tool, so a client with no system prompt still uses it correctly. An account missing a licence for content this tool reaches sees the same text behind a [Licensed content — not enabled on this account] or [Partially available] notice:

Create the shop's quote snapshot from a COMPLETED labor selection and return its quoteId (q_…) — the bridge between service_advisor_lookup and send_quote_notification. THIS TOOL WRITES a commercial record owned by the authenticated account's shop (MOTOR itself stays read-only; the call trace shows the write as its own step). Pass the applicationIds a lookup costed into selectedTotal — hours, names, and prices are re-read from MOTOR server-side, so a total that was never computable cannot be snapshotted and no labor figure is taken from input. Parts the customer approves go in parts, each with the advisor's SELL price (the customer approves labor and parts together, as on the web); an unpriced part refuses the call. The persisted record holds exact-cent money and MOTOR content identifiers only, never MOTOR text. Returns quoteId, the public approval quoteUrl (shareable by hand), the priced lines, and the total. The quote is created OPEN — it reads as sent only after send_quote_notification actually delivers it. When this quote REPLACES an earlier one (findings grew the work), pass supersedes with the old q_… id: approval of this quote retires the old one so two live approvals can never both be billed. Use create_quote_snapshot AFTER the advisor confirms the selection; then send_quote_notification with the quoteId. The evaluation sandbox covers model years 2010, 2015, and 2016 ONLY — an UnknownApplicationIds refusal for another vehicle is correct behaviour, not an error.

Example — Snapshot a compressor R&R selection

Illustrative payload shapes (ids and token elided); the money is the server's own computation at the shop's $150/hr rate.

Request

{
  "baseVehicleId": 22124,
  "vehicleDescription": "2010 Honda Civic LX",
  "applicationIds": [
    23615369
  ],
  "parts": [
    {
      "name": "Compressor Assembly",
      "oemPartNumber": "38810-RNA-A02",
      "unitPriceCents": 103035
    }
  ],
  "customerContact": "customer@example.com",
  "customerName": "Casey Rivera"
}

Response

{
  "quoteId": "q_9c41f0b2ae77d31c55e00e12",
  "quoteUrl": "https://motoradvisor.app/q/…",
  "vehicle": "2010 Honda Civic LX",
  "lines": [
    {
      "name": "Air Conditioning Compressor R&R",
      "hours": 1.9,
      "amount": "$285.00"
    }
  ],
  "parts": [
    {
      "name": "Compressor Assembly",
      "oemPartNumber": "38810-RNA-A02",
      "quantity": 1,
      "unitPrice": "$1,030.35",
      "amount": "$1,030.35"
    }
  ],
  "laborTotal": "$285.00",
  "partsTotal": "$1,030.35",
  "total": "$1,315.35",
  "expiresAt": "2026-08-28T13:30:00.000Z",
  "consentNote": "Consent on file for this contact — send_quote_notification can deliver this quote."
}

applicationIds that match no work time on the vehicle refuse the whole call (UnknownApplicationIds) — nothing is silently dropped, and nothing is snapshotted. A part without unitPriceCents refuses the same way (InvalidInput).