Clean Email Inbox

Showing 25 of 27 from the live probe.

• List recorded account actions

  Use this tool to list recent activity originated by the user, Auto Clean, Sender Settings, or Unsubscriber. Use it when the user asks what completed or happened, or wants evidence for messages_preview. This bounded history is not an exhaustive accepted-request ledger, active queue, or MCP audit log; absence does not disprove acceptance. message_count is the affected total, previewable_message_count is retained detail, and samples are representative. When MCP resources are available, read cleanem

• Get account entitlements

  Inspect payment, coverage, trial eligibility, allowances, cancellation, billing, or premium slots, especially after an allowance rejection. If trial.status is available, offer the returned free trial and links.review_trial; the user must activate it in Clean Email. Do not promise a trial for other states or unlimited cleaning. Payment status and selected-account coverage differ. Null allowance means unconstrained; zero means exhausted. Recheck access after activation; requested operations remain

• Get account feature settings

  Use this tool to inspect stored automation settings only for explicit settings or Control Center questions, or when concrete troubleshooting evidence suggests a setting is off. Never call it during normal browsing, previews, or actions or as their preflight. Returned values are configuration, not entitlement, readiness, or proof an operation will succeed. This tool is read-only; direct the user to the returned Control Center link to make changes. When MCP resources are available, read cleanemail

• Get account information

  Inspect mailbox identity, state, readiness, index dates and app links using account_ref from account_list. Indexing can still allow bounded reads and cleanup; follow tool results and explain partial coverage. Never infer an ETA. For removal, offer links.manage_mailboxes; clarify mailbox versus connector removal. For automation settings, offer links.control_center. Use reconnect_provider when required and account_entitlements for trials, allowances or billing. When MCP resources are available, re

• List accounts

  Use this tool to list all linked Clean Email accounts and resolve a mailbox or alias to a public account_ref. Use it before an account-scoped tool when the account is unresolved. It takes no input, returns the complete linked-account set, and does not select an account. Match primary email or aliases; ask when multiple rows match, then pass the exact account_ref to later calls. When MCP resources are available, read cleanemail://mcp/resources/account-overview for additional guidance.

• Create an Auto Clean rule

  Use this tool to create an Auto Clean rule. Minimal rule: {"scope":{"rule":"...","group_by":"sender","selection":{"mode":"all"}},"action":{"type":"archive"}}. selection always belongs inside scope. Always supply apply_to_existing_messages; false means future behavior only. Start without confirmation data; if confirmation_required, follow the approval instructions and retry the exact request unchanged. accepted returns durable rule_id, not optional job completion. When MCP resources are available

• Delete an Auto Clean rule

  Use this tool to delete only one existing recurring Auto Clean rule returned by auto_clean_rule_list. It removes only that saved recurring configuration. It never deletes, moves, edits, or otherwise changes messages, and it does not undo completed action history. Submit exactly one rule_id per call. Start without confirmation data; if confirmation_required, follow the approval instructions and retry account_ref, rule_id, request_id, and idempotency_key unchanged. When MCP resources are available

• List Auto Clean rules

  Use this tool to list saved Auto Clean rules with state, scope, action, run facts, and available operations. Use filters.rule_id after auto_clean_rule_create or for exact inspection. Pass returned rule_id values to messages_preview, auto_clean_rule_modify, or auto_clean_rule_delete. It changes nothing. Total source failure is a tool error. When MCP resources are available, read cleanemail://mcp/resources/feature-auto-clean.

• Modify Auto Clean rules

  Use this tool to update, pause, or resume rules from auto_clean_rule_list. Update item fields include "changes":[{"type":"include_in_digest","enabled":true}] and "apply_to_existing_messages":false. Lifecycle items use operation and rule_id. Use auto_clean_rule_delete for deletion. Start without confirmation data; if confirmation_required, follow the returned approval instructions and retry the exact request unchanged. When MCP resources are available, read cleanemail://mcp/resources/feature-auto

• Dismiss cleaning suggestions

  Use this tool to dismiss recommendations returned by cleaning_suggestions_list only after the user explicitly asks to hide them. Pass its suggestion_id values unchanged. Dismissal changes no messages and does not prevent similar future suggestions. dismissed_count counts distinct dismissed IDs; not_found_suggestion_ids identifies requested IDs not dismissed. Disabled writes or an indeterminate current collection is a tool error. When MCP resources are available, read cleanemail://mcp/resources/f

• List cleaning suggestions

  Use this tool to list bounded Cleaning Suggestions without changing messages. Each row has trusted presentation, suggestion_id, a complete suggested_action, and count. Pass the ID to messages_preview for evidence, messages_action_apply with suggested_action for cleanup, or cleaning_suggestions_dismiss when asked to hide it. Never invent presentation. Empty means no actionable suggestion on this page; preparation or refresh is a tool error. When MCP resources are available, read cleanemail://mcp/

• List mailbox folders and labels

  Find provider folders, labels and Gmail categories such as Promotions before treating them as unavailable. Use exact folder_ref in message filters.include_folder_refs[] or filters.exclude_folder_refs[]; add unread:true for unread mail. Promotions is not all automated mail. Existing destinations need folder_ref and returned name as folder_name. For a requested new destination, messages_action_apply can create and move using null folder_ref and folder_name. Check more pages when metadata.truncated

• Browse and group mailbox

  Browse bounded message groups under an optional rule and filters. Omit rule for allEmails and group_by unless useful. Use folder_list refs in filters.include_folder_refs. Pass a returned needle together with its unchanged rule, group_by, and filters to messages_preview or messages_action_apply. Counts and supported_actions describe each group; consumers revalidate the scope and action. When MCP resources are available, read cleanemail://mcp/resources/messages-overview and cleanemail://mcp/resour

• Get suggested mailbox next steps

  Use this tool to get Clean Email-prioritized next steps for one resolved mailbox when the user asks where to start or what to review. It evaluates mailbox state, readiness, pending Screener contacts, undecided subscriptions, recent Inbox mail, Cleaning Suggestions, active actions, and recent Auto Clean activity. Call a returned tool with its arguments unchanged, open a returned URL, or present an informational title. Use the relevant domain tool directly when the user already has a specific inte

• Summarize a mailbox

  Use this tool to get a lightweight snapshot of indexed mailbox-wide totals and the number of visible folder scopes. Use it to understand mailbox scale before choosing a cleanup workflow. Optional readiness appears only while preparation is incomplete, so totals may still grow; omission means readiness does not limit the snapshot. It does not list folders or Smart Views; use folder_list and smart_view_list for counted choices. When MCP resources are available, read cleanemail://mcp/resources/acco

• Apply message actions

  Act on selected existing messages; use sender_settings_apply or other automation tools for future handling. Move can create a user-requested destination using target_folder with folder_ref:null and folder_name. Never use creation to bypass a missing existing folder. Restore requires an exact Trash mailbox_browse group, removes Trash only and may leave mail archived; use move for Inbox. Start without confirmation data; follow confirmation_required and retry the exact action unchanged. Guidance: c

• Cancel queued message actions

  Use this tool to stop eligible remaining work for selected pending or running actions using decimal-string IDs from an accepted apply result or messages_action_queue_list. Submit IDs unchanged; no confirmation is needed. IDs are transient, so not_found can mean the job completed or expired. Interpret every per-item outcome: cancellation_pending includes a retry delay, and cancellation_indeterminate requires a queue refresh. Cancellation cannot reverse processed messages. When MCP resources are a

• List queued message actions

  Use this tool to list live MCP message actions with transient cancellation IDs. An accepted apply result exposes queue_item_id only when exactly one job represents that item; use this list for fan-out or omitted IDs. Acceptance does not guarantee a live row. Excludes non-MCP, indexing, and system jobs; absence does not disprove acceptance. Continue with next_after_queue_item_id. Unavailable data is a tool error. When MCP resources are available, read cleanemail://mcp/resources/message-actions-ov

• Preview messages

  Inspect bounded metadata for one suggestion, known sender, subscription, pending Screener contact, Mailbox group, Auto Clean rule, or history target. Scope selects the variant; Mailbox scopes keep rule, group_by, and needle together. matching_message_count is total; messages is bounded evidence. Missing or unavailable targets are tool errors, not empty results. Returns snippets, never bodies, and changes no mail. Pass non-null message_id to messages_action_apply. When MCP resources are available

• Apply Screener decisions

  Use this tool to decide pending contacts from screener_pending_list or sender_list rows with awaiting_screener_decision true. Use only a decision listed in available_decisions. Start without confirmation data. accepted means Clean Email owns the decision, not completion; check screener_pending_list or screener_history_list. For confirmation_required, follow the returned approval instructions and retry unchanged. For rejected, explain message and reason_code. When MCP resources are available, rea

• List previously screened senders

  Use this tool to list senders previously processed through Screener, with screening time and current Sender Settings when available. These rows are no longer pending: use sender_settings_apply for changes and messages_preview for evidence, never screener_decision_apply. History is bounded, current settings may differ from the original decision, and unavailable history data is a tool error. When MCP resources are available, read cleanemail://mcp/resources/feature-screener.

• List pending Screener senders

  Use this tool to list senders awaiting a Screener decision, with contact IDs, bounded evidence, and decisions currently available for each sender. Use it before screener_decision_apply; submit only a decision returned in available_decisions. Previously screened senders belong in screener_history_list. A successful response always contains a trustworthy pending list; cache refresh or unavailable data is a tool error. When MCP resources are available, read cleanemail://mcp/resources/feature-screen

• List known senders

  Use this tool to find or rank sender contacts by volume, activity, settings, pending Screener state, or subscription membership. Omit filters for a bounded highest-volume ranking; filters intersect. Pass contact_id to messages_preview or sender_settings_apply. Pending contacts use screener_pending_list and screener_decision_apply; subscription groups use unsubscriber_list. Each row is one contact, not a domain. When MCP resources are available, read cleanemail://mcp/resources/feature-sender-sett

• Apply Sender Settings changes

  Change future Sender Settings for contact_id values. Minimal shape: action={"contact_ids":[123],"changes":[{"type":"starred","enabled":true}],"apply_to_existing_messages":false}; changes is a nonempty typed array inside action. Pending contacts use screener_decision_apply. Start without confirmation data. Follow confirmation_required instructions, then retry unchanged. accepted returns queue_item_id only for exactly one job; use queue list for fan-out. When MCP resources are available, read clea

• List mailbox views and Smart Folders

  List the complete counted Mailbox-view and Smart Folder catalog. Browse by passing a row's rule unchanged to mailbox_browse. Use equivalent_folder_ref only in provider-folder contexts: pass it into filters.include_folder_refs[] or filters.exclude_folder_refs[], or pair it as folder_ref with folder_name set to the returned title for an existing destination. Titles are presentation, never identity. Counts may overlap or grow; zero is valid. When MCP resources are available, read cleanemail://mcp/r