MCPFerramentas MCP/Clientes/add_client_credits

add_client_credits

Writeclient-credits:write

Add positive whole credits to one client's wallet, matching the Clients Add credits action. credits must be 1–1,000,000,000; note is optional (up to 200 characters). Supply a unique idempotencyKey (8–200 characters) for each intended grant; reuse exactly that key and payload on retries, including across API and MCP, to avoid adding twice. Reusing a key for a different amount/note is refused. Returns the current customer-visible credits and history. Cannot subtract credits or change hidden allocation, package or billing settings. Requires an identified agency user with Clients page access and access to this client.

Parâmetros
creditsintegerobrigatório
notestringopcional
idempotencyKeystringobrigatório
clientIdstringobrigatório
Accepts the database ID or public cli- ID. IDs must belong to the authenticated agency and permitted client.
Exemplo de solicitação
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_client_credits",
    "arguments": {
      "credits": null,
      "idempotencyKey": "string",
      "clientId": "string"
    }
  }
}
Exemplo de resposta
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

O formato da resposta é ilustrativo — o conteúdo real depende da ferramenta e dos seus dados.