Tools and parameters¶
This reference is generated from the MCP 0.2.0 source definitions, without contacting a live API or reading customer data. See release status before use.
Download the complete tool definitions. The live server's tools/list is authoritative for its deployed input schema.
list_drives¶
Read work-classified fleet drives only; private and unknown classes are excluded. Returns id, fleet_id, driver_id/vehicle_id (null for missing or ambiguous current fleet-registry matches), drive_class=work, distance_km, started_at/ended_at and work_id (free text, not a validated order). IDs identify registry rows, not historical assignments. Times use the source application timezone. Recorded drives are not payroll/billing approvals. Use pagination=snapshot for stable bounded exports; changes/deletions are not a feed.
Input schema¶
{
"type": "object",
"properties": {
"from": {
"type": "string",
"description": "First date, YYYY-MM-DD, inclusive."
},
"to": {
"type": "string",
"description": "Last date, YYYY-MM-DD, inclusive. Maximum 366 days."
},
"driver": {
"type": "string",
"description": "Optional exact driver username."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 10000,
"default": 0
},
"pagination": {
"type": "string",
"enum": [
"offset",
"snapshot"
],
"default": "offset",
"description": "Use snapshot for integration exports: frozen values, at most 10000 rows/4 MiB, expires in 15 minutes; at most 3 active snapshots per fleet. Offset is a live view and can shift during writes."
},
"cursor": {
"type": "string",
"maxLength": 128,
"description": "For pagination=snapshot, omit on first call, then pass next_cursor with identical from/to/driver/limit until null. Deleted, moved or now-private rows are withheld; continue even after an empty page. Not a change feed."
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
}
summarize_drives¶
Count work-classified drives and distance by driver in the authenticated fleet. Private and unknown drive classes are excluded. These are recorded distances, not approved payroll or billable quantities.
Input schema¶
{
"type": "object",
"properties": {
"from": {
"type": "string",
"description": "First date, YYYY-MM-DD, inclusive."
},
"to": {
"type": "string",
"description": "Last date, YYYY-MM-DD, inclusive. Maximum 366 days."
},
"driver": {
"type": "string",
"description": "Optional exact driver username."
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
}
list_work_sessions¶
Read fleet work diary sessions and recorded hours, with id, fleet_id and driver_id (null unless uniquely matched in the current fleet registry). Times use the source application timezone. Use pagination=snapshot for stable bounded exports. These are not payroll approvals or a change feed.
Input schema¶
{
"type": "object",
"properties": {
"from": {
"type": "string",
"description": "First date, YYYY-MM-DD, inclusive."
},
"to": {
"type": "string",
"description": "Last date, YYYY-MM-DD, inclusive. Maximum 366 days."
},
"driver": {
"type": "string",
"description": "Optional exact driver username."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 10000,
"default": 0
},
"pagination": {
"type": "string",
"enum": [
"offset",
"snapshot"
],
"default": "offset",
"description": "Use snapshot for integration exports: frozen values, at most 10000 rows/4 MiB, expires in 15 minutes; at most 3 active snapshots per fleet. Offset is a live view and can shift during writes."
},
"cursor": {
"type": "string",
"maxLength": 128,
"description": "For pagination=snapshot, omit on first call, then pass next_cursor with identical from/to/driver/limit until null. Deleted, moved or now-private rows are withheld; continue even after an empty page. Not a change feed."
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
}
summarize_work_sessions¶
Use this to total recorded work diary hours by driver for a date range. These are stored hours, not payroll calculations.
Input schema¶
{
"type": "object",
"properties": {
"from": {
"type": "string",
"description": "First date, YYYY-MM-DD, inclusive."
},
"to": {
"type": "string",
"description": "Last date, YYYY-MM-DD, inclusive. Maximum 366 days."
},
"driver": {
"type": "string",
"description": "Optional exact driver username."
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
}
Common response rules¶
Successful tool calls expose structuredContent and isError: false. Lists return period and either drives or work_sessions, plus pagination metadata. Summaries return period, total and by_driver. Read the field reference, error handling and pagination guide.