Skip to main content
Glama
wazap-mcp

wazap-mcp

by razvangirgiz

Catch up on what the user missed

catch_up
Read-only

Retrieve what you missed across WhatsApp accounts—waiting asks, mentions, calls, people, groups, and stories—within a token budget, with account filters and cursors to narrow or continue.

Instructions

What the user missed, all accounts, within budget_tokens: waiting (every open ask of 14 days, whatever the window), mentions, calls, people, groups, stories. account_id narrows it to one account; get_status names them. The mark moves first; a lost answer is since: "previous". more.cursor: the rest.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "catch_up"
  }
}

Input Schema

NameRequiredDescriptionDefault
idsNoMessage ids, to act on entries
hoursNoThe last N hours instead; never moves the mark
sinceNo"last" (default); "previous" repeats that catch-up; or an ISO date or time from the last 14 days
cursorNomore.cursor
includeNoOnly these sections; the mark then stays
account_idNo
budget_tokensNoAnswer length in tokens

Output Schema

NameRequiredDescriptionDefault
moreYesSet when entries are left: call catch_up again with more.cursor
notesNoCaveats to act on or tell the user
directYes
footerYesOn the last page: what the entries leave out
groupsYes
windowYes
storiesYes
waitingYes
accountsYes
addressedYes
account_idYes
missed_callsYes
approx_tokensYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed55 schema fields changedv1.7.4
    • removedInput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
    • addedInput schema / properties / ids
      Added value: +{
      +  "description": "Message ids, to act on entries",
      +  "type": "boolean"
      +}
    • removedOutput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
    • removedOutput schema / properties / accounts / items / properties / window / $ref
      Removed value: -"#/properties/window"
    • addedOutput schema / properties / accounts / items / properties / window / additionalProperties
      Added value: +false
    • addedOutput schema / properties / accounts / items / properties / window / properties
      Added value: +{
      +  "basis": {
      +    "type": "string"
      +  },
      +  "hours": {
      +    "type": "number"
      +  },
      +  "since": {
      +    "type": "string"
      +  },
      +  "until": {
      +    "type": "string"
      +  }
      +}
    • addedOutput schema / properties / accounts / items / properties / window / required
      Added value: +[
      +  "since",
      +  "until",
      +  "hours",
      +  "basis"
      +]
    • addedOutput schema / properties / accounts / items / properties / window / type
      Added value: +"object"
    • removedOutput schema / properties / addressed / items / properties / acct / $ref
      Removed value: -"#/properties/waiting/items/properties/acct"
    • addedOutput schema / properties / addressed / items / properties / acct / description
      Added value: +"The account the entry is from, when the catch-up covers several"
    • addedOutput schema / properties / addressed / items / properties / acct / type
      Added value: +"string"
    • removedOutput schema / properties / addressed / items / properties / at / $ref
      Removed value: -"#/properties/waiting/items/properties/at"
    • addedOutput schema / properties / addressed / items / properties / at / description
      Added value: +"When, as a clock time (with the day when not today)"
    • addedOutput schema / properties / addressed / items / properties / at / type
      Added value: +"string"
    • addedOutput schema / properties / addressed / items / properties / id
      Added value: +{
      +  "description": "ids: the message_id of what the entry quotes or names",
      +  "type": "string"
      +}
    • removedOutput schema / properties / addressed / items / properties / private / $ref
      Removed value: -"#/properties/waiting/items/properties/private"
    • addedOutput schema / properties / addressed / items / properties / private / const
      Added value: +true
    • addedOutput schema / properties / addressed / items / properties / private / description
      Added value: +"Someone the user tagged #private: counted, never quoted"
    • addedOutput schema / properties / addressed / items / properties / private / type
      Added value: +"boolean"
    • removedOutput schema / properties / addressed / items / properties / q / $ref
      Removed value: -"#/properties/waiting/items/properties/q"
    • addedOutput schema / properties / addressed / items / properties / q / description
      Added value: +"Quote: the message's own words, cut to fit the budget"
    • addedOutput schema / properties / addressed / items / properties / q / type
      Added value: +"string"
    • removedOutput schema / properties / addressed / items / properties / sig / $ref
      Removed value: -"#/properties/waiting/items/properties/sig"
    • addedOutput schema / properties / addressed / items / properties / sig / description
      Added value: +"Signals in the quote, comma-separated: amount, date, time, address, link, question"
    • addedOutput schema / properties / addressed / items / properties / sig / type
      Added value: +"string"
    • removedOutput schema / properties / direct / items / properties / acct / $ref
      Removed value: -"#/properties/waiting/items/properties/acct"
    • addedOutput schema / properties / direct / items / properties / acct / description
      Added value: +"The account the entry is from, when the catch-up covers several"
    • addedOutput schema / properties / direct / items / properties / acct / type
      Added value: +"string"
    • removedOutput schema / properties / direct / items / properties / at / $ref
      Removed value: -"#/properties/waiting/items/properties/at"
    • addedOutput schema / properties / direct / items / properties / at / description
      Added value: +"When, as a clock time (with the day when not today)"
    • addedOutput schema / properties / direct / items / properties / at / type
      Added value: +"string"
    • addedOutput schema / properties / direct / items / properties / id
      Added value: +{
      +  "description": "ids: the message_id of what the entry quotes or names",
      +  "type": "string"
      +}
    • addedOutput schema / properties / direct / items / properties / media / propertyNames
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / direct / items / properties / media_ids
      Added value: +{
      +  "description": "ids: the newest photos, videos, documents, stickers and audio, by message_id, for get_media",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • removedOutput schema / properties / direct / items / properties / private / $ref
      Removed value: -"#/properties/waiting/items/properties/private"
    • addedOutput schema / properties / direct / items / properties / private / const
      Added value: +true
    • addedOutput schema / properties / direct / items / properties / private / description
      Added value: +"Someone the user tagged #private: counted, never quoted"
    • addedOutput schema / properties / direct / items / properties / private / type
      Added value: +"boolean"
    • removedOutput schema / properties / direct / items / properties / q / $ref
      Removed value: -"#/properties/waiting/items/properties/q"
    • addedOutput schema / properties / direct / items / properties / q / description
      Added value: +"Quote: the message's own words, cut to fit the budget"
    • addedOutput schema / properties / direct / items / properties / q / type
      Added value: +"string"
    • removedOutput schema / properties / direct / items / properties / sig / $ref
      Removed value: -"#/properties/waiting/items/properties/sig"
    • addedOutput schema / properties / direct / items / properties / sig / description
      Added value: +"Signals in the quote, comma-separated: amount, date, time, address, link, question"
    • addedOutput schema / properties / direct / items / properties / sig / type
      Added value: +"string"
    • changedOutput schema / properties / footer / anyOf
      Previous value: -[
      -  {
      -    "anyOf": [
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "history_sync": {
      -            "type": "string"
      -          },
      -          "mentions_indexing": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "skipped": {
      -            "additionalProperties": false,
      -            "description": "What was left out, counted",
      -            "properties": {
      -              "broadcasts": {
      -                "$ref": "#/properties/footer/anyOf/0/anyOf/0/properties/skipped/properties/no_catchup"
      -              },
      -              "left_groups": {
      -                "$ref": "#/properties/footer/anyOf/0/anyOf/0/properties/skipped/properties/no_catchup"
      -              },
      -              "newsletters": {
      -                "$ref": "#/properties/footer/anyOf/0/anyOf/0/properties/skipped/properties/no_catchup"
      -              },
      -              "no_catchup": {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "chats": {
      -                    "type": "number"
      -                  },
      -                  "messages": {
      -                    "type": "number"
      -                  }
      -                },
      -                "required": [
      -                  "chats",
      -                  "messages"
      -                ],
      -                "type": "object"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "voice_untranscribed": {
      -            "description": "Voice notes nobody transcribed, by message id, for get_media",
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          "voice_untranscribed_more": {
      -            "description": "Voice notes nobody transcribed that are not named",
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "accounts": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "acct": {
      -                  "type": "string"
      -                },
      -                "history_sync": {
      -                  "$ref": "#/properties/footer/anyOf/0/anyOf/0/properties/history_sync"
      -                },
      -                "mentions_indexing": {
      -                  "$ref": "#/properties/footer/anyOf/0/anyOf/0/properties/mentions_indexing"
      -                },
      -                "skipped": {
      -                  "$ref": "#/properties/footer/anyOf/0/anyOf/0/properties/skipped"
      -                },
      -                "voice_untranscribed": {
      -                  "$ref": "#/properties/footer/anyOf/0/anyOf/0/properties/voice_untranscribed"
      -                },
      -                "voice_untranscribed_more": {
      -                  "$ref": "#/properties/footer/anyOf/0/anyOf/0/properties/voice_untranscribed_more"
      -                }
      -              },
      -              "required": [
      -                "acct"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          }
      -        },
      -        "required": [
      -          "accounts"
      -        ],
      -        "type": "object"
      -      }
      -    ]
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "anyOf": [
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "history_sync": {
      +            "type": "string"
      +          },
      +          "mentions_indexing": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "skipped": {
      +            "additionalProperties": false,
      +            "description": "What was left out, counted",
      +            "properties": {
      +              "broadcasts": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "chats": {
      +                    "type": "number"
      +                  },
      +                  "messages": {
      +                    "type": "number"
      +                  }
      +                },
      +                "required": [
      +                  "chats",
      +                  "messages"
      +                ],
      +                "type": "object"
      +              },
      +              "left_groups": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "chats": {
      +                    "type": "number"
      +                  },
      +                  "messages": {
      +                    "type": "number"
      +                  }
      +                },
      +                "required": [
      +                  "chats",
      +                  "messages"
      +                ],
      +                "type": "object"
      +              },
      +              "newsletters": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "chats": {
      +                    "type": "number"
      +                  },
      +                  "messages": {
      +                    "type": "number"
      +                  }
      +                },
      +                "required": [
      +                  "chats",
      +                  "messages"
      +                ],
      +                "type": "object"
      +              },
      +              "no_catchup": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "chats": {
      +                    "type": "number"
      +                  },
      +                  "messages": {
      +                    "type": "number"
      +                  }
      +                },
      +                "required": [
      +                  "chats",
      +                  "messages"
      +                ],
      +                "type": "object"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "voice_untranscribed": {
      +            "description": "Voice notes nobody transcribed, by message id, for get_media",
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "voice_untranscribed_more": {
      +            "description": "Voice notes nobody transcribed that are not named",
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "accounts": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "acct": {
      +                  "type": "string"
      +                },
      +                "history_sync": {
      +                  "type": "string"
      +                },
      +                "mentions_indexing": {
      +                  "const": true,
      +                  "type": "boolean"
      +                },
      +                "skipped": {
      +                  "additionalProperties": false,
      +                  "description": "What was left out, counted",
      +                  "properties": {
      +                    "broadcasts": {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "chats": {
      +                          "type": "number"
      +                        },
      +                        "messages": {
      +                          "type": "number"
      +                        }
      +                      },
      +                      "required": [
      +                        "chats",
      +                        "messages"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "left_groups": {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "chats": {
      +                          "type": "number"
      +                        },
      +                        "messages": {
      +                          "type": "number"
      +                        }
      +                      },
      +                      "required": [
      +                        "chats",
      +                        "messages"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "newsletters": {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "chats": {
      +                          "type": "number"
      +                        },
      +                        "messages": {
      +                          "type": "number"
      +                        }
      +                      },
      +                      "required": [
      +                        "chats",
      +                        "messages"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "no_catchup": {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "chats": {
      +                          "type": "number"
      +                        },
      +                        "messages": {
      +                          "type": "number"
      +                        }
      +                      },
      +                      "required": [
      +                        "chats",
      +                        "messages"
      +                      ],
      +                      "type": "object"
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                "voice_untranscribed": {
      +                  "description": "Voice notes nobody transcribed, by message id, for get_media",
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                "voice_untranscribed_more": {
      +                  "description": "Voice notes nobody transcribed that are not named",
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "acct"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "accounts"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / groups / items / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "acct": {
      -        "$ref": "#/properties/waiting/items/properties/acct"
      -      },
      -      "addressed": {
      -        "const": true,
      -        "description": "Someone mentioned, replied to or asked the user here",
      -        "type": "boolean"
      -      },
      -      "at": {
      -        "$ref": "#/properties/waiting/items/properties/at"
      -      },
      -      "chat": {
      -        "type": "string"
      -      },
      -      "hot": {
      -        "description": "Quote: the most reacted message, or the newest worth quoting",
      -        "type": "string"
      -      },
      -      "media": {
      -        "$ref": "#/properties/direct/items/properties/media"
      -      },
      -      "n": {
      -        "description": "New messages",
      -        "type": "number"
      -      },
      -      "name": {
      -        "type": "string"
      -      },
      -      "polls": {
      -        "type": "number"
      -      },
      -      "senders": {
      -        "type": "number"
      -      },
      -      "sig": {
      -        "$ref": "#/properties/waiting/items/properties/sig"
      -      },
      -      "top": {
      -        "description": "Who wrote most, at most three",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "chat",
      -      "name",
      -      "n",
      -      "senders",
      -      "top",
      -      "at"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "acct": {
      -        "$ref": "#/properties/waiting/items/properties/acct"
      -      },
      -      "groups": {
      -        "type": "number"
      -      },
      -      "muted_or_archived": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "n": {
      -        "description": "New messages across them",
      -        "type": "number"
      -      },
      -      "names": {
      -        "description": "The busiest, at most three",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "muted_or_archived",
      -      "groups",
      -      "n",
      -      "names"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "acct": {
      +        "description": "The account the entry is from, when the catch-up covers several",
      +        "type": "string"
      +      },
      +      "addressed": {
      +        "const": true,
      +        "description": "Someone mentioned, replied to or asked the user here",
      +        "type": "boolean"
      +      },
      +      "at": {
      +        "description": "When, as a clock time (with the day when not today)",
      +        "type": "string"
      +      },
      +      "chat": {
      +        "type": "string"
      +      },
      +      "hot": {
      +        "description": "Quote: the most reacted message, or the newest worth quoting",
      +        "type": "string"
      +      },
      +      "id": {
      +        "description": "ids: the message_id of what the entry quotes or names",
      +        "type": "string"
      +      },
      +      "media": {
      +        "additionalProperties": {
      +          "type": "number"
      +        },
      +        "description": "Media by kind: image, video, voice, audio, document, sticker, location, contact",
      +        "propertyNames": {
      +          "type": "string"
      +        },
      +        "type": "object"
      +      },
      +      "media_ids": {
      +        "description": "ids: the newest photos, videos, documents, stickers and audio, by message_id, for get_media",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "n": {
      +        "description": "New messages",
      +        "type": "number"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "polls": {
      +        "type": "number"
      +      },
      +      "senders": {
      +        "type": "number"
      +      },
      +      "sig": {
      +        "description": "Signals in the quote, comma-separated: amount, date, time, address, link, question",
      +        "type": "string"
      +      },
      +      "top": {
      +        "description": "Who wrote most, at most three",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "chat",
      +      "name",
      +      "n",
      +      "senders",
      +      "top",
      +      "at"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "acct": {
      +        "description": "The account the entry is from, when the catch-up covers several",
      +        "type": "string"
      +      },
      +      "groups": {
      +        "type": "number"
      +      },
      +      "muted_or_archived": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "n": {
      +        "description": "New messages across them",
      +        "type": "number"
      +      },
      +      "names": {
      +        "description": "The busiest, at most three",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "muted_or_archived",
      +      "groups",
      +      "n",
      +      "names"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedOutput schema / properties / missed_calls / items / properties / acct / $ref
      Removed value: -"#/properties/waiting/items/properties/acct"
    • addedOutput schema / properties / missed_calls / items / properties / acct / description
      Added value: +"The account the entry is from, when the catch-up covers several"
    • addedOutput schema / properties / missed_calls / items / properties / acct / type
      Added value: +"string"
    • changedOutput schema / properties / more / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "approx_tokens": {
      -        "type": "number"
      -      },
      -      "cursor": {
      -        "type": "string"
      -      },
      -      "remaining": {
      -        "additionalProperties": {
      -          "type": "number"
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "cursor",
      -      "remaining",
      -      "approx_tokens"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "approx_tokens": {
      +        "type": "number"
      +      },
      +      "cursor": {
      +        "type": "string"
      +      },
      +      "remaining": {
      +        "additionalProperties": {
      +          "type": "number"
      +        },
      +        "propertyNames": {
      +          "type": "string"
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "cursor",
      +      "remaining",
      +      "approx_tokens"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / stories / items / properties / acct / $ref
      Removed value: -"#/properties/waiting/items/properties/acct"
    • addedOutput schema / properties / stories / items / properties / acct / description
      Added value: +"The account the entry is from, when the catch-up covers several"
    • addedOutput schema / properties / stories / items / properties / acct / type
      Added value: +"string"
    • addedOutput schema / properties / waiting / items / properties / id
      Added value: +{
      +  "description": "ids: the message_id of what the entry quotes or names",
      +  "type": "string"
      +}
    • addedOutput schema / properties / waiting / items / properties / then_id
      Added value: +{
      +  "description": "ids: the message_id of then",
      +  "type": "string"
      +}
  2. Changed3 schema fields changedv1.6.0
    • removedInput schema / properties / account_id / description
      Removed value: -"Account id"
    • addedOutput schema / properties / direct / items / properties / tags
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / waiting / items / properties / tags
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
  3. Addedv1.0.3

TDQS

A3.6/5.0
Behavior3/5

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

The most valuable disclosure is that the mark moves first, meaning a read operation has a persistent cursor side effect — context the readOnlyHint/idempotentHint=false annotations only hint at. However, the description does not reconcile this with readOnlyHint:true, and says nothing about rate limits or how budget_tokens truncation surfaces (e.g. whether more.cursor is always present). Useful but incomplete for a tool whose main hazard is silently consuming state.

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

Conciseness4/5

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

Very short and front-loaded: scope first, then account narrowing, then the mark/cursor mechanics. Some fragments ('more.cursor: the rest.') are compressed to the point of being cryptic without the schema, but no sentence is filler.

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 values need no explanation, and the description covers the two non-obvious behaviors: mark advancement and token budgeting. The remaining gap is the mismatch between the described sections and the include enum, which leaves an agent unsure which section names are valid.

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?

With 86% schema coverage the baseline is 3, and the description does add real meaning for since (repeat vs ISO date), cursor ('the rest') and budget_tokens (answer length). But the enumerated sections — 'mentions' and 'people' — do not match the schema enum ('direct', 'addressed'), which can actively mislead an agent constructing an include array.

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

Purpose4/5

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

The description names a specific resource — a digest of what the user missed across all accounts, itemized as waiting asks, mentions, calls, people, groups and stories — which is distinguishable from siblings like search or read_messages. It is telegraphic rather than verb-first (no explicit 'retrieve'/'get'), and the section vocabulary does not exactly match the schema enum, so it is not quite a 5.

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?

It gives concrete routing guidance: account_id narrows to one account, and get_status is named as the way to discover account ids. It also explains recovery behavior — the read mark advances on call, so a lost answer requires since:"previous" — which tells the agent when to re-invoke rather than search. It stops short of stating when to prefer this over search or read_messages for narrower lookups.

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