MCPMCP-Tools/Standorte/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.

Parameter
clientIdstringoptional
Limit to a single client's locations (get the id from list_clients). Omit to list across all of the agency's locations.
searchstringoptional
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"optional
A single status bucket. Allowed values: "all", "active" (not archived), "archived", "archival_pending", "verification_pending" (approval pending), "unapproved", "requires_action". Defaults to all.
tagsstring[]optional
Internal tags — matches a location that has any of these.
categoriesstring[]optional
Category names — matches a location whose general or Google category is any of these.
verification("verified" | "pending" | "unverified" | "unknown")[]optional
Google verification state. Allowed values: "verified", "pending", "unverified", "unknown".
createdAfterstringoptional
Only locations created on or after this date (e.g. "2026-01-01").
createdBeforestringoptional
Only locations created on or before this date.
cursorstringoptional
Leave empty for the first page; to get the next page, pass the `nextCursor` from the previous response.
limitnumberoptional
How many locations to return per page (1–200, default 50).
Beispielanfrage
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_locations",
    "arguments": {}
  }
}
Beispielantwort
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

Die Antwortform dient nur zur Veranschaulichung — der tatsächliche Inhalt hängt vom Tool und Ihren Daten ab.