MCP Tools Reference: chatmcp.googleapis.com

Ferramenta: search_conversations

Pesquisa conversas do Google Chat pelo nome de exibição.

Se apenas participantes forem fornecidos, essa ferramenta vai encontrar mensagens diretas individuais (se um participante for fornecido) ou conversas em grupo (se vários participantes forem fornecidos) que incluam os participantes especificados e o usuário que está fazendo a chamada.

Se apenas uma consulta for fornecida, essa ferramenta vai procurar conversas em que a consulta é uma substring sem diferenciação de maiúsculas e minúsculas do nome de exibição da conversa.

Se os participantes e a consulta forem fornecidos, essa ferramenta vai encontrar conversas por participantes e depois filtrar por nome de exibição.

Se nem os participantes nem a consulta forem fornecidos, essa ferramenta vai listar todas as conversas de que o usuário que fez a chamada participa.

Essa ferramenta só lista as conversas de que o usuário que está ligando participa.

IMPORTANTE: uma lista "conversations" vazia não significa que não há mais resultados no geral. 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 você deve continuar a pesquisa.

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

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

Esquema de entrada

Solicitação para pesquisar conversas do Google Chat usando filtros.

SearchConversationsRequest

Representação JSON 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
Campos
spaceNameQuery

string

Opcional. O texto a ser pesquisado nos nomes de exibição dos espaços.
pageSize

integer

Opcional. O número máximo de espaços a serem retornados. O serviço pode retornar um valor inferior a este. Se não for especificado, no máximo 100 espaços serão retornados. O valor máximo é 1.000. Valores maiores serão convertidos para 1.000.
pageToken

string

Opcional. Um token de página recebido de uma chamada search_conversations anterior. Forneça isso para recuperar a página subsequente.
participants[]

string

Opcional. Lista de endereços de e-mail dos participantes para filtrar as conversas, excluindo o autor da chamada.

Esquema de saída

Resposta contendo a lista de conversas correspondentes.

SearchConversationsResponse

Representação JSON 
{
  "conversations": [
    {
      object (Conversation)
    }
  ],
  "nextPageToken": string
}
Campos
conversations[]

object (Conversation)

Lista de objetos de conversa que correspondem aos critérios de pesquisa.
nextPageToken

string

Um token que pode ser enviado como page_token para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

Conversa

Representação JSON 
{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}
Campos
conversationId

string

O ID da conversa (por exemplo, "spaces/AAAAAAAAA").
displayName

string

O nome de exibição da conversa.
conversationType

enum (ConversationType)

O tipo de conversa (DIRECT_MESSAGE, GROUP_CHAT ou NAMED_SPACE).
lastActiveTimestamp

string (Timestamp format)

O último horário de atividade da conversa no formato ISO 8601.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

Carimbo de data/hora

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa os segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z. Precisa estar entre -62135596800 e 253402300799 (o que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Frações não negativas de um segundo com resolução de nanossegundos. Esse campo é a parte de nanossegundos da duração, não uma alternativa aos segundos. Os valores de segundos negativos com frações ainda precisam ter valores em nanossegundos não negativos que representam períodos posteriores. O valor precisa ser de 0 a 999.999.999 (inclusive).

ConversationType

Define o tipo de conversa.

Tipos enumerados
CONVERSATION_TYPE_UNSPECIFIED Não especificado.
NAMED_SPACE Um espaço nomeado.
GROUP_CHAT Uma conversa em grupo entre três ou mais pessoas.
DIRECT_MESSAGE Uma mensagem direta entre duas pessoas ou entre uma pessoa e um app de chat.

Anotações de ferramentas

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