List jobs
List jobs filtered by status, location, customer, technician or due date.
MCP tool servicetrade_read → list_jobs
read
Returns the job number, name, type, status, location, customer and due date, and the number of services still open. The agent sorts by due date itself. A job with status new is shown by ServiceTrade as Unscheduled. What you see follows your role in ServiceTrade.
Parameters
| Name | Type | Description |
|---|---|---|
| status string | string | One or more of new (shown as Unscheduled), scheduled, canceled, bidding, completed, pending_invoice, sending_invoice, invoiced, closed, comma-separated. |
| location_id integer | integer | Only jobs at this location, from list_locations. |
| customer_id integer | integer | Only jobs for this customer company. |
| technician_id integer | integer | Only jobs with an appointment for this technician, from list_technicians. |
| due_by_before string | string | ISO 8601 date or date-time; only jobs due on or before it. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "servicetrade_read",
"arguments": {
"operation": "list_jobs",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"jobs": [
{
"id": 48213,
"number": 1042,
"name": "Fire pump test",
"type": "planned_maintenance",
"status": "new",
"display_status": "Unscheduled",
"location": {
"id": 5120,
"name": "Harbor Point Mall"
},
"customer": {
"id": 2211,
"name": "Harbor Point Properties"
},
"due_by": "2026-10-30",
"open_services": 2
}
],
"next_cursor": null
},
"isError": false
}