get_job

Jobs · Read-only · account-scoped

One job's durable spine — board stage, linked quote summaries, and the invoice by reference.

Usage

The continuity read over the durable job record (MOT-198): from any client, "where does this repair order stand, and where is the money" — without the browser session that produced it. Read-only in every direction: it reads MotorAdvisor's own store and makes no MOTOR call.

The job record itself holds identifiers, stage, and links only. Everything else in the result is composed at read time from the linked records: each quote contributes its stage, status, totalCents (integer cents), sentAt/decidedAt, and its stored vehicleDescription — the one piece of descriptive text on this surface. Operation names and book times are not persisted anywhere and are deliberately not re-materialized here; this is a continuity read, not a render surface.

The invoice appears by reference. Stripe is the system of record for its lifecycle, so invoice.status says "paid" only once the job itself has reached the paid stage — for live payment state, use check_invoice_status. For a quote's delivery trail and approval link, use check_quote_status.

The shop resolves from the authenticated account; another shop's jobId reads as not found.

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:

Read one job's durable spine: its stage on the board, timestamps (including stageEnteredAt — when the current stage began), the shop-authored customer-status fields where set (waitingOnParts, partsEta as a YYYY-MM-DD date, pickupHours as one short line), and composed summaries of the linked money records — each quote (stage, status, totalCents in integer cents, sentAt, decidedAt, vehicleDescription) and the invoice by reference (invoiceId, with status "paid" only once the job itself has reached the paid stage — for live payment state use check_invoice_status). This is a CONTINUITY read, not a render surface: operation names, book times and other descriptive content are not on the record and are NOT re-materialized here — the only descriptive text returned is each quote's stored vehicleDescription. Use check_quote_status for a quote's delivery trail and approval link. THIS TOOL IS READ-ONLY EVERYWHERE: it reads MotorAdvisor's own job store and touches neither MOTOR (no content call is made, and no MOTOR text is persisted anywhere on the job record) nor the payment provider — Stripe remains the system of record for money, linked by invoiceId only. The shop is NEVER a parameter: it resolves from the authenticated account, so this tool can only read the caller's own jobs — another shop's ids read as not found.

Example — Read an invoiced job

Illustrative payload shapes (ids elided); the composition mirrors the shop catalog view.

Request

{
  "jobId": "job_m1abc2de_x7k4q9"
}

Response

{
  "jobId": "job_m1abc2de_x7k4q9",
  "stage": "invoiced",
  "customerId": "job_m1abc2de_x7k4q9",
  "baseVehicleId": 22124,
  "createdAt": "2026-08-20T14:02:00.000Z",
  "updatedAt": "2026-08-21T16:45:00.000Z",
  "quotes": [
    {
      "quoteId": "q_9c41f0b2ae77d31c55e00e12",
      "stage": "quote",
      "status": "approved",
      "totalCents": 28500,
      "sentAt": "2026-08-20T14:30:00.000Z",
      "vehicleDescription": "2010 Honda Civic LX",
      "decidedAt": "2026-08-20T15:10:00.000Z"
    }
  ],
  "invoice": {
    "invoiceId": "in_1QzXw82eZvKYlo2C"
  }
}

invoice carries status: "paid" only once the job reaches the paid stage — until then the id is a reference to Stripe, the money's system of record.