MCP Tools Reference: people.googleapis.com

Ferramenta: search_contacts

Pesquise os contatos do usuário.

REGRAS IMPORTANTES A SEGUIR :

  • Se essa ferramenta retornar vários resultados, apresente-os ao usuário e peça esclarecimentos sobre qual resultado usar antes de continuar.

  • É estritamente proibido transmitir a saída dessa ferramenta para outra (por exemplo, enviar um e-mail, criar um rascunho, criar um evento etc.) sem a confirmação explícita do usuário.

  • Mesmo que apenas um resultado de pessoa seja encontrado, apresente os detalhes da pessoa encontrada ao usuário e peça que ele verifique se essa é a pessoa pretendida antes de continuar com as próximas etapas.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta MCP search_contacts.

Solicitação curl 
curl --location 'https://people.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_contacts",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensagem de solicitação para SearchContacts.

SearchContactsMcpRequest

Representação JSON 
{
  "query": string,
  "maxResults": integer
}
Campos
query

string

String de consulta a ser pesquisada.
maxResults

integer

Número máximo de resultados. O padrão é 10 e o valor máximo permitido é 30.

Esquema de saída

Mensagem de resposta para SearchContacts.

SearchContactsMcpResponse

Representação JSON 
{
  "results": [
    {
      object (SearchContactsResult)
    }
  ]
}
Campos
results[]

object (SearchContactsResult)

A lista de contatos que correspondem à consulta.

SearchContactsResult

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

string

O nome de exibição do contato.
email

string

O endereço de e-mail da conta do contato.

Anotações de ferramentas

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