MCP Tools Reference: chatmcp.googleapis.com

Ferramenta: search_conversations

Pesquisa conversas do Google Chat para encontrar IDs de conversa. Os espaços nomeados são encontrados pelo nome de exibição (space_name_query). As mensagens diretas (DMs) e os grupos de chat são encontrados apenas pelos endereços de e-mail dos participantes (participants).

Essa ferramenta pesquisa metadados de conversas, NÃO o conteúdo das mensagens. Para pesquisar no histórico de mensagens ou encontrar mensagens por palavra-chave/remetente/carimbo de data/hora, use search_messages.

Se apenas participants forem fornecidos, essa ferramenta vai encontrar mensagens diretas individuais (se um participante for fornecido) ou grupos de chat (se vários participantes forem fornecidos) que incluam os participantes especificados e o usuário que está fazendo a chamada. Os espaços com nome não são retornados.

Se apenas um space_name_query for fornecido, essa ferramenta vai pesquisar APENAS espaços com nome em que a consulta é uma substring que não diferencia maiúsculas de minúsculas do nome de exibição do espaço. As mensagens diretas e os grupos de chat nunca são retornados. Portanto, NÃO transmita o nome de uma pessoa como space_name_query para encontrar uma mensagem direta com ela. Em vez disso, procure o endereço de e-mail dela e transmita-o em participants.

Se participants e space_name_query forem fornecidos, essa ferramenta vai encontrar mensagens diretas ou grupos de chat por participantes e, em seguida, filtrá-los por nome de exibição.

Se nem participants nem space_name_query forem fornecidos, essa ferramenta vai listar os espaços nomeados em que o usuário que fez a chamada é participante (as mensagens diretas e os grupos de chat não estão incluídos).

Essa ferramenta só lista as conversas em que o usuário que está ligando é membro.

Retorna uma lista de objetos de conversa que contêm IDs de conversa (formato: spaces/{space}), nomes de exibição e tipos de conversa.

IMPORTANTE: uma lista conversations vazia não significa que não há mais resultados. Se next_page_token estiver presente, mais páginas poderão ser buscadas. Se você receber uma lista vazia, mas um next_page_token, pergunte ao usuário se deve continuar a pesquisa.

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

Esquema de entrada

{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}

Esquema de saída

{
  "conversations": [
    {
      object (Conversation)
    }
  ],
  "nextPageToken": string
}

{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}

{
  "seconds": string,
  "nanos": integer
}

Anotações de ferramentas

As anotações de ferramentas 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 uma solicitação de confirmação pode ser enviada a um usuário.

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

• readOnlyHint: se for verdadeiro, a ferramenta não vai modificar 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 jogos de mundo aberto: ❌

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

• https://www.googleapis.com/auth/chat.memberships.readonly
• https://www.googleapis.com/auth/chat.spaces
• https://www.googleapis.com/auth/chat.spaces.readonly