MCPOutils MCP/Emplacements/list_locations

list_locations

Readlocations:read

List a client's business locations, newest first. This is the starting point for anything about locations: use it to find a location and its id before calling update_location, or to answer questions like "how many active locations does this client have?", "which locations still need verification?", or "show locations tagged test-pipeline". All filters are optional and are combined together (a location must match all of them); tags, categories, and verification each accept multiple values and match any of them. Returns a page of location summaries plus a running `total` and a `nextCursor` — each summary has the location's name, address (street/city/state/postalCode/country as one joined line plus their own fields), phone, website, store code, category, tags, labels, status, verification, how many saved edits haven't synced to publishers yet (pendingChanges), when it was last published, and its client. To page through more, call again passing the returned `nextCursor`. You don't pass an agency — it comes from your credentials.

Paramètres
clientIdstringfacultatif
Limit to a single client's locations (get the id from list_clients). Omit to list across all of the agency's locations.
searchstringfacultatif
Free-text search over the location's name, street address, city, or phone (case-insensitive, partial matches allowed).
status"all" | "active" | "archived" | "archival_pending" | "verification_pending" | "unapproved" | "requires_action"facultatif
A single status bucket. Allowed values: "all", "active" (not archived), "archived", "archival_pending", "verification_pending" (approval pending), "unapproved", "requires_action". Defaults to all.
tagsstring[]facultatif
Internal tags — matches a location that has any of these.
categoriesstring[]facultatif
Category names — matches a location whose general or Google category is any of these.
verification("verified" | "pending" | "unverified" | "unknown")[]facultatif
Google verification state. Allowed values: "verified", "pending", "unverified", "unknown".
createdAfterstringfacultatif
Only locations created on or after this date (e.g. "2026-01-01").
createdBeforestringfacultatif
Only locations created on or before this date.
cursorstringfacultatif
Leave empty for the first page; to get the next page, pass the `nextCursor` from the previous response.
limitnumberfacultatif
How many locations to return per page (1–200, default 50).
Exemple de requête
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_locations",
    "arguments": {}
  }
}
Exemple de réponse
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

La forme de la réponse est indicative — le contenu réel dépend de l'outil et de vos données.