MCPHerramientas MCP/Clientes/list_clients

list_clients

Readclients:read

List the client businesses this agency manages, newest first. This is the starting point for anything about clients: use it to find a client and its id before calling get_client_by_id, or to answer questions like "how many active clients do we have?", "which clients are assigned to a rep?", or "show clients with a health score under 40". All filters are optional and are combined together (a client must match all of them); status, representativeIds, and goals each accept multiple values and match any of them. Returns a page of client summaries plus a running `total` and a `nextCursor` — each summary has the client's name, industry, status, goal, health score, number of locations, Google rating and review count, plan, created date, and assigned representative. To page through more, call again passing the returned `nextCursor`. You don't pass an agency — it comes from your credentials. Sensitive data (login credentials, portal secrets) is never returned.

Parámetros
searchstringopcional
Free-text search over the client's name, industry, or contact email (case-insensitive, partial matches allowed).
status("complete" | "draft")[]opcional
Onboarding stage, NOT access: "complete" = fully onboarded, "draft" = still being set up. Every client this returns is one this person can use, Draft included. Filter on it only when asked about onboarding (e.g. "how many active clients"); never to find a client by name.
representativeIdsstring[]opcional
The assigned account representative(s). Pass one or more team-member ids (from list_team_members); a client matches if its representative is any of them.
goals("improve_rankings" | "get_reviews" | "fix_listings")[]opcional
The client's primary goal. Allowed values: "improve_rankings" (improve search rankings), "get_reviews" (get more/better reviews), "fix_listings" (fix business listings).
healthMinnumberopcional
Lowest health score to include, 0–100 (the client's overall health rating).
healthMaxnumberopcional
Highest health score to include, 0–100.
locationsMinnumberopcional
Fewest locations a client must have. Clients with an unknown location count are skipped when a locations filter is set.
locationsMaxnumberopcional
Most locations a client can have.
createdAfterstringopcional
Only clients created on or after this date (e.g. "2026-01-01").
createdBeforestringopcional
Only clients created on or before this date.
archived"active" | "archived" | "all"opcional
Which clients to list: "active" (default — the live ones), "archived" (only archived clients; use this to find one to restore with reactivate_client), or "all". Archived clients are never mixed into the default list.
cursorstringopcional
Leave empty for the first page; to get the next page, pass the `nextCursor` from the previous response.
limitnumberopcional
How many clients to return per page (1–200, default 50).
Solicitud de ejemplo
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_clients",
    "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.