Get a job

Read one job with its services, appointments and notes.

MCP tool servicetrade_read → get_job

read

Returns the status, location, customer, the services (service requests) with their descriptions and statuses, the current appointment and the technicians on it, and the job notes. Use it right before changing a job to see what another user has done.

Parameters

Parameters: get_job
NameTypeDescription
job_id integer required integer Job id from list_jobs.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "servicetrade_read",
    "arguments": {
      "operation": "get_job",
      "arguments": {
        "job_id": 1
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "id": 48213,
    "number": 1042,
    "name": "Fire pump test",
    "type": "planned_maintenance",
    "status": "new",
    "display_status": "Unscheduled",
    "location": {
      "id": 5120,
      "name": "Harbor Point Mall"
    },
    "services": [
      {
        "id": 77302,
        "description": "Annual fire pump flow test",
        "status": "open"
      }
    ],
    "appointments": [],
    "notes": []
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.