Add
ChatGPTCreate a new entity. Returns the new entity's ID. Call GetEntity first to discover required fields. Examples: typeName='Zone',entity={name:'Office',points:[{x:-79.3,y:43.6},...],groups:[{id:'GroupCompanyId'}]} | typeName='Rule',entity={name:'Speed Alert',baseType:'Custom',condition:{...}}. Ref: https://developers.geotab.com/myGeotab/apiReference/methods/Add/
AskDataAgent
ChatGPTAsk the Geotab data agent a fleet data question in natural language. The data agent generates and runs a BigQuery query and returns the results. Every call is standalone: rephrase a follow-up in full, or pass the previous result's SQL and what should change in delegation_context.
DecodeVins
ChatGPTDecode VINs to extract vehicle make, model, and year. Accepts batch of 17-char VINs (auto-normalized/deduped).
DismissFaults
ChatGPTDismiss fault records to mark them as acknowledged. Void operation (success = no error).
DownloadMediaFile
ChatGPTDownload file content for a MediaFile entity. Returns base64-encoded content. Ref: https://developers.geotab.com/myGeotab/apiReference/methods/DownloadMediaFile/
EmissionEnrollDevices
ChatGPTRegister devices for Clean Truck Check emission compliance tracking. Ref: https://developers.geotab.com/myGeotab/apiReference/methods/EmissionEnrollDevices/
FindCameraVehicles
ChatGPTFind vehicles with a camera paired, or the vehicle and camera behind a camera id or GO serial. MyGeotab Device has no camera field, so this is how to tell which vehicles have a camera; only they can have footage or camera settings. Returns {"count", "returned", "vehicles": [{deviceId, deviceName, serialNumber, cameraPartner, cameraId, onboarded, status, lastOnlineAt}]}, plus "matchedBy" ('cameraId' | 'serialNumber') for an identifier and "truncated" past the limit. count 0 for an identifier means no camera is paired with it. cameraId is what the camera settings tools take (SmarterAi cameras, cameraPartner 'smarterai'); Go Focus cameras ('gofocus') work with GetDevicesInformation. Example: identifier='G9AB12CD34EF', database='g560'
Get
ChatGPTRetrieve entities by type. Paginate via fromDate/toDate narrowing — not page numbers. Use GetCountOf to pre-check size. Examples: search={id:'b1'} | search={name:'%truck%'} | search={fromDate:'2024-01-01T00:00:00Z',toDate:'2024-01-02T00:00:00Z'} | search={deviceSearch:{id:'b1'},fromDate:'...',toDate:'...'} | propertySelector={fields:['id','name']} | resultsLimit=100. Ref: https://developers.geotab.com/myGeotab/apiReference/methods/Get/ Result Size — IMPORTANT Always specify resultsLimit. Omitting it returns ALL entities and may overflow context. Recommended values: - Exploration / single device lookup: 10–25 - Investigations: 100–500 - Bulk operations: 1000–10000 (always use propertySelector with large limits) Field Selection Use propertySelector to reduce response size by up to 80%: propertySelector={"fields": ["id", "name", "serialNumber"]} This is critical for entities with many fields (Device, User, Trip). Common Mistake The 'search' parameter must contain nested criteria — do NOT pass search fields at the top level: - Correct: search={"id": "b123"} - Wrong: id="b123" — 'id' must be inside 'search', not a top-level parameter - Correct: search={"name": "Fleet Vehicle"} - Wrong: name="Fleet Vehicle" — same mistake If the entity type is unknown, call ListEntities first to see all supported types.
GetAceResults
ChatGPTAsk Geotab Ace AI to generate fleet insights via natural language. Ace generates SQL, executes queries, returns results with reasoning. Pass new_chat=true to start; use chat_id to continue conversation.
GetCameraDeviceSettings
ChatGPTGet a SmarterAi camera's device settings: notifications, recording and voice. Returns the deployed scheme: beepNotification, voiceNotification, voiceRecording, inCabinCameraRecording, powerParkingByMovement, lensAsASensorCabin, lensAsASensorRoad (booleans), voiceAlertLanguage (e.g. 'EN_US') and voiceAlertGender (e.g. 'NEUTRAL'). Per-trigger alerts are in GetCameraEventSettings. Get cameraId from FindCameraVehicles. Example: cameraId='F69240410FYYB', database='g560'
GetCameraEventSettings
ChatGPTGet a SmarterAi camera's alert settings for each event trigger (tailgating, phone use, ...). Returns {"partnerDeviceId", "triggers": [{triggerName, eventName, audioAlert, voiceAlert, sensitivity}]}: audioAlert is the in-cab beep, voiceAlert the spoken alert, sensitivity 'low' | 'medium' | 'high' (absent when the trigger has none). Get cameraId from FindCameraVehicles; GetCameraTriggerDefinitions describes each trigger. Example: cameraId='F69240410FYYB', database='g560'
GetCameraTriggerDefinitions
ChatGPTList the SmarterAi camera event triggers (tailgating, phone use, drowsiness, ...) and what each detects. Returns {"count", "triggers": [{triggerName, displayName, groupName, description, productTypes, hasSensitivity}]}. hasSensitivity says whether the trigger accepts a 'low' | 'medium' | 'high' sensitivity. With triggerNames, each trigger also has its detection variables (allowed values, defaults, sensitivity presets), and unknown names are listed in unknownTriggerNames. Same for every camera in the database. Example: database='g560', triggerNames=['Tailgating']
GetCountOf
ChatGPTCount entities by type. Faster than Get when you only need counts. Includes active and inactive. Examples: typeName='Device' | typeName='Trip',search={fromDate:'2024-01-01T00:00:00Z',toDate:'2024-01-02T00:00:00Z'}. Ref: https://developers.geotab.com/myGeotab/apiReference/methods/GetCountOf/
GetDashBoard
ChatGPTCall MyGeotab's GetDashBoard method, returning its image or JSON backoff response. Rendering is asynchronous. With acceptJsonBackoff=False MyGeotab returns a 'Loading...' placeholder PNG while the chart renders, which looks like a real image. Prefer acceptJsonBackoff=True: a {"CacheKey": ...} reply means still rendering, so repeat the identical call every few seconds until an image comes back (typically under 15 seconds).
GetDashboardJson
ChatGPTCall MyGeotab's JSON dashboard renderer and return its raw response. Rendering is asynchronous. The first call usually returns {"result": {"Processing": {}}}: repeat the identical call every few seconds until the worksheet data appears (typically under 15 seconds). To make a schedule to render, Add a CustomReportSchedule with destination 'InteractiveDashboard' (copy template, arguments and interactiveSettings from an existing dashboard) and Remove it afterwards.
GetDevicesInformation
ChatGPTGet device status, connectivity, and health information for Go Focus cameras. This tool is for Go Focus cameras only. It returns deviceStatus, lastConnectedAt, lastRecordingUpdatedAt, lastRecordingHealth, and deviceModel for each device. Examples: - Get info for multiple devices: goFocusDeviceIds=['device1', 'device2'], database='g560' - Check single device: goFocusDeviceIds=['device1'], database='my_fleet' Returns device information as JSON with fields: - deviceStatus: Current device status (string) - lastConnectedAt: ISO timestamp or null - lastRecordingUpdatedAt: ISO timestamp or null - lastRecordingHealth: Health indicator string or null - deviceModel: Device model string or null
GetEmissionComplianceDeadline
ChatGPTGet emission compliance deadlines and status for reporting programs. Ref: https://developers.geotab.com/myGeotab/apiReference/methods/GetEmissionComplianceDeadline/
GetEntity
ChatGPTGet entity type schema (field names, types, required/optional). No database auth needed. Call before Add/Set to discover required fields. Ref: https://developers.geotab.com/myGeotab/apiReference/objects/
GetExcel
ChatGPTCall MyGeotab's GetExcel method and return the generated file bytes.
GetHosRuleSets
ChatGPTGet all available HOS rule sets with ID and name for driver working hours regulations.
GetMediaUrl
ChatGPTGenerate a video playback deep-link URL from a SearchMedia result's mediaRequestId. Returns URL and embeddable iframeSrc.
GetPostedRoadSpeedsForDevice
ChatGPTGet posted road speed limits along a device's travel path within a date range. Ref: https://developers.geotab.com/myGeotab/apiReference/methods/GetPostedRoadSpeedsForDevice/
GetReportData
ChatGPTExecute typed reports and get structured JSON data. For file exports (Excel/PDF), use SendReportProcessingRequest instead. Paginate by narrowing the fromUtc/toUtc range.
GetReportSchedules
ChatGPTCall MyGeotab's GetReportSchedules method and return its response. This method has no result limit and can return hundreds of schedules, so narrow it with reportDataSource, templates or groupsFilter. A reply over the JSON size limit is refused.
GetReportStorageFile
ChatGPTFetch the database-backed BinaryData for a ReportStorage record. Reports generated through the cloud processing flow may have empty BinaryData; use GetReportStorageFileFromCloud for those artifacts.
GetReportStorageFileFromCloud
ChatGPTDownload the generated report after ReportStorage.status is Successful. Returns the file as base64 with its content type and byte size. Use Get with typeName="ReportStorage" and search={id: reportStorageId} to check the generation status before downloading.
GetReportTemplateWithoutDetails
ChatGPTCall MyGeotab's read-only template-list method and return its response. This method has no result limit and a database can have hundreds of templates. Pass dataSources (ReportDataSource values such as 'TripsSummary') to filter. Built-in templates are left out unless includeSystem=true. A reply over the JSON size limit is refused.
GetSkill
ChatGPTStart here for any MyGeotab task: get authoritative guidance on how to use the MyGeotab APIs effectively. Call GetSkill BEFORE composing MyGeotab queries for a task, passing the user's question or intent. It returns vetted, task-specific instructions — which entity and method to use, how search filters nest, how to scope fromDate/toDate, when to paginate — so your subsequent Get/GetCountOf/ Add/Set calls are correct and efficient. This prevents the most common MyGeotab mistakes; do not rely on prior assumptions about the API.
ListEntities
ChatGPTList all supported entity types for Get, Add, Set, and Remove operations. Only writable entity types allowed for Add/Set/Remove. Ref: https://developers.geotab.com/myGeotab/apiReference/objects/ Call this tool first if you are unsure which typeName to pass to Get, Add, Set, or Remove.
Remove
ChatGPTRemove an entity and its associated data. Only 'id' field required in entity. Device/User/Driver use soft delete by default (recoverable); set hard_delete=True for permanent removal. Ref: https://developers.geotab.com/myGeotab/apiReference/methods/Remove/
SearchMedia
ChatGPTSearch video/snapshot media requests. Always provide time range. Examples: requestStartTime='2024-01-01T00:00:00.000Z',requestEndTime='2024-01-02T00:00:00.000Z',statuses=['MediaAvailable'] | goDeviceIds=['b1'],resourceType=['Video'] | ruleIds=['ruleId'],types=['Exception']. Pass result's mediaRequestId to GetMediaUrl for playback. Paginate: increment resultsPage by 1.
SendReportProcessingRequest
ChatGPTQueue async report file generation (Excel/PDF). Returns storage ID for polling.
Set
ChatGPTModify an existing entity. Entity 'id' required; include only fields to change — omitted fields unchanged. Examples: typeName='Device',entity={id:'b1',name:'New Name'} | typeName='User',entity={id:'b2',isDriver:true}. Ref: https://developers.geotab.com/myGeotab/apiReference/methods/Set/
SetCameraDeviceSettings
ChatGPTTurn a SmarterAi camera's beep notifications, voice notifications or voice recording on or off. Changes a real camera, and voiceRecording records the cabin: before calling, confirm with the user, naming the vehicle, the camera and each setting's current and new value (read them with GetCameraDeviceSettings). Only the settings passed are changed; values that already match are not sent, and nothing is written if nothing differs. A MyGeotab rule with a camera settings action may override the change while the rule applies. Returns {"status": "applied" | "pending" | "unverified" | "unchanged", "changes": [{field, before, requested, applied}]}. Report "applied" values only; "pending" and "unverified" mean the camera has not confirmed the change yet. Never retried. After any error, read the settings again before acting: partiallyApplied and writeRejected mean part of the change may have applied. Example: cameraId='F69240410FYYB', voiceRecording=false
SetCameraEventSettings
ChatGPTChange a SmarterAi camera's alerts for specific event triggers (beep, voice alert, sensitivity). Changes the in-cab behaviour of a real camera: before calling, confirm with the user, naming the vehicle, the camera and each trigger's current and new value (read them with GetCameraEventSettings). Only the listed fields of the listed triggers change; values that already match are not sent, and nothing is written if nothing differs. A MyGeotab rule with a camera settings action may override the change while the rule applies. Returns {"status": "applied" | "pending" | "unverified" | "unchanged", "changes": [{triggerName, field, before, requested, applied}]}. Report "applied" values only; "pending" and "unverified" mean the camera has not confirmed the change yet. Never retried. After any error, read the settings again before acting: partiallyApplied and writeRejected mean part of the change may have applied. Example: cameraId='F69240410FYYB', triggers=[{"triggerName": "Tailgating", "voiceAlert": false}]
SubmitFeedback
ChatGPTRecord user feedback about the MyGeotab MCP server — its tools, or the accuracy of an answer — for product improvement. WHEN TO CALL: (a) the user explicitly asks to leave feedback, report a problem, or praise something; OR (b) a tool has failed repeatedly and the user appears blocked. For case (b), FIRST summarize the issue and show the user exactly what you would submit, and call this tool ONLY after they confirm. Do not offer to leave feedback more than once per session unless the user brings it up. AUTHORSHIP & CONFIRMATION: if feedback_text is the user's own words verbatim, set source='user_explicit'. If you wrote OR enriched any of it — including folding in an AI-summarized context (what the user was doing, expected, and where it broke) — set source='ai_on_behalf' and you MUST show the user the exact final text and get their explicit confirmation before calling this tool. Never submit AI-composed text the user hasn't seen and approved. Keep any context about the interaction, not raw customer records. This is product-improvement signal collected internally — it is NOT a support ticket and does not open a case or guarantee a response; say so if the user expects a reply. Put the full feedback in feedback_text, set sentiment ('positive'/'negative') and source, and pass the database the user was working in when you know it.
UploadMediaFile
ChatGPTStore file content for a MediaFile entity. Requires base64-encoded data. Ref: https://developers.geotab.com/myGeotab/apiReference/methods/UploadMediaFile/
ValidateAndSaveReportTemplate
ChatGPTValidate an Excel workbook and save it as a custom ReportTemplate. Returns the templateId, detected reportDataSource and any warning (e.g. macros removed). Invalid files return the API's error message. Ref: https://developers.geotab.com/myGeotab/apiReference/methods/ValidateAndSaveReportTemplate/
Add
ClaudeAskDataAgent
ClaudeDecodeVins
ClaudeDismissFaults
ClaudeDownloadMediaFile
ClaudeEmissionEnrollDevices
ClaudeGet
ClaudeGetAceResults
ClaudeGetCountOf
ClaudeGetDashBoard
ClaudeGetDashboardJson
ClaudeGetDevicesInformation
ClaudeGetEmissionComplianceDeadline
ClaudeGetEntity
ClaudeGetExcel
ClaudeGetHosRuleSets
ClaudeGetMediaUrl
ClaudeGetPostedRoadSpeedsForDevice
ClaudeGetReportData
ClaudeGetReportSchedules
ClaudeGetReportStorageFile
ClaudeGetReportStorageFileFromCloud
ClaudeGetReportTemplateWithoutDetails
ClaudeGetSkill
ClaudeListEntities
ClaudeRemove
ClaudeSearchMedia
ClaudeSendReportProcessingRequest
ClaudeSet
ClaudeSubmitFeedback
ClaudeUploadMediaFile
Claude