MCP Tools Reference: chatmcp.googleapis.com

Herramienta: send_message

Envía un mensaje de Google Chat a una conversación con formato de Markdown.

Esta herramienta usa un ID de conversación, un ID de subproceso opcional y un texto de mensaje como entradas.

Los IDs de conversación se pueden encontrar con la herramienta search_conversations.

Devuelve el mensaje creado.

En la siguiente muestra de código, se muestra cómo usar curl para llamar a la herramienta de MCP send_message.

Solicitud de Curl 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "send_message",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

SendMessageRequest

Representación JSON 
{
  "conversationId": string,
  "threadId": string,
  "messageText": string
}
Campos
conversationId

string

Obligatorio. ID de la conversación (p. ej., "spaces/AAAA…") a la que se enviará el mensaje.
threadId

string

Opcional. ID del subproceso (p.ej., "spaces/AAAA.../threads/BBBB...") al que se enviará el mensaje. Si no se configura, el mensaje se enviará a un nuevo subproceso.
messageText

string

Obligatorio. Es el contenido principal del mensaje. Puedes agregar formato con Markdown estándar (ten en cuenta que NO se admiten las tablas). Se admite el siguiente formato:

  • Negrita: **text**
  • Cursiva: *text* o _text_
  • Tachado: ~~text~~
  • Monoespacio: text
  • Bloque de espacio único:
```
line 1
line 2
```
  • Lista con viñetas:
* item 1
* item 2
  • Lista ordenada:
1. item 1
2. item 2
  • Cita en bloque: > quoted text
  • Hipervínculo: [label](url)
  • Menciona al usuario: Usa una etiqueta HTML de cierre automático chat-user con los atributos data-email="user@example.com" o data-user="users/USER_ID". Prefiere el atributo data-user con USER_ID si se conoce y, de lo contrario, recurre al atributo data-email con el correo electrónico del usuario. Si usas el atributo data-user, asegúrate de incluir el prefijo users/ que se ve en otros valores de devolución de la herramienta. Nota: Se permite un máximo de 10 menciones por mensaje. Está estrictamente prohibido mencionar a todos los usuarios (p.ej., con @all o una etiqueta HTML con users/all).
  • Emoji personalizado: Usa una etiqueta HTML de cierre automático chat-emoji con atributos data-custom-emoji="customEmojis/abc" o data-emoji-name=":xyz:".

Esquema de salida

Es la respuesta al envío de un mensaje a una conversación de Google Chat.

SendMessageResponse

Representación JSON 
{
  "message": {
    object (ChatMessage)
  }
}
Campos
message

object (ChatMessage)

Es el mensaje que se envió.

ChatMessage

Representación JSON 
{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}
Campos
messageId

string

Es el nombre del recurso del mensaje. Formato: spaces/{space}/messages/{message}
threadId

string

Es la conversación a la que pertenece este mensaje. Este campo estará vacío si el mensaje no está en un subproceso. Formato: spaces/{space}/threads/{thread}
plaintextBody

string

Cuerpo del mensaje en formato Markdown.
sender

object (User)

Es el remitente del mensaje.
createTime

string

Solo salida. Es la marca de tiempo de cuando se creó el mensaje.
threadedReply

boolean

Indica si el mensaje es una respuesta en una conversación.
attachments[]

object (ChatAttachmentMetadata)

Son los archivos adjuntos incluidos en el mensaje.
reactionSummaries[]

object (ReactionSummary)

Es el resumen de las reacciones con emojis que se incluye en el mensaje.

Usuario

Representación JSON 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Campos
userId

string

Es el nombre del recurso de un usuario de Chat. El formato es users/{user}.
displayName

string

Es el nombre visible de un usuario de Chat.
email

string

Es la dirección de correo electrónico del usuario. Este campo solo se completa cuando el tipo de usuario es HUMAN.
userType

enum (UserType)

Es el tipo de usuario.

ChatAttachmentMetadata

Representación JSON 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
Campos
attachmentId

string

Es el nombre del recurso del archivo adjunto. El formato es spaces/{space}/messages/{message}/attachments/{attachment}.
filename

string

Nombre del archivo adjunto.
mimeType

string

Tipo de contenido (tipo de MIME).
source

enum (Source)

Es la fuente del adjunto.

ReactionSummary

Representación JSON 
{
  "emoji": string,
  "count": integer
}
Campos
emoji

string

Es la cadena Unicode del emoji o el nombre del emoji personalizado.
count

integer

Es la cantidad total de reacciones con el emoji asociado.

UserType

Es el tipo de usuario de Google Chat.

Enums
USER_TYPE_UNSPECIFIED Sin especificar.
HUMAN Usuario humano.
APP Usuario de la app.

Fuente

Es la fuente del adjunto.

Enums
SOURCE_UNSPECIFIED Reservado.
DRIVE_FILE El archivo es un archivo de Google Drive.
UPLOADED_CONTENT El archivo se subirá a Chat.

Anotaciones de herramientas

Las anotaciones de herramientas se envían a los clientes de MCP para describir el riesgo básico de una herramienta determinada. La mayoría de los clientes tratan estas sugerencias como no confiables, pero se pueden usar para decidir cuándo se le puede enviar un mensaje de confirmación a un usuario.

Junto con la cadena de título, se definen las siguientes sugerencias booleanas:

  • readOnlyHint: Si es verdadero, la herramienta no modifica su entorno. Valor predeterminado: false.
  • destructiveHint: Si es verdadero, la herramienta puede realizar acciones destructivas. Si es falso, la herramienta solo puede realizar acciones aditivas. Valor predeterminado: true.
  • idempotentHint: Si es verdadero, llamar a la herramienta de forma repetida con los mismos argumentos no tendrá ningún efecto adicional en su entorno. Valor predeterminado: false.
  • openWorldHint: Si es verdadero, la herramienta puede interactuar con un "mundo abierto" de entidades externas. Si es falso, la herramienta solo puede interactuar con entidades internas. Por ejemplo, una herramienta de búsqueda web sería de mundo abierto, mientras que una herramienta de memoria no lo sería.

Sugerencia destructiva: ❌ | Sugerencia idempotente: ❌ | Sugerencia de solo lectura: ❌ | Sugerencia de mundo abierto: ✅

Alcances de la autorización

Se necesita uno de los siguientes alcances de OAuth:

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.create