List a saved query's matches
saved_queries_matches_listList posts matched by a saved query, one page at a time, with optional filters for platform, time, sentiment, relevance, attention, and post kind.
Instructions
List the posts a saved query has matched, a page at a time, optionally by platform, time, sentiment or, with insights, relevance (relevant leaves out posts not about the topic), attention (needs_reply or risk) and kind. Every post is kept and listed unless a filter is given. Pass page.nextCursor back as cursor, with the same sort, for the next page. Free: reads what earlier runs stored.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>",
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "saved_queries_matches_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Only posts whose title or text contains this, ignoring case. | |
| id | Yes | The saved query's id. | |
| kind | No | Only matches insights judged to be this kind of post. | |
| sort | No | `posted` (default): the newest posts first, by when they were posted (or found, when the platform gave no time). `found`: the most recently found first, for keeping a copy in step. | |
| limit | No | Matches a page, up to 100. Default 50. | |
| since | No | Only matches first seen at or after this time. | |
| until | No | Only matches first seen before this time. | |
| author | No | Only posts by this author: their handle as the post gives it (`author.handle`), without the `@`. Pair with `platform` when the same handle could be on several. | |
| cursor | No | The `nextCursor` of the previous page, with the same `sort`. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| platform | No | A platform a search runs on: `twitter` (X), `reddit`, `youtube`, `tiktok`, `linkedin`, `instagram` (searched by hashtag, so only posts that use the hashtag are found), `threads` (searched by plain words, one short page a search, so it can miss posts) or `hackernews` (stories and comments). More platforms follow. | |
| attention | No | Only matches insights flagged as needing a reply, or as a risk. | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| relevance | No | Only matches with this relevance (a person's, where one was set, else the estimate); `relevant` is anything but `unrelated`. Matches without insights count as relevant. | |
| sentiment | No | Only matches with this sentiment (a person's, where one was set, else the estimate). | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. |