Herramienta: delete_principal
Elimina el acceso de una entidad principal (usuario) a un comercio específico. Esta operación requiere que el comerciante tenga acceso de administrador.
En el siguiente código de ejemplo se muestra cómo usar curl para llamar a la herramienta delete_principal de MCP.
| Curl Request |
|---|
curl --location 'https://paydeveloper.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "delete_principal", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
Esquema de entrada
Mensaje de solicitud para eliminar un principal de un comerciante.
DeletePrincipalRequest
| Representación JSON |
|---|
{ "merchantId": string, "email": string } |
| Campos | |
|---|---|
merchantId |
Obligatorio. El ID de comerciante del que se va a eliminar la cuenta principal. |
email |
Obligatorio. Dirección de correo del principal cuyo acceso se debe eliminar. |
Esquema de salida
Mensaje de respuesta para eliminar un principal de un comerciante.
Anotaciones de herramientas
Las anotaciones de herramientas se envían a los clientes de MCP para describir el riesgo básico de una herramienta concreta. La mayoría de los clientes tratan estas sugerencias como no fiables, pero se pueden usar para decidir cuándo se puede enviar una petición de confirmación a un usuario.
Además de la cadena del título, se definen las siguientes sugerencias booleanas:
readOnlyHint: si es true, la herramienta no modifica su entorno. Valor predeterminado: false.destructiveHint: si es true, la herramienta puede realizar acciones destructivas. Si es false, la herramienta solo puede realizar acciones aditivas. Valor predeterminado: true.idempotentHint: si es true, llamar a la herramienta repetidamente con los mismos argumentos no tendrá ningún efecto adicional en su entorno. Valor predeterminado: false.openWorldHint: si es true, la herramienta puede interactuar con un "mundo abierto" de entidades externas. Si es false, la herramienta solo podrá interactuar con entidades internas. Por ejemplo, una herramienta de búsqueda web sería de mundo abierto, mientras que una herramienta de memoria no lo sería.
Pista destructiva: ✅ | Pista idempotente: ✅ | Pista de solo lectura: ❌ | Pista de mundo abierto: ❌