list_junk_candidates
Identify junk senders that Outlook's filter has missed, returning ranked candidates with specific reasons for each flag, enabling informed manual rule creation without automatic actions.
Instructions
Find likely junk/spam senders that Outlook's filter has NOT caught.
Read-only analysis. It moves nothing and changes nothing — it returns ranked candidates with the specific reasons each was flagged, so the user can judge the reasoning rather than just the verdict.
Signals include: whether the user has ever written to the sender, whether
every message is unread, whether the domain already appears in Junk, display
names claiming a brand their domain doesn't support, free-webmail senders
posing as organisations, manipulative subject patterns, and (with deep)
bulk-mail headers.
Senders already handled by an existing inbox rule are scored down and marked, so you don't propose a rule that duplicates one you have.
To act on a candidate, call propose_rule and show the user the preview.
Never act on a candidate automatically.
Args:
folder: Folder to analyse. Defaults to Inbox; use a full path for nested
folders.
days: How far back to look. Default 180.
limit: Maximum candidates to return. Default 25, capped at 100.
deep: Also fetch bulk-mail headers (List-Unsubscribe) for the top
candidates. Slower — it costs one request per candidate.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | ||
| deep | No | ||
| limit | No | ||
| folder | No | Inbox |