Skip to main content
Glama

Cherami

by to.cherami
OverviewDiscussionsAdmin

Find received emails

list_messages
Read-onlyIdempotent

Search or list an inbox's received mail; all supplied filters must match. Use get_message to read one message.

Input Schema

NameRequiredDescriptionDefault
fromNoExact From address, case-insensitive.
afterNoReceived or sent at or after this time: YYYY-MM-DDTHH:mm:ss, optional 1–3 fractional digits, then Z or ±HH:mm.
limitNo
orderNoDefaults to newest. relevance requires query.
queryNoWords or quoted phrases that must all appear in the subject or body. Case-insensitive keyword match, not semantic search; up to 16 terms or phrases.
beforeNoReceived or sent before this time: YYYY-MM-DDTHH:mm:ss, optional 1–3 fractional digits, then Z or ±HH:mm.
cursorNoContinue with next_cursor from the previous result, keeping the same filters. Stop when next_cursor is null.
subjectNoLiteral, case-insensitive substring of the subject.
inbox_idYes
recipientNoExact To, Cc or Bcc address, case-insensitive.
labels_allNoRequire every listed label. An empty array in any label filter adds no condition.
labels_anyNoRequire at least one listed label.
labels_noneNoExclude messages with any listed label.
include_contentNoAlso return each body (up to 2,000 characters), attachment metadata and reply suggestion. Defaults to false.

Output Schema

NameRequiredDescriptionDefault
messagesYes
next_cursorYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed10 schema fields changed
    • changedInput schema / properties / after / description
      Previous value: -"Inclusive receipt/submission time: YYYY-MM-DDTHH:mm:ss, optional 1–3 fractional digits, then Z or ±HH:mm."New value: +"Received or sent at or after this time: YYYY-MM-DDTHH:mm:ss, optional 1–3 fractional digits, then Z or ±HH:mm."
    • changedInput schema / properties / before / description
      Previous value: -"Exclusive receipt/submission time: YYYY-MM-DDTHH:mm:ss, optional 1–3 fractional digits, then Z or ±HH:mm."New value: +"Received or sent before this time: YYYY-MM-DDTHH:mm:ss, optional 1–3 fractional digits, then Z or ±HH:mm."
    • changedInput schema / properties / from / description
      Previous value: -"Exact email address in From, case-insensitive; not the SMTP envelope sender."New value: +"Exact From address, case-insensitive."
    • changedInput schema / properties / include_content / description
      Previous value: -"Include bodies up to 2,000 characters each, attachment metadata and reply suggestions. Check body_status before treating a body as complete. Defaults to false."New value: +"Also return each body (up to 2,000 characters), attachment metadata and reply suggestion. Defaults to false."
    • changedInput schema / properties / labels_all / description
      Previous value: -"Require every listed label. Filter groups combine with AND; empty arrays impose no condition."New value: +"Require every listed label. An empty array in any label filter adds no condition."
    • changedInput schema / properties / order / description
      Previous value: -"Defaults to newest. Relevance requires query; ties use newest first. Threads order by their latest activity."New value: +"Defaults to newest. relevance requires query."
    • changedInput schema / properties / query / description
      Previous value: -"Match all words or quoted phrases in subject/body. Case-insensitive keyword search, not semantic similarity; up to 16 terms/phrases."New value: +"Words or quoted phrases that must all appear in the subject or body. Case-insensitive keyword match, not semantic search; up to 16 terms or phrases."
    • changedInput schema / properties / recipient / description
      Previous value: -"Exact email address in To/Cc/Bcc where available, case-insensitive."New value: +"Exact To, Cc or Bcc address, case-insensitive."
    • changedInput schema / properties / subject / description
      Previous value: -"Literal case-insensitive substring of the subject."New value: +"Literal, case-insensitive substring of the subject."
    • changedOutput schema / properties / messages / items / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from": {
-        "anyOf": [
-          {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "address": {
-                    "type": "string"
-                  },
-                  "name": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "name",
-                  "address"
-                ],
-                "type": "object"
-              },
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "group": {
-                    "items": {
-                      "additionalProperties": false,
-                      "properties": {
-                        "address": {
-                          "type": "string"
-                        },
-                        "name": {
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "name",
-                        "address"
-                      ],
-                      "type": "object"
-                    },
-                    "type": "array"
-                  },
-                  "name": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "name",
-                  "group"
-                ],
-                "type": "object"
-              }
-            ]
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "id": {
-        "type": "string"
-      },
-      "inbox_id": {
-        "type": "string"
-      },
-      "labels": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "processing_status": {
-        "enum": [
-          "pending",
-          "processing",
-          "ready",
-          "failed"
-        ],
-        "type": "string"
-      },
-      "received_at": {
-        "description": "Absolute ISO 8601 service timestamp in UTC (Z), with millisecond precision.",
-        "type": "string"
-      },
-      "subject": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "thread_id": {
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "id",
-      "inbox_id",
-      "thread_id",
-      "received_at",
-      "processing_status",
-      "labels",
-      "from",
-      "subject"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "attachments": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "content_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "disposition": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "filename": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "id": {
-              "type": "string"
-            },
-            "mime_type": {
-              "type": "string"
-            },
-            "related": {
-              "type": "boolean"
-            },
-            "size": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            }
-          },
-          "required": [
-            "id",
-            "filename",
-            "size",
-            "mime_type",
-            "disposition",
-            "content_id",
-            "related"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "body": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "body_source": {
-        "anyOf": [
-          {
-            "enum": [
-              "reply_text",
-              "text",
-              "html"
-            ],
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "reply_text is heuristic extraction, not the original body. Use full format for quoted history, forwards or ambiguous inline answers; complete means untruncated, not original."
-      },
-      "body_status": {
-        "description": "For truncated bodies, use get_message. For not_ready, check again later. For plain_text_unavailable, use full format if html_available.",
-        "enum": [
-          "not_ready",
-          "plain_text_unavailable",
-          "truncated",
-          "complete"
-        ],
-        "type": "string"
-      },
-      "cc": {
-        "items": {
-          "anyOf": [
-            {
-              "additionalProperties": false,
-              "properties": {
-                "address": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "name",
-                "address"
-              ],
-              "type": "object"
-            },
-            {
-              "additionalProperties": false,
-              "properties": {
-                "group": {
-                  "items": {
-                    "additionalProperties": false,
-                    "properties": {
-                      "address": {
-                        "type": "string"
-                      },
-                      "name": {
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "name",
-                      "address"
-                    ],
-                    "type": "object"
-                  },
-                  "type": "array"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "name",
-                "group"
-              ],
-              "type": "object"
-            }
-          ]
-        },
-        "type": "array"
-      },
-      "from": {
-        "anyOf": [
-          {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "address": {
-                    "type": "string"
-                  },
-                  "name": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "name",
-                  "address"
-                ],
-                "type": "object"
-              },
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "group": {
-                    "items": {
-                      "additionalProperties": false,
-                      "properties": {
-                        "address": {
-                          "type": "string"
-                        },
-                        "name": {
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "name",
-                        "address"
-                      ],
-                      "type": "object"
-                    },
-                    "type": "array"
-                  },
-                  "name": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "name",
-                  "group"
-                ],
-                "type": "object"
-              }
-            ]
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "html_available": {
-        "type": "boolean"
-      },
-      "id": {
-        "type": "string"
-      },
-      "inbox_id": {
-        "type": "string"
-      },
-      "labels": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "processing_status": {
-        "enum": [
-          "pending",
-          "processing",
-          "ready",
-          "failed"
-        ],
-        "type": "string"
-      },
-      "received_at": {
-        "description": "Absolute ISO 8601 service timestamp in UTC (Z), with millisecond precision.",
-        "type": "string"
-      },
-      "reply": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "in_reply_to": {
-                "type": "string"
-              },
-              "subject": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "to": {
-                "items": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "address": {
-                      "type": "string"
-                    },
-                    "name": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "address"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              }
-            },
-            "required": [
-              "in_reply_to",
-              "to",
-              "subject"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "reply_to": {
-        "items": {
-          "anyOf": [
-            {
-              "additionalProperties": false,
-              "properties": {
-                "address": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "name",
-                "address"
-              ],
-              "type": "object"
-            },
-            {
-              "additionalProperties": false,
-              "properties": {
-                "group": {
-                  "items": {
-                    "additionalProperties": false,
-                    "properties": {
-                      "address": {
-                        "type": "string"
-                      },
-                      "name": {
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "name",
-                      "address"
-                    ],
-                    "type": "object"
-                  },
-                  "type": "array"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "name",
-                "group"
-              ],
-              "type": "object"
-            }
-          ]
-        },
-        "type": "array"
-      },
-      "subject": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "thread_id": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "to": {
-        "items": {
-          "anyOf": [
-            {
-              "additionalProperties": false,
-              "properties": {
-                "address": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "name",
-                "address"
-              ],
-              "type": "object"
-            },
-            {
-              "additionalProperties": false,
-              "properties": {
-                "group": {
-                  "items": {
-                    "additionalProperties": false,
-                    "properties": {
-                      "address": {
-                        "type": "string"
-                      },
-                      "name": {
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "name",
-                      "address"
-                    ],
-                    "type": "object"
-                  },
-                  "type": "array"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "name",
-                "group"
-              ],
-              "type": "object"
-            }
-          ]
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "id",
-      "inbox_id",
-      "thread_id",
-      "received_at",
-      "processing_status",
-      "labels",
-      "from",
-      "reply_to",
-      "to",
-      "cc",
-      "subject",
-      "body",
-      "body_source",
-      "body_status",
-      "html_available",
-      "attachments",
-      "reply"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from": {
+        "anyOf": [
+          {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "address": {
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "name",
+                  "address"
+                ],
+                "type": "object"
+              },
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "group": {
+                    "items": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "address": {
+                          "type": "string"
+                        },
+                        "name": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "name",
+                        "address"
+                      ],
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "name": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "name",
+                  "group"
+                ],
+                "type": "object"
+              }
+            ]
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "id": {
+        "type": "string"
+      },
+      "inbox_id": {
+        "type": "string"
+      },
+      "labels": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "processing_status": {
+        "enum": [
+          "pending",
+          "processing",
+          "ready",
+          "failed"
+        ],
+        "type": "string"
+      },
+      "received_at": {
+        "description": "Absolute ISO 8601 service timestamp in UTC (Z), with millisecond precision.",
+        "type": "string"
+      },
+      "subject": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "thread_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "id",
+      "inbox_id",
+      "thread_id",
+      "received_at",
+      "processing_status",
+      "labels",
+      "from",
+      "subject"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "attachments": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "content_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "disposition": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "filename": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "id": {
+              "type": "string"
+            },
+            "mime_type": {
+              "type": "string"
+            },
+            "related": {
+              "type": "boolean"
+            },
+            "size": {
+              "maximum": 9007199254740991,
+              "minimum": 0,
+              "type": "integer"
+            }
+          },
+          "required": [
+            "id",
+            "filename",
+            "size",
+            "mime_type",
+            "disposition",
+            "content_id",
+            "related"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "body": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "body_source": {
+        "anyOf": [
+          {
+            "enum": [
+              "reply_text",
+              "text",
+              "html"
+            ],
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "reply_text: only the newly written text, extracted without quoted history; empty when none was found. For forwards, quoted history or answers written inline, read format full. text: the plain-text body. html: text taken from the HTML body."
+      },
+      "body_status": {
+        "description": "complete: body is not truncated. truncated: get_message returns the whole body. not_ready: no parsed content yet; while processing_status is pending or processing, read again shortly; when it is failed, read the original with read_raw_message. plain_text_unavailable: read format full if html_available.",
+        "enum": [
+          "not_ready",
+          "plain_text_unavailable",
+          "truncated",
+          "complete"
+        ],
+        "type": "string"
+      },
+      "cc": {
+        "items": {
+          "anyOf": [
+            {
+              "additionalProperties": false,
+              "properties": {
+                "address": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "name",
+                "address"
+              ],
+              "type": "object"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "group": {
+                  "items": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "address": {
+                        "type": "string"
+                      },
+                      "name": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "name",
+                      "address"
+                    ],
+                    "type": "object"
+                  },
+                  "type": "array"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "name",
+                "group"
+              ],
+              "type": "object"
+            }
+          ]
+        },
+        "type": "array"
+      },
+      "from": {
+        "anyOf": [
+          {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "address": {
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "name",
+                  "address"
+                ],
+                "type": "object"
+              },
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "group": {
+                    "items": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "address": {
+                          "type": "string"
+                        },
+                        "name": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "name",
+                        "address"
+                      ],
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "name": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "name",
+                  "group"
+                ],
+                "type": "object"
+              }
+            ]
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "html_available": {
+        "type": "boolean"
+      },
+      "id": {
+        "type": "string"
+      },
+      "inbox_id": {
+        "type": "string"
+      },
+      "labels": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "processing_status": {
+        "enum": [
+          "pending",
+          "processing",
+          "ready",
+          "failed"
+        ],
+        "type": "string"
+      },
+      "received_at": {
+        "description": "Absolute ISO 8601 service timestamp in UTC (Z), with millisecond precision.",
+        "type": "string"
+      },
+      "reply": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "in_reply_to": {
+                "type": "string"
+              },
+              "subject": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "to": {
+                "items": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "address": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "address"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "required": [
+              "in_reply_to",
+              "to",
+              "subject"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Suggested in_reply_to, recipients and subject for send_message. to comes from sender-written headers: check it against the assignment."
+      },
+      "reply_to": {
+        "items": {
+          "anyOf": [
+            {
+              "additionalProperties": false,
+              "properties": {
+                "address": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "name",
+                "address"
+              ],
+              "type": "object"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "group": {
+                  "items": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "address": {
+                        "type": "string"
+                      },
+                      "name": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "name",
+                      "address"
+                    ],
+                    "type": "object"
+                  },
+                  "type": "array"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "name",
+                "group"
+              ],
+              "type": "object"
+            }
+          ]
+        },
+        "type": "array"
+      },
+      "subject": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "thread_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "to": {
+        "items": {
+          "anyOf": [
+            {
+              "additionalProperties": false,
+              "properties": {
+                "address": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "name",
+                "address"
+              ],
+              "type": "object"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "group": {
+                  "items": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "address": {
+                        "type": "string"
+                      },
+                      "name": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "name",
+                      "address"
+                    ],
+                    "type": "object"
+                  },
+                  "type": "array"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "name",
+                "group"
+              ],
+              "type": "object"
+            }
+          ]
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "id",
+      "inbox_id",
+      "thread_id",
+      "received_at",
+      "processing_status",
+      "labels",
+      "from",
+      "reply_to",
+      "to",
+      "cc",
+      "subject",
+      "body",
+      "body_source",
+      "body_status",
+      "html_available",
+      "attachments",
+      "reply"
+    ],
+    "type": "object"
+  }
+]
  2. First observed

TDQS

A4.2/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, non-destructive, closed-world behavior. The description adds the meaningful semantic that 'all supplied filters must match' (conjunctive filtering), which is behavior the annotations do not express.

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?

Two short clauses, no filler, with the core purpose and the conjunctive-filter rule front-loaded before the pointer to the sibling tool.

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

Completeness4/5

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

An output schema exists, so return-value narration is unnecessary, and the 14 parameters are 86% documented in-schema. The description is adequate but adds little for a tool this richly parameterized; a note on pagination/defaults is left entirely to the schema.

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

Parameters3/5

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

Schema description coverage is 86%, so the schema already documents filter formats, limits, ordering defaults, and cursor usage. The description adds no parameter-level detail beyond what the structured fields provide; baseline 3 applies.

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?

States a specific verb (search/list) and resource (inbox's received mail), and the scope constraint 'received' immediately separates it from list_sent, list_drafts, and list_trash. An agent can pick this over siblings without opening a schema.

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

Usage Guidelines4/5

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

'Use get_message to read one message' explicitly routes the agent to the alternative for a single-message read. It stops short of saying when list_messages beats count_messages or list_threads, so it is clear but not exhaustive.

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

All Cherami toolsInspect
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