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 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 fez 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 participantes e consulta forem fornecidos, essa ferramenta vai encontrar conversas por participantes e, em seguida, filtrá-las por nome de exibição.

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

Essa ferramenta só lista conversas de que o usuário que fez 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 de curl 
curl --location 'https://chatmcp.googleapis.com/mcp' \
--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 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 (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 a 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).

Anotações de ferramentas

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