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

Parameter
searchstringoptional
Free-text search over the client's name, industry, or contact email (case-insensitive, partial matches allowed).
status("complete" | "draft")[]optional
Client status. Use "complete" for active (fully onboarded) clients and "draft" for ones still being set up. Pass both to include all.
representativeIdsstring[]optional
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")[]optional
The client's primary goal. Allowed values: "improve_rankings" (improve search rankings), "get_reviews" (get more/better reviews), "fix_listings" (fix business listings).
healthMinnumberoptional
Lowest health score to include, 0–100 (the client's overall health rating).
healthMaxnumberoptional
Highest health score to include, 0–100.
locationsMinnumberoptional
Fewest locations a client must have. Clients with an unknown location count are skipped when a locations filter is set.
locationsMaxnumberoptional
Most locations a client can have.
createdAfterstringoptional
Only clients created on or after this date (e.g. "2026-01-01").
createdBeforestringoptional
Only clients 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 clients to return per page (1–200, default 50).
Beispielanfrage
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_clients",
    "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.