Samsara MCP — Tools Reference

This page lists every tool available in the Samsara MCP closed beta, grouped by what it helps you do. The tool catalog expands during the beta — this page reflects the current catalog. All tools are read-only, and every tool respects your dashboard permissions — an agent acting on your behalf only sees data your Samsara login can see.

For what the Samsara MCP is and how to connect a client, see the main MCP page.

Fleet & assets

Entity search

Searches your drivers, vehicles, assets, and trailers by name, so the agent can resolve "truck 118" or a driver's name to the exact record before calling other tools.

You can ask:

• "Find the vehicle called Unit 118."
• "Look up driver Maria Gonzalez."

List vehicles & assets

Returns your vehicles, trailers, and equipment with live location, status, current driver assignment, and tags. Supports filtering by tag, so questions about a specific crew, region, or asset type resolve server-side.

You can ask:

• "Where is everything on the Blue Crew tag right now?"
• "List all vehicles with their current drivers."
• "Which trailers haven't reported a location since yesterday?"

Engine gauges & fuel levels

Returns live engine gauge readings — including fuel level percentage — across the fleet, filterable by tag. Useful for pre-move checks and fuel triage.

You can ask:

• "Before tomorrow's crew move, which trucks on the Red Crew tag are below a quarter tank?"
• "List fuel levels for every asset at the north yard, lowest first."

Trailer & asset dwell

Dwell time per site — how long trailers and assets have been sitting at yards and customer locations.

You can ask:

• "Show trailers sitting at customer yards over 48 hours."
• "Which of our yards have the highest average trailer dwell this month?"

Detention at customer locations

Flags trailers held at customer locations beyond a grace period — the record you want when it's time to push back on detention.

You can ask:

• "Which trailers are currently in detention, and at which customers?"
• "Summarize detention by customer for last month."

Drivers & safety

List drivers

Returns your drivers with status, filterable by tag and attributes.

You can ask:

• "List active drivers on the night-shift tag."
• "Which drivers are currently signed in to a vehicle?"

Safety events

Returns safety events filtered by behavior type, severity, and time range. During the beta, events can be filtered by time and vehicle

You can ask:

• "Show harsh-braking events from the last 7 days, most severe first."
• "Any severe safety events for the Permian crew this week?"
• "Speeding events in the last 24 hours" — then narrow by vehicle or tag rather than by location.

Speeding analysis

Per-vehicle speeding breakdown over a time range, including severity levels and maximum speed.

You can ask:

• "Which vehicles had severe speeding in the last 24 hours?"
• "What was the max speed on truck 118's trips yesterday?"

Compliance & maintenance

Hours of Service status

Current duty status and remaining drive/duty clocks for each driver, filterable by tag. This is the tool behind dispatch questions ("who can legally take this load?") and end-of-day compliance checks.

You can ask:

• "Current duty status for everyone on the Red Crew — is anyone still on duty who should have signed out?"
• "Which drivers have at least 4 hours of drive time remaining right now?"

List DVIRs

Driver vehicle inspection reports across the fleet, filterable by time and outcome. The starting point for maintenance triage.

You can ask:

• "List yesterday's DVIRs that reported defects."
• "Which vehicles failed their pre-trip inspection this morning?"

DVIR details

The full record for a single inspection: defects, photos, mechanic notes, and the resolution chain.

You can ask:

• "Show me the details of the DVIR filed on truck 118 this morning, including the mechanic notes."
• "Walk me through the resolution history on that inspection."

DVIR defects

Defects as individual line items with resolution status — the shape you want when turning inspections into work orders in an external system (ServiceNow, Fiix, or similar).

You can ask:

• "List all unresolved defects from this week's DVIRs with vehicle, defect description, and date, so I can create work orders."
• "Which open defects are more than three days old?"

Locations

Places & geofences

Your saved places and geofences — yards, terminals, customer sites.

You can ask:

• "List our yard geofences."
• "What sites do we have saved in the San Antonio area?"

Tags

Your organization's tag tree — crews, regions, business units. Agents use this to resolve names like "Red Crew" into the right filter before calling other tools, so tag-scoped questions work end to end.

You can ask:

• "List our crew tags."
• "What vehicles and drivers are under the West Texas tag?"

Notes for beta participants

• Read-only. No tool in this catalog can modify your Samsara data. Workflows that end in an action (creating a work order, messaging a driver) work today by having the agent hand off to your other systems — for example, reading DVIR defects from Samsara and creating the work order in your maintenance system.
• Permissions. Results are always scoped to what your Samsara login can see. If a tool returns less than you expect, check your dashboard role and tag scope first.
• Known gaps we're tracking: location-based filtering of safety events (see Safety events).
• Feedback: share example prompts that worked or failed — with the full conversation transcript — with your Samsara contact.