MCPHerramientas MCP/Ubicaciones/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.

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

La forma de la respuesta se muestra a modo ilustrativo — el contenido real depende de la herramienta y de tus datos.