MCPOutils MCP/Clients/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.

Paramètres
searchstringfacultatif
Free-text search over the client's name, industry, or contact email (case-insensitive, partial matches allowed).
status("complete" | "draft")[]facultatif
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[]facultatif
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")[]facultatif
The client's primary goal. Allowed values: "improve_rankings" (improve search rankings), "get_reviews" (get more/better reviews), "fix_listings" (fix business listings).
healthMinnumberfacultatif
Lowest health score to include, 0–100 (the client's overall health rating).
healthMaxnumberfacultatif
Highest health score to include, 0–100.
locationsMinnumberfacultatif
Fewest locations a client must have. Clients with an unknown location count are skipped when a locations filter is set.
locationsMaxnumberfacultatif
Most locations a client can have.
createdAfterstringfacultatif
Only clients created on or after this date (e.g. "2026-01-01").
createdBeforestringfacultatif
Only clients created on or before this date.
archived"active" | "archived" | "all"facultatif
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.
cursorstringfacultatif
Leave empty for the first page; to get the next page, pass the `nextCursor` from the previous response.
limitnumberfacultatif
How many clients to return per page (1–200, default 50).
Exemple de requête
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_clients",
    "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.