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

Parámetros

clientIdstringobligatorio

The id of the client to update (required).

businessNamestringopcional

The client's business name.

industrystringopcional

The client's business category or industry.

websitestringopcional

The client's website URL. A short link (e.g. a URL shortener) is auto-expanded to its real destination before it's stored.

primaryContactNamestringopcional

The primary contact's name.

phonestringopcional

The client's phone number.

locationCountnumberopcional

The client's reported location count (informational — not the actual count of created locations).

citystringopcional

The client's city.

phoneCountryCodestringopcional

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.

countrystringopcional

The client's country, as an ISO-3166-1 alpha-2 code (e.g. "US", "GB").

statestringopcional

The client's state, province or region.

trackingKeywordstringopcional

A keyword to track the client's local search rank for.

notesstringopcional

An internal note about the client — visible only to your team, never to the client.

gbpLinkstringopcional

The client's Google Business Profile URL. A scheme (https://) is added automatically if you omit it.

clientPlanIdstringopcional

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.

primaryRepresentativeIdstringopcional

The user id of the team member who owns this client (from list_team_members).

visibility"public" | "private"opcional

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".

Solicitud de ejemplo

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_client",
    "arguments": {
      "clientId": "string"
    }
  }
}

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.