MCP Tools Reference: chatmcp.googleapis.com

Ferramenta: search_conversations

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

Se apenas os participantes forem fornecidos, essa ferramenta vai encontrar mensagens diretas 1:1 (se um participante for fornecido) ou chats 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 pesquisar conversas em que a consulta seja uma substring que não diferencia maiúsculas de 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, em seguida, filtrá-las pelo 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 está fazendo a chamada faz parte.

Essa ferramenta só lista conversas de que o usuário que está fazendo a chamada faz parte.

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 você deve continuar a pesquisa.

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

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

Mensagem de solicitação para a RPC FindConversations.

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 do espaço.
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

Mensagem de resposta para a RPC FindConversations.

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)

A última hora ativa 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, inclusive (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. Precisa estar entre 0 e 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 Um grupo de chat entre três ou mais pessoas.
DIRECT_MESSAGE Uma mensagem direta entre dois humanos ou um humano e um app do Chat.

Anotações de ferramentas

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