MCP Tools Reference: paydeveloper.googleapis.com

Ferramenta: delete_principal

Exclui o acesso de um principal (usuário) a um comerciante específico. Essa operação requer acesso de administrador para o comerciante.

O exemplo de código a seguir mostra como usar curl para chamar a ferramenta delete_principal do MCP.

Solicitação Curl 
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

Mensagem de solicitação para excluir um principal de um comerciante.

DeletePrincipalRequest

Representação JSON 
{
  "merchantId": string,
  "email": string
}
Campos
merchantId

string

Obrigatório. O ID do comerciante do qual o principal será excluído.
email

string

Obrigatório. O endereço de e-mail do principal cujo acesso será excluído.

Esquema de saída

Mensagem de resposta para excluir um principal de um comerciante.

Anotações da ferramenta

As anotações da ferramenta são enviadas aos clientes do MCP para descrever o risco básico de uma determinada ferramenta. A maioria dos clientes trata essas dicas como não confiáveis, mas elas podem ser usadas para decidir quando um aviso de confirmação pode ser enviado a um usuário.

Além da string de título, as seguintes dicas booleanas são definidas da seguinte maneira:

  • readOnlyHint: se for verdadeiro, a ferramenta não modifica o ambiente. Padrão: falso.
  • destructiveHint: se for verdadeiro, a ferramenta poderá realizar ações destrutivas. Se for falso, a ferramenta só poderá realizar ações aditivas. Padrão: verdadeiro.
  • idempotentHint: se for verdadeiro, chamar a ferramenta repetidamente com os mesmos argumentos não terá efeito adicional no ambiente. Padrão: falso.
  • openWorldHint: se for verdadeiro, a ferramenta poderá interagir com um "mundo aberto" de entidades externas. Se for falso, a ferramenta só poderá interagir com entidades internas. Por exemplo, uma ferramenta de pesquisa na Web seria de mundo aberto, enquanto uma ferramenta de memória não seria.

Dica destrutiva: ✅ | Dica idempotente: ✅ | Dica somente leitura: ❌ | Dica de mundo aberto: ❌