Automation Squad MCP for Samsara - Complete fleet management integration with expert knowledge built-in
Server has 8 tools with consistent naming (verb_noun pattern) and reasonable descriptions (avg ~150 chars). All tools have input schemas with type definitions and parameter descriptions. However, output schemas are completely undocumented, LLMs cannot predict response structure for chaining. Parameter descriptions lack format constraints (e.g., ISO 8601 format stated in description but not enforced). Error handling is minimal; no recovery guidance. Missing tool annotations (readOnlyHint/destructiveHint). samsara_update_route has incomplete schema (missing 'stops' parameter definition visible in description). No pagination guidance for list tools despite mentioning cursor support.
Create a new route with stops. IMPORTANT: Each stop needs address (with lat/long or formatted address), optional arrival/departure times, and names. Use externalIds to link with your TMS.
Get detailed information about a specific route including all stops, assigned vehicle/driver, and status
Get detailed information about a specific vehicle by ID
Get real-time or recent locations for vehicles. Uses the feed API pattern for efficient streaming of location data.
Get vehicle statistics including odometer, engine hours, and fuel usage over a time range
List all routes. Routes contain ordered stops with addresses, times, and status tracking.
Output schemas completely undocumented. LLMs cannot predict response structure, field names, or types for any tool. Breaks tool chaining and forces agents to guess at downstream parameter mappings.
samsara_update_route schema is incomplete. Description mentions 'stops' parameter and 'preserves stop IDs', but input schema does not include 'stops' property. Schema does not match documented behavior.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Risk field in metadata indicates write vs read, but MCP spec requires tool annotations for proper agent planning and safety.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 63 | 2026-07-28+ | v2 |
List all vehicles in the fleet. Returns vehicle details including ID, name, VIN, make, model, and external IDs for TMS integration.
Update a route. CRITICAL BEST PRACTICE: This tool automatically preserves stop IDs to maintain arrival/departure time tracking. You can update name, vehicle, driver, status, or modify stops. When updating stops, the tool fetches existing stop IDs and preserves them.
Parameter descriptions lack format constraints. 'startTime' and 'endTime' mention ISO 8601 in description but no format/pattern in schema. 'limit' lacks min/max bounds (stated as 'max: 512' in description, not in schema).
No error handling guidance. samsaraRequest() throws generic errors without recovery hints. LLMs receive 'Samsara API error (400): ...' with no actionable next step (retry, lookup, ask user).