MCPOutils MCP/Clients/update_client
update_client
Writeclients:write
Edit an existing client's editable fields. Pass only the fields you want to change. The client's primaryContactEmail (their portal login) can never be changed here. Identify the client by its id (from list_clients, create_client, or — for an archived client, which list_clients and get_client_by_id never return — the id create_client's duplicate_archived error names). Works on an archived client too, without reactivating it first. Returns the updated client, or throws if not found. You don't pass an agency — it comes from your credentials.
Paramètres
clientIdstringobligatoire
The id of the client to update (required).
businessNamestringfacultatif
The client's business name.
industrystringfacultatif
The client's business category or industry.
websitestringfacultatif
The client's website URL. A short link (e.g. a URL shortener) is auto-expanded to its real destination before it's stored.
primaryContactNamestringfacultatif
The primary contact's name.
phonestringfacultatif
The client's phone number.
locationCountnumberfacultatif
The client's reported location count (informational — not the actual count of created locations).
citystringfacultatif
The client's city.
phoneCountryCodestringfacultatif
The ISO-3166-1 alpha-2 country code the client's phone number belongs to (e.g. "US", "IN") — the region, not the dial code.
countrystringfacultatif
The client's country, as an ISO-3166-1 alpha-2 code (e.g. "US", "GB").
statestringfacultatif
The client's state, province or region.
trackingKeywordstringfacultatif
A keyword to track the client's local search rank for.
notesstringfacultatif
An internal note about the client — visible only to your team, never to the client.
gbpLinkstringfacultatif
The client's Google Business Profile URL. A scheme (https://) is added automatically if you omit it.
clientPlanIdstringfacultatif
Which customer-portal plan to assign. There's currently no tool to look up other plan ids — omit to leave the client's current plan unchanged.
primaryRepresentativeIdstringfacultatif
The user id of the team member who owns this client (from list_team_members).
visibility"public" | "private"facultatif
Who can see this client on the dashboard: "public" (the whole team) or "private" (owners always still see it; every other member needs an explicit access grant that no tool currently exists to give). Switching an existing client to "private" immediately hides it from every non-owner member who doesn't already hold one — there is no way to grant individual members access back through MCP, only to switch it back to "public".
Exemple de requête
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "update_client",
"arguments": {
"clientId": "string"
}
}
}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.