List Your Mentions
list_mentionsList the mentions RedReplier saved for the user's keywords: public posts on Reddit, Hacker News, X, Bluesky, and Facebook, each AI-scored 0-100 with its source, matched keyword, status, content, and any generated relevanceReason and aiReplySuggestion. Two defaults hide rows: REJECTED mentions are excluded unless statuses names them, and mentions below the website's minimum score (30 by default) are hidden unless includeLowRelevance is true, even when scoreBuckets asks for LOW or VERY_LOW. Mentions containing a word on the website's ignore list (ignoredKeywords, changed with update_website) never appear. Returns { mentions, total, limit, offset }; page with offset while offset < total. Sort RELEVANCE for the best leads, RECENT for what is new; from/to filter on ingestion time, not publish time. Reads mentions already saved in the account; it does not search or contact any network. Each mention is a public post with its text, URL and the author's public handle as shown on that network; private Facebook groups are never read. Use count_mentions for the number alone, explain_mention for one mention's reasoning, and update_mention_status to triage.
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": "list_mentions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Only mentions RedReplier saved at or before this ISO 8601 datetime (ingestion time, not the post date). Omit for no upper bound | |
| from | No | Only mentions RedReplier saved at or after this ISO 8601 datetime (ingestion time, not the post date). Omit for no lower bound | |
| sort | No | Order of the rows: RELEVANCE puts the highest score first, RECENT the newest first. Omit for RELEVANCE | |
| limit | No | Page size: how many mentions to return in this call | |
| offset | No | How many matching mentions to skip, for reading the next page: add limit to it after each call and stop once it reaches total. Omit to start at the first mention | |
| sources | No | Which networks the conversations come from. Reddit splits into posts and comments, TWITTER is X, FACEBOOK is public pages and profiles, and FACEBOOK_GROUP is posts inside Facebook groups. Omit for every network | |
| keywords | No | Keyword texts whose mentions to include: the value field of a keyword in list_websites or get_website, not its id. Each must match the whole keyword, ignoring case, so "crm" does not match "best crm". Omit for every keyword | |
| minScore | No | Relevance score a mention needs to be included, e.g. 70 for strong leads only. Setting it also drops mentions that have no score yet. It adds to the website's own minimum score rather than replacing it, so pair it with includeLowRelevance to look below that. Omit for no extra cutoff | |
| statuses | No | Which triage states to include. NEW means nobody has reviewed the mention yet, APPROVED means someone marked it a real lead, REJECTED means someone marked it noise. Omit to see new and approved mentions; rejected ones show only when you ask for them | |
| websiteId | No | Website whose mentions to read, by its id from list_websites. Omit to cover every website in the workspace | |
| workspaceId | No | Workspace to act in: an id from list_workspaces. Omit to use the default workspace. Use the same workspaceId for every call about the same workspace, since ids from one workspace do not exist in another | |
| scoreBuckets | No | Score bands to include, combined with OR. Each band covers a range of the 0-100 relevance score: VERY_LOW under 10, LOW 10-29, MEDIUM 30-49, HIGH 50-74, VERY_HIGH 75 and up. Omit for every band. The two lowest bands return rows only with includeLowRelevance set | |
| includeLowRelevance | No | Also include mentions scoring below the website's minimum score (30 by default). Omit or false to hide them |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |