List locations

List customer locations by name, company or status.

MCP tool servicetrade_read → list_locations

read

Returns the id, name, reference number, address and status of each location. Use the id in list_jobs, list_deficiencies and create_quote.

Parameters

Parameters: list_locations
NameTypeDescription
name string string Part of the location name or store number.
company_id integer integer Only locations of this company.
status string string One of active, inactive, pending.
cursor string string Next page cursor from the previous call.

tools/call

JSON-RPC

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

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "locations": [
      {
        "id": 5120,
        "name": "Harbor Point Mall",
        "ref_number": "HPM",
        "address": {
          "street": "100 Harbor Point Rd",
          "city": "Baltimore",
          "state": "MD",
          "postal_code": "21230"
        },
        "status": "active"
      }
    ],
    "next_cursor": null
  },
  "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.