9bot

Read, send, and delete messages now

messages_manage

Destructive

Searches accessible message history and performs immediate sends, replies, polls, interactive messages, broadcasts, or revocation requests. Use schedules_manage for future delivery and workflows_design for multi-step processes. External sends are not idempotent: an accepted provider request does not prove recipient-device delivery, and retrying may duplicate content. Delete is destructive and depends on the bot current permissions. For a preview, set input.preview=true; preview never applies the mutation. When confirmation is required, repeat the same operation and parameters with the returned input.confirmation_id.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`input`	No	Parameters for the selected operation. Reuse identifiers returned by read operations and submit only documented fields. Omit input or use an empty object when the operation has no parameters.
`operation`	Yes	Select one operation in this family. Compound names identify a resource and action; list searches records and get reads one identified record. The conditional input schema below defines the required parameters.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`presentation`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedSep 18, 2026

addedInput schema / properties / operation / $comment

Added value: +"{\"9botOperationGuidance\":{\"broadcast_preview\":{\"USE_WHEN\":\"Preview broadcast through the tenant-authorized handler. Use when the intent is specifically to preview broadcast. Use it only for the same content across multiple authorized…\",\"DO_NOT_USE_WHEN\":\"The user asked to change state rather than inspect it.\",\"PREFER_OVER\":null,\"RELATED_READ_OPERATION\":\"broadcast_preview\",\"VERIFICATION_OPERATION\":\"broadcast_preview\"},\"broadcast_send\":{\"USE_WHEN\":\"Send broadcast through the tenant-authorized handler. Use when the intent is specifically to send broadcast. Use it only for the same content across multiple authorized groups…\",\"DO_NOT_USE_WHEN\":\"A read or preview operation can satisfy the request without changing state.\",\"PREFER_OVER\":null,\"RELATED_READ_OPERATION\":null,\"VERIFICATION_OPERATION\":null},\"admins_send\":{\"USE_WHEN\":\"Send administrators through the tenant-authorized handler. Use when the intent is specifically to send administrators. Use it for immediate actions; use schedules_manage for…\",\"DO_NOT_USE_WHEN\":\"A read or preview operation can satisfy the request without changing state.\",\"PREFER_OVER\":null,\"RELATED_READ_OPERATION\":null,\"VERIFICATION_OPERATION\":null},\"buttons_send\":{\"USE_WHEN\":\"Send buttons through the tenant-authorized handler. Use when the intent is specifically to send buttons. Use it for immediate actions; use schedules_manage for future or…\",\"DO_NOT_USE_WHEN\":\"A read or preview operation can satisfy the request without changing state.\",\"PREFER_OVER\":null,\"RELATED_READ_OPERATION\":null,\"VERIFICATION_OPERATION\":null},\"delete\":{\"USE_WHEN\":\"Delete messages through the tenant-authorized handler. Use when the intent is specifically to delete messages. Use it for immediate actions; use schedules_manage for future or…\",\"DO_NOT_USE_WHEN\":\"A read or preview operation can satisfy the request without changing state.\",\"PREFER_OVER\":null,\"RELATED_READ_OPERATION\":\"get\",\"VERIFICATION_OPERATION\":\"get\"},\"get\":{\"USE_WHEN\":\"Read messages through the tenant-authorized handler. Use when the intent is specifically to read messages. Use it for immediate actions; use schedules_manage for future or…\",\"DO_NOT_USE_WHEN\":\"The user asked to change state rather than inspect it.\",\"PREFER_OVER\":null,\"RELATED_READ_OPERATION\":\"get\",\"VERIFICATION_OPERATION\":\"get\"},\"list\":{\"USE_WHEN\":\"List messages through the tenant-authorized handler. Use when the intent is specifically to list messages. Use it for immediate actions; use schedules_manage for future or…\",\"DO_NOT_USE_WHEN\":\"The user asked to change state rather than inspect it.\",\"PREFER_OVER\":null,\"RELATED_READ_OPERATION\":\"list\",\"VERIFICATION_OPERATION\":\"list\"},\"poll_send\":{\"USE_WHEN\":\"Send poll through the tenant-authorized handler. Use when the intent is specifically to send poll. Use it for immediate actions; use schedules_manage for future or recurring…\",\"DO_NOT_USE_WHEN\":\"A read or preview operation can satisfy the request without changing state.\",\"PREFER_OVER\":null,\"RELATED_READ_OPERATION\":null,\"VERIFICATION_OPERATION\":null},\"reply\":{\"USE_WHEN\":\"Operar messages through the tenant-authorized handler. Use when the intent is specifically to operar messages. Use it for immediate actions; use schedules_manage for future or…\",\"DO_NOT_USE_WHEN\":\"A read or preview operation can satisfy the request without changing state.\",\"PREFER_OVER\":null,\"RELATED_READ_OPERATION\":\"reply\",\"VERIFICATION_OPERATION\":\"reply\"},\"send\":{\"USE_WHEN\":\"Send messages through the tenant-authorized handler. Use when the intent is specifically to send messages. Use it for immediate actions; use schedules_manage for future or…\",\"DO_NOT_USE_WHEN\":\"A read or preview operation can satisfy the request without changing state.\",\"PREFER_OVER\":null,\"RELATED_READ_OPERATION\":\"get\",\"VERIFICATION_OPERATION\":\"get\"}}}"

Changed11 schema fields changedSep 18, 2026

changedInput schema / $defs / input_1 / additionalProperties
```
Previous value: -trueNew value: +false
```
changedInput schema / $defs / input_2 / additionalProperties
```
Previous value: -trueNew value: +false
```
changedInput schema / $defs / input_3 / additionalProperties
```
Previous value: -trueNew value: +false
```
changedInput schema / $defs / input_4 / additionalProperties
```
Previous value: -trueNew value: +false
```
changedInput schema / $defs / input_5 / additionalProperties
```
Previous value: -trueNew value: +false
```
changedInput schema / $defs / input_6 / additionalProperties
```
Previous value: -trueNew value: +false
```
changedInput schema / $defs / input_7 / additionalProperties
```
Previous value: -trueNew value: +false
```

addedInput schema / $defs / input_7 / properties / messageId

Added value: +{
+  "description": "Identifier of the message being replied to.",
+  "maxLength": 256,
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / $defs / input_7 / properties / quotedMessageId

Added value: +{
+  "description": "Backward-compatible alias for messageId.",
+  "maxLength": 256,
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / $defs / input_7 / properties / replyTo

Added value: +{
+  "description": "Backward-compatible alias for messageId.",
+  "maxLength": 256,
+  "minLength": 1,
+  "type": "string"
+}

changedInput schema / $defs / input_8 / additionalProperties
```
Previous value: -trueNew value: +false
```

Changed25 schema fields changedSep 18, 2026

addedInput schema / $defs / input_2 / examples

Added value: +[
+  {
+    "groupJids": [
+      "120363000000000000@g.us"
+    ],
+    "message": "Aviso de exemplo"
+  }
+]

addedInput schema / $defs / input_3 / examples

Added value: +[
+  {
+    "groupJid": "120363000000000000@g.us",
+    "message": "Mensagem de exemplo",
+    "question": "example",
+    "text": "Mensagem de exemplo"
+  }
+]

changedInput schema / $defs / input_3 / properties / buttons / items / additionalProperties
```
Previous value: -trueNew value: +false
```

addedInput schema / $defs / input_3 / properties / buttons / items / description

Added value: +"WhatsApp quick-reply button. The controller accepts at most three buttons and ignores entries without id or text."

addedInput schema / $defs / input_3 / properties / buttons / items / properties

Added value: +{
+  "id": {
+    "description": "Stable value returned when the user selects the button.",
+    "maxLength": 256,
+    "minLength": 1,
+    "type": "string"
+  },
+  "text": {
+    "description": "User-visible button label.",
+    "maxLength": 80,
+    "minLength": 1,
+    "type": "string"
+  }
+}

addedInput schema / $defs / input_3 / properties / buttons / items / required
```
Added value: +[
+  "id",
+  "text"
+]
```

changedInput schema / $defs / input_3 / properties / scheduledTime / description

Previous value: -"Opcional. Data/hora futura para agendar em vez de enviar imediatamente. Tambem aceita sendAt, runAt, when, datetime ou dateTime."New value: +"Value for scheduled time. Follow the type, format, enumeration, and bounds declared in this schema."

addedInput schema / $defs / input_4 / examples

Added value: +[
+  {
+    "buttons": [
+      {
+        "id": "confirm",
+        "text": "Confirmar"
+      }
+    ],
+    "groupJid": "120363000000000000@g.us",
+    "message": "Escolha uma opção"
+  }
+]

changedInput schema / $defs / input_4 / properties / buttons / items / additionalProperties
```
Previous value: -trueNew value: +false
```

addedInput schema / $defs / input_4 / properties / buttons / items / description

Added value: +"WhatsApp quick-reply button. The controller accepts at most three buttons and ignores entries without id or text."

addedInput schema / $defs / input_4 / properties / buttons / items / properties

Added value: +{
+  "id": {
+    "description": "Stable value returned when the user selects the button.",
+    "maxLength": 256,
+    "minLength": 1,
+    "type": "string"
+  },
+  "text": {
+    "description": "User-visible button label.",
+    "maxLength": 80,
+    "minLength": 1,
+    "type": "string"
+  }
+}

addedInput schema / $defs / input_4 / properties / buttons / items / required
```
Added value: +[
+  "id",
+  "text"
+]
```
addedInput schema / $defs / input_4 / properties / confirmation_id
```
Added value: +{
+  "type": "string"
+}
```

addedInput schema / $defs / input_4 / properties / mode

Added value: +{
+  "enum": [
+    "preview"
+  ],
+  "type": "string"
+}

addedInput schema / $defs / input_4 / properties / preview
```
Added value: +{
+  "type": "boolean"
+}
```

changedInput schema / $defs / input_4 / properties / scheduledTime / description

Previous value: -"Opcional. Data/hora futura para agendar em vez de enviar imediatamente. Tambem aceita sendAt, runAt, when, datetime ou dateTime."New value: +"Value for scheduled time. Follow the type, format, enumeration, and bounds declared in this schema."

addedInput schema / $defs / input_5

Added value: +{
+  "additionalProperties": true,
+  "properties": {
+    "body": {
+      "type": "string"
+    },
+    "buttons": {
+      "items": {
+        "additionalProperties": false,
+        "description": "WhatsApp quick-reply button. The controller accepts at most three buttons and ignores entries without id or text.",
+        "properties": {
+          "id": {
+            "description": "Stable value returned when the user selects the button.",
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "text": {
+            "description": "User-visible button label.",
+            "maxLength": 80,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "text"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "groupJid": {
+      "type": "string"
+    },
+    "isRecurrent": {
+      "type": "boolean"
+    },
+    "message": {
+      "type": "string"
+    },
+    "note": {
+      "type": "string"
+    },
+    "options": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "question": {
+      "type": "string"
+    },
+    "recurrencePattern": {},
+    "runAt": {
+      "type": "string"
+    },
+    "scheduledTime": {
+      "description": "Value for scheduled time. Follow the type, format, enumeration, and bounds declared in this schema.",
+      "type": "string"
+    },
+    "sendAt": {
+      "type": "string"
+    },
+    "text": {
+      "type": "string"
+    },
+    "when": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "groupJid"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / input_6

Added value: +{
+  "additionalProperties": true,
+  "examples": [
+    {
+      "groupJid": "120363000000000000@g.us",
+      "options": [
+        "Opção 1",
+        "Opção 2"
+      ],
+      "question": "Qual opção?"
+    }
+  ],
+  "properties": {
+    "body": {
+      "type": "string"
+    },
+    "buttons": {
+      "items": {
+        "additionalProperties": false,
+        "description": "WhatsApp quick-reply button. The controller accepts at most three buttons and ignores entries without id or text.",
+        "properties": {
+          "id": {
+            "description": "Stable value returned when the user selects the button.",
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "text": {
+            "description": "User-visible button label.",
+            "maxLength": 80,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "text"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "confirmation_id": {
+      "type": "string"
+    },
+    "groupJid": {
+      "type": "string"
+    },
+    "isRecurrent": {
+      "type": "boolean"
+    },
+    "message": {
+      "type": "string"
+    },
+    "mode": {
+      "enum": [
+        "preview"
+      ],
+      "type": "string"
+    },
+    "note": {
+      "type": "string"
+    },
+    "options": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "preview": {
+      "type": "boolean"
+    },
+    "question": {
+      "type": "string"
+    },
+    "recurrencePattern": {},
+    "runAt": {
+      "type": "string"
+    },
+    "scheduledTime": {
+      "description": "Value for scheduled time. Follow the type, format, enumeration, and bounds declared in this schema.",
+      "type": "string"
+    },
+    "sendAt": {
+      "type": "string"
+    },
+    "text": {
+      "type": "string"
+    },
+    "when": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "groupJid"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / input_7

Added value: +{
+  "additionalProperties": true,
+  "examples": [
+    {
+      "groupJid": "120363000000000000@g.us",
+      "message": "Resposta de exemplo",
+      "messageId": "message-example"
+    }
+  ],
+  "properties": {
+    "body": {
+      "type": "string"
+    },
+    "buttons": {
+      "items": {
+        "additionalProperties": false,
+        "description": "WhatsApp quick-reply button. The controller accepts at most three buttons and ignores entries without id or text.",
+        "properties": {
+          "id": {
+            "description": "Stable value returned when the user selects the button.",
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "text": {
+            "description": "User-visible button label.",
+            "maxLength": 80,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "text"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "confirmation_id": {
+      "type": "string"
+    },
+    "groupJid": {
+      "type": "string"
+    },
+    "isRecurrent": {
+      "type": "boolean"
+    },
+    "message": {
+      "type": "string"
+    },
+    "mode": {
+      "enum": [
+        "preview"
+      ],
+      "type": "string"
+    },
+    "note": {
+      "type": "string"
+    },
+    "options": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "preview": {
+      "type": "boolean"
+    },
+    "question": {
+      "type": "string"
+    },
+    "recurrencePattern": {},
+    "runAt": {
+      "type": "string"
+    },
+    "scheduledTime": {
+      "description": "Value for scheduled time. Follow the type, format, enumeration, and bounds declared in this schema.",
+      "type": "string"
+    },
+    "sendAt": {
+      "type": "string"
+    },
+    "text": {
+      "type": "string"
+    },
+    "when": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "groupJid"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / input_8

Added value: +{
+  "additionalProperties": true,
+  "examples": [
+    {
+      "groupJid": "120363000000000000@g.us",
+      "message": "Mensagem de exemplo"
+    }
+  ],
+  "properties": {
+    "body": {
+      "type": "string"
+    },
+    "buttons": {
+      "items": {
+        "additionalProperties": false,
+        "description": "WhatsApp quick-reply button. The controller accepts at most three buttons and ignores entries without id or text.",
+        "properties": {
+          "id": {
+            "description": "Stable value returned when the user selects the button.",
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "text": {
+            "description": "User-visible button label.",
+            "maxLength": 80,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "text"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "confirmation_id": {
+      "type": "string"
+    },
+    "groupJid": {
+      "type": "string"
+    },
+    "isRecurrent": {
+      "type": "boolean"
+    },
+    "message": {
+      "type": "string"
+    },
+    "mode": {
+      "enum": [
+        "preview"
+      ],
+      "type": "string"
+    },
+    "note": {
+      "type": "string"
+    },
+    "options": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "preview": {
+      "type": "boolean"
+    },
+    "question": {
+      "type": "string"
+    },
+    "recurrencePattern": {},
+    "runAt": {
+      "type": "string"
+    },
+    "scheduledTime": {
+      "description": "Value for scheduled time. Follow the type, format, enumeration, and bounds declared in this schema.",
+      "type": "string"
+    },
+    "sendAt": {
+      "type": "string"
+    },
+    "text": {
+      "type": "string"
+    },
+    "when": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "groupJid"
+  ],
+  "type": "object"
+}

changedInput schema / allOf

Previous value: -[
-  {
-    "if": {
-      "properties": {
-        "operation": {
-          "const": "broadcast_preview"
-        }
-      },
-      "required": [
-        "operation"
-      ]
-    },
-    "then": {
-      "properties": {
-        "input": {
-          "$ref": "#/$defs/input_1"
-        }
-      }
-    }
-  },
-  {
-    "if": {
-      "properties": {
-        "operation": {
-          "const": "broadcast_send"
-        }
-      },
-      "required": [
-        "operation"
-      ]
-    },
-    "then": {
-      "properties": {
-        "input": {
-          "$ref": "#/$defs/input_2"
-        }
-      }
-    }
-  },
-  {
-    "if": {
-      "properties": {
-        "operation": {
-          "const": "admins_send"
-        }
-      },
-      "required": [
-        "operation"
-      ]
-    },
-    "then": {
-      "properties": {
-        "input": {
-          "$ref": "#/$defs/input_3"
-        }
-      },
-      "required": [
-        "input"
-      ]
-    }
-  },
-  {
-    "if": {
-      "properties": {
-        "operation": {
-          "const": "buttons_send"
-        }
-      },
-      "required": [
-        "operation"
-      ]
-    },
-    "then": {
-      "properties": {
-        "input": {
-          "$ref": "#/$defs/input_3"
-        }
-      },
-      "required": [
-        "input"
-      ]
-    }
-  },
-  {
-    "if": {
-      "properties": {
-        "operation": {
-          "const": "delete"
-        }
-      },
-      "required": [
-        "operation"
-      ]
-    },
-    "then": {
-      "properties": {
-        "input": {
-          "$ref": "#/$defs/input_3"
-        }
-      },
-      "required": [
-        "input"
-      ]
-    }
-  },
-  {
-    "if": {
-      "properties": {
-        "operation": {
-          "const": "get"
-        }
-      },
-      "required": [
-        "operation"
-      ]
-    },
-    "then": {
-      "properties": {
-        "input": {
-          "$ref": "#/$defs/input_4"
-        }
-      },
-      "required": [
-        "input"
-      ]
-    }
-  },
-  {
-    "if": {
-      "properties": {
-        "operation": {
-          "const": "list"
-        }
-      },
-      "required": [
-        "operation"
-      ]
-    },
-    "then": {
-      "properties": {
-        "input": {
-          "$ref": "#/$defs/input_4"
-        }
-      },
-      "required": [
-        "input"
-      ]
-    }
-  },
-  {
-    "if": {
-      "properties": {
-        "operation": {
-          "const": "poll_send"
-        }
-      },
-      "required": [
-        "operation"
-      ]
-    },
-    "then": {
-      "properties": {
-        "input": {
-          "$ref": "#/$defs/input_3"
-        }
-      },
-      "required": [
-        "input"
-      ]
-    }
-  },
-  {
-    "if": {
-      "properties": {
-        "operation": {
-          "const": "reply"
-        }
-      },
-      "required": [
-        "operation"
-      ]
-    },
-    "then": {
-      "properties": {
-        "input": {
-          "$ref": "#/$defs/input_3"
-        }
-      },
-      "required": [
-        "input"
-      ]
-    }
-  },
-  {
-    "if": {
-      "properties": {
-        "operation": {
-          "const": "send"
-        }
-      },
-      "required": [
-        "operation"
-      ]
-    },
-    "then": {
-      "properties": {
-        "input": {
-          "$ref": "#/$defs/input_3"
-        }
-      },
-      "required": [
-        "input"
-      ]
-    }
-  }
-]New value: +[
+  {
+    "if": {
+      "properties": {
+        "operation": {
+          "const": "broadcast_preview"
+        }
+      },
+      "required": [
+        "operation"
+      ]
+    },
+    "then": {
+      "properties": {
+        "input": {
+          "$ref": "#/$defs/input_1"
+        }
+      }
+    }
+  },
+  {
+    "if": {
+      "properties": {
+        "operation": {
+          "const": "broadcast_send"
+        }
+      },
+      "required": [
+        "operation"
+      ]
+    },
+    "then": {
+      "properties": {
+        "input": {
+          "$ref": "#/$defs/input_2"
+        }
+      }
+    }
+  },
+  {
+    "if": {
+      "properties": {
+        "operation": {
+          "const": "admins_send"
+        }
+      },
+      "required": [
+        "operation"
+      ]
+    },
+    "then": {
+      "properties": {
+        "input": {
+          "$ref": "#/$defs/input_3"
+        }
+      },
+      "required": [
+        "input"
+      ]
+    }
+  },
+  {
+    "if": {
+      "properties": {
+        "operation": {
+          "const": "buttons_send"
+        }
+      },
+      "required": [
+        "operation"
+      ]
+    },
+    "then": {
+      "properties": {
+        "input": {
+          "$ref": "#/$defs/input_4"
+        }
+      },
+      "required": [
+        "input"
+      ]
+    }
+  },
+  {
+    "if": {
+      "properties": {
+        "operation": {
+          "const": "delete"
+        }
+      },
+      "required": [
+        "operation"
+      ]
+    },
+    "then": {
+      "properties": {
+        "input": {
+          "$ref": "#/$defs/input_3"
+        }
+      },
+      "required": [
+        "input"
+      ]
+    }
+  },
+  {
+    "if": {
+      "properties": {
+        "operation": {
+          "const": "get"
+        }
+      },
+      "required": [
+        "operation"
+      ]
+    },
+    "then": {
+      "properties": {
+        "input": {
+          "$ref": "#/$defs/input_5"
+        }
+      },
+      "required": [
+        "input"
+      ]
+    }
+  },
+  {
+    "if": {
+      "properties": {
+        "operation": {
+          "const": "list"
+        }
+      },
+      "required": [
+        "operation"
+      ]
+    },
+    "then": {
+      "properties": {
+        "input": {
+          "$ref": "#/$defs/input_5"
+        }
+      },
+      "required": [
+        "input"
+      ]
+    }
+  },
+  {
+    "if": {
+      "properties": {
+        "operation": {
+          "const": "poll_send"
+        }
+      },
+      "required": [
+        "operation"
+      ]
+    },
+    "then": {
+      "properties": {
+        "input": {
+          "$ref": "#/$defs/input_6"
+        }
+      },
+      "required": [
+        "input"
+      ]
+    }
+  },
+  {
+    "if": {
+      "properties": {
+        "operation": {
+          "const": "reply"
+        }
+      },
+      "required": [
+        "operation"
+      ]
+    },
+    "then": {
+      "properties": {
+        "input": {
+          "$ref": "#/$defs/input_7"
+        }
+      },
+      "required": [
+        "input"
+      ]
+    }
+  },
+  {
+    "if": {
+      "properties": {
+        "operation": {
+          "const": "send"
+        }
+      },
+      "required": [
+        "operation"
+      ]
+    },
+    "then": {
+      "properties": {
+        "input": {
+          "$ref": "#/$defs/input_8"
+        }
+      },
+      "required": [
+        "input"
+      ]
+    }
+  }
+]

changedInput schema / properties / input / description

Previous value: -"Parâmetros da operação escolhida, conforme as condições abaixo. Use os identificadores retornados pelas consultas e envie somente os campos solicitados. Omita ou use {} quando a operação não exigir parâmetros."New value: +"Parameters for the selected operation. Reuse identifiers returned by read operations and submit only documented fields. Omit input or use an empty object when the operation has no parameters."

changedInput schema / properties / operation / description

Previous value: -"Escolha uma operação da lista deste domínio. Nomes compostos identificam recurso e ação; list pesquisa registros e get lê um registro identificado. Os parâmetros exigidos aparecem em input conforme a opção."New value: +"Select one operation in this family. Compound names identify a resource and action; list searches records and get reads one identified record. The conditional input schema below defines the required parameters."

addedOutput schema / properties / presentation / properties / items / items / properties / participantCount
```
Added value: +{
+  "minimum": 0,
+  "type": [
+    "integer",
+    "null"
+  ]
+}
```
addedOutput schema / properties / presentation / properties / items / items / properties / reference
```
Added value: +{
+  "type": "string"
+}
```

AddedSep 9, 2026

TDQS

A4.9/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations (destructiveHint=true, idempotentHint=false), the description adds important operational caveats: external sends are not idempotent, an accepted provider request does not prove recipient-device delivery, retrying may duplicate content, delete depends on bot permissions, and preview never applies the mutation. It also explains the confirmation_id mechanism. This is substantial behavioral disclosure that helps the agent anticipate consequences.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four sentences deliver core purpose, sibling differentiation, idempotency caveats, destructive-permission warning, preview semantics, and confirmation flow. Every sentence earns its place, and the most decision-critical information is front-loaded. The length is appropriate for a tool with this many operations.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (10 operations, conditional schemas, nested objects), the description covers all necessary categories: what it does, when to use it versus siblings, safety/idempotency caveats, preview behavior, and confirmation handling. The output schema and rich operation-level guidance already exist, so the description does not need to enumerate every return field or operation-specific parameter.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With schema description coverage at 100%, the baseline is 3. The description adds meaning beyond the schema for two key parameters: input.preview ('preview never applies the mutation') and input.confirmation_id ('repeat the same operation and parameters'). It does not describe individual message content parameters, but those are already documented in the schema and nested object definitions, so this added guidance is meaningful rather than redundant.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific scope: 'Searches accessible message history and performs immediate sends, replies, polls, interactive messages, broadcasts, or revocation requests.' The verb 'searches' and 'performs' plus the enumerated message types make the tool's purpose concrete, and the title 'Read, send, and delete messages now' reinforces it. It also distinguishes itself from siblings by explicitly contrasting immediate actions with schedules_manage and workflows_design.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives explicit routing guidance: 'Use schedules_manage for future delivery and workflows_design for multi-step processes.' It also clarifies when preview is appropriate ('preview never applies the mutation') and how to complete a confirmation flow. This gives an agent clear decision rules for choosing this tool over alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All 9bot tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?