analyze_records
ChatGPTUse this when the user asks what their saved MoveDefense records collectively show: patterns, frequency, comparisons, repetition, trends, rankings, exceptions, historical occurrences, or relationships across stops, fuel, inspections, cargo notes, vehicles, locations, and dates. Start here for 'has this happened before?', repeated cargo damage in a week, time spent at places, longest waits, frequent customers, fuel frequency, repeating inspection problems, or unusually high mileage. Keep the ordinary question and translate it into the supported analysis fields on the FIRST call. Resolve the requested period into explicit inclusive from/to dates using conversation context and the current calendar; do not rely on the question parser to recognize a named month. For 'Where did I spend the most time in August?' with August 2026 in context, send from='2026-08-01', to='2026-08-31', analysis={"record_types":["stops"],"operation":"rank","metric":"wait_minutes","group_by":"location","order":"desc","limit":5}. This ranks total saved arrival-to-departure duration, not visit count or longest single visit; report it as recorded stop time, not necessarily waiting or lost work time. Do not make exploratory question-only calls, search, or list_recorded_days calls for a supported calculation. Do not ask the driver to rephrase into plugin syntax. Use bounded question interpretation only when the schema cannot express the full question. Results include the interpretation, computed facts, coverage, and supporting record IDs. Treat context_only or partial as unresolved or limited, not a definitive yes/no. Questions explicitly distinguishing cargo damage from vehicle or trailer damage check stops and inspections together unless an explicit source selection narrows them. Use analysis.damage_categories to request this classification directly. Results provide separate category and weekly counts of classified saved-note candidates, supporting IDs, and warnings about overlapping categories or uncertain classification. Damage note matches count saved records, not proven distinct incidents; photos are not inspected for classification. For 'show me', pass supporting IDs directly to show_record_evidence(record_ids), or use show_route_timeline(date=route_date); do not search again. Already identified photos and routes should go directly to those display tools. Only reads the driver linked to this selected connection. Do not use this tool when the user only asks to create, change, or delete records; import Spark payouts or tips; reconcile bank deposits; or read another driver's account. Do not substitute another MoveDefense connection or its record IDs.
audit_record_quality
ChatGPTUse this when the user asks whether MoveDefense records are complete enough for bookkeeping or review, or wants open stops, mileage anomalies, missing fuel fields, missing receipts, incomplete days, or timestamp conflicts identified. Only reads the driver linked to this selected connection. Do not use this tool when the user only asks to create, change, or delete records; import Spark payouts or tips; reconcile bank deposits; or read another driver's account. Do not substitute another MoveDefense connection or its record IDs.
estimate_route_fuel_use
ChatGPTUse this when the user asks how much fuel a route or a merchant's delivery work likely consumed and can explicitly supply the vehicle MPG. Return an estimate with its mileage, MPG, price basis, and confidence; never present it as a logged fuel purchase. Only reads the driver linked to this selected connection. Do not use this tool when the user only asks to create, change, or delete records; import Spark payouts or tips; reconcile bank deposits; or read another driver's account. Do not substitute another MoveDefense connection or its record IDs.
fetch
ChatGPTUse this when the user selects one result returned by search and needs its complete readable record and metadata. Only reads the driver linked to this selected connection. Do not use this tool when the user only asks to create, change, or delete records; import Spark payouts or tips; reconcile bank deposits; or read another driver's account. Do not substitute another MoveDefense connection or its record IDs.
get_owner_dashboard
ChatGPTRead live owner-panel dashboard information. Each page contains named sections; continue next_cursor. Counts, estimates and recent samples retain the panel's definitions. Follow metric records or saved driver days to investigate underlying activity. Requires the separately selected MoveDefense — Owner connection, explicit owner read consent, and an existing active website owner/management role checked by the server. A driver connection cannot call this tool. Read only; no billing, account, or permission changes.
get_owner_driver_day
ChatGPTRead the owner panel's underlying driver day as paginated complete records, including load states, inspections, times, equipment, notes, and source references. Continue next_cursor. Requires the separately selected MoveDefense — Owner connection, explicit owner read consent, and an existing active website owner/management role checked by the server. A driver connection cannot call this tool. Read only; no billing, account, or permission changes.
get_owner_records
ChatGPTRead the same underlying record rows shown when opening a dashboard metric. Follow all next_cursor pages. source_limit describes the website panel's bounded sample; use query_owner_activity for full event pagination and list_owner_driver_days for saved history. Requires the separately selected MoveDefense — Owner connection, explicit owner read consent, and an existing active website owner/management role checked by the server. A driver connection cannot call this tool. Read only; no billing, account, or permission changes.
get_record_photos
ChatGPTUse this when the user asks to see or inspect actual stored photos. First obtain record_id from search, fetch, or get_route_timeline. Accepts existing stop, fuel, inspection, or evidence IDs; optional attachment_id narrows within that record. Returns actual MCP image content with correct MIME type, hashes and provenance. Display images are derived copies; the originals stay unchanged in MoveDefense. Call show_record_evidence to render an interactive card. Use next_offset for more photos; never describe an unavailable image or infer damage causation from its location. Only reads the driver linked to this selected connection. Do not use this tool when the user only asks to create, change, or delete records; import Spark payouts or tips; reconcile bank deposits; or read another driver's account. Do not substitute another MoveDefense connection or its record IDs.
get_records
ChatGPTRead complete load states, notes, times, equipment and source references for up to 20 known record IDs in one account-scoped snapshot. Use after discovery when several independent records can be read together. Follow next_cursor for every page. Only reads the driver linked to this selected connection. Do not use this tool when the user only asks to create, change, or delete records; import Spark payouts or tips; reconcile bank deposits; or read another driver's account. Do not substitute another MoveDefense connection or its record IDs.
get_route_timeline
ChatGPTUse this when the user asks what happened on one recorded day, including the ordered stops, arrival and departure times, waits, mileage legs, load actions, and evidence counts. Only reads the driver linked to this selected connection. Do not use this tool when the user only asks to create, change, or delete records; import Spark payouts or tips; reconcile bank deposits; or read another driver's account. Do not substitute another MoveDefense connection or its record IDs.
list_owner_driver_days
ChatGPTList saved days available in the owner panel, including days outside the driver's plan window. Continue next_cursor; then read selected days. Only the owner connection has this wider visibility. Requires the separately selected MoveDefense — Owner connection, explicit owner read consent, and an existing active website owner/management role checked by the server. A driver connection cannot call this tool. Read only; no billing, account, or permission changes.
list_recorded_days
ChatGPTUse this when the user asks which dates contain MoveDefense records or whether records exist for a period before requesting detailed analysis. Only reads the driver linked to this selected connection. Do not use this tool when the user only asks to create, change, or delete records; import Spark payouts or tips; reconcile bank deposits; or read another driver's account. Do not substitute another MoveDefense connection or its record IDs.
query_owner_activity
ChatGPTRead actual activity events in an explicit date interval with stable ID pagination, optional exact user and event type. Continue next_cursor until null. Returns recorded actions, times and dashboard descriptions, not inferred intent. Requires the separately selected MoveDefense — Owner connection, explicit owner read consent, and an existing active website owner/management role checked by the server. A driver connection cannot call this tool. Read only; no billing, account, or permission changes.
query_records
ChatGPTSearch recorded fields with case-insensitive text in explicit dates (up to 366 days), with complete records and pagination. Discover shipment IDs/references, pre-departure notes, inspections and comparable conditions. A text hit is context, not a causal conclusion. Continue every next_cursor, then use get_records or trace_shipment for dependent follow-ups. Only reads the driver linked to this selected connection. Do not use this tool when the user only asks to create, change, or delete records; import Spark payouts or tips; reconcile bank deposits; or read another driver's account. Do not substitute another MoveDefense connection or its record IDs.
search
ChatGPTUse this when the user wants to find individual MoveDefense days, stops, fuel records, inspections, notes, photos, or receipts by keywords. For patterns, frequency, comparisons, or questions across records, start with analyze_records. Only reads the driver linked to this selected connection. Do not use this tool when the user only asks to create, change, or delete records; import Spark payouts or tips; reconcile bank deposits; or read another driver's account. Do not substitute another MoveDefense connection or its record IDs.
show_record_evidence
ChatGPTUse this when the user wants photos, damage notes, evidence, where a condition was documented, or the source record, after search, fetch, get_record_photos, or get_route_timeline. Renders compact interactive evidence cards from the existing record IDs, with photos, previous/next stops and Open in MoveDefense links. It reads the authoritative records again; never accepts invented evidence. For numeric totals use existing data tools without this renderer. Only reads the driver linked to this selected connection. Do not use this tool when the user only asks to create, change, or delete records; import Spark payouts or tips; reconcile bank deposits; or read another driver's account. Do not substitute another MoveDefense connection or its record IDs.
show_route_timeline
ChatGPTUse this when the user wants to inspect a saved route, stops, photos or chronology, after get_route_timeline. Renders the actual driver's saved day, pickups, drop-offs, inspections, notes, evidence counts and source links. Optional focus_record_id opens the relevant evidence with the immediately preceding/following stop. A documented condition and a previous handoff do not establish where damage originated. Use next_offset for additional timeline events. Numeric questions alone do not need this renderer. Only reads the driver linked to this selected connection. Do not use this tool when the user only asks to create, change, or delete records; import Spark payouts or tips; reconcile bank deposits; or read another driver's account. Do not substitute another MoveDefense connection or its record IDs.
summarize_activity
ChatGPTUse this when the user asks for totals or a daily or weekly breakdown of miles, stops, pickups, deliveries, recorded activity span, or wait time over a date range. The activity span is not a clock-in timesheet. Only reads the driver linked to this selected connection. Do not use this tool when the user only asks to create, change, or delete records; import Spark payouts or tips; reconcile bank deposits; or read another driver's account. Do not substitute another MoveDefense connection or its record IDs.
summarize_fuel_purchases
ChatGPTUse this when the user asks about fuel actually logged or purchased, including gallons, spending, price per gallon, payment type, station totals, and receipt coverage. Only reads the driver linked to this selected connection. Do not use this tool when the user only asks to create, change, or delete records; import Spark payouts or tips; reconcile bank deposits; or read another driver's account. Do not substitute another MoveDefense connection or its record IDs.
summarize_inspections
ChatGPTUse this when the user asks which PreTrip, additional PreTrip, or PostTrip inspections were completed, incomplete, or contained recorded issues in a date range. Only reads the driver linked to this selected connection. Do not use this tool when the user only asks to create, change, or delete records; import Spark payouts or tips; reconcile bank deposits; or read another driver's account. Do not substitute another MoveDefense connection or its record IDs.
summarize_place_activity
ChatGPTUse this when the user asks about visits, miles, deliveries, pickups, or wait time involving a merchant, customer, station, saved place, or address. Only reads the driver linked to this selected connection. Do not use this tool when the user only asks to create, change, or delete records; import Spark payouts or tips; reconcile bank deposits; or read another driver's account. Do not substitute another MoveDefense connection or its record IDs.
trace_owner_shipment
ChatGPTTrace an exact shipment ID or reference within one explicitly identified driver's owner-accessible saved days. Returns full arrival/departure loads and marked surrounding stops. Never assumes identity across drivers; independently retrieved traces may be compared with explicit references. Requires the separately selected MoveDefense — Owner connection, explicit owner read consent, and an existing active website owner/management role checked by the server. A driver connection cannot call this tool. Read only; no billing, account, or permission changes.
trace_shipment
ChatGPTFollow an exact saved load ID or reference across stops and days. Returns full arrived/departed load states, actions, times, truck/trailer, notes, source links and explicitly marked surrounding context. Prefer load_id; references may be reused. Never joins by cargo similarity or a guessed ID. Read each next_cursor, inspect surrounding stops and compare independent traces; infer reasons only from recorded context and label predictions. Only reads the driver linked to this selected connection. Do not use this tool when the user only asks to create, change, or delete records; import Spark payouts or tips; reconcile bank deposits; or read another driver's account. Do not substitute another MoveDefense connection or its record IDs.
