Tool to retrieve preference settings of the logged in user. Use when you need to check user preferences or settings.

DEPRECATED: Use RetrieveRedditPost instead. Tool to retrieve newest posts from a subreddit sorted by creation time. Use when you need to find the most recently submitted posts to discover fresh content. Returns a paginated listing of posts ranked by newest first.

Tool to retrieve a random public Reddit post from any subreddit. Use when you want to discover serendipitous content or need a random post for testing or entertainment purposes.

Retrieves information about a specified Reddit user account, including karma scores and gold status. Use when you need to get profile information for any public Reddit user.

Tool to retrieve top-rated posts from a subreddit with time filters. Use when you need to find the most popular posts from a specific time period (hour, day, week, month, year, or all-time). Returns a paginated listing of posts ranked by score within the specified time frame.

Tool to retrieve all available OAuth scopes supported by the Reddit API. Use when you need to understand what permissions are available or check scope definitions.

Fetch the explicit posting rules for a subreddit to ensure compliance before posting or commenting. Use when you need to verify content meets community guidelines or explain subreddit requirements to users.

Tool to search subreddits by title and description. Use when you need to find subreddits matching a specific topic or keyword. Returns a paginated listing of subreddits with their details including subscribers, descriptions, and other metadata.

Fetches the list of user flair assignments for a given subreddit. Returns paginated results with user flair details. Returned flair_id values are scoped to the specific subreddit and must not be reused across different subreddits.

Tool to check whether a username is available for registration on Reddit. Use when you need to verify if a username can be used to create a new account.

List available link/post flairs for a subreddit (including flair_template_id) so posts can satisfy flair-required validation. Use when you need to discover valid flair IDs before creating a post in a subreddit that requires flair. Note: Reddit may return empty or deny access if the authenticated user cannot set link flair and is not a moderator.

Posts a comment on Reddit, replying to an existing submission (post) or another comment. Fails if the target thread is locked, archived, or restricted — verify thread state beforehand. Rapid successive calls trigger Reddit RATELIMIT errors with explicit cooldown hints (e.g., 'take a break for 9 minutes'); honor the specified wait before retrying. A successful API response does not guarantee public visibility — automod or spam filters may silently remove the comment. Publishes immediately and publicly; confirm target and text before executing.

Retrieves all comments for a Reddit post given its base-36 article ID. Response is a two-element listings array: post metadata in listings[0]; comments in listings[1].data.children with text at each [].data.body and nested replies under each comment's replies field. Replies require recursive traversal to capture full discussion. Large, locked, or archived threads may return truncated trees or more placeholders rather than full results. Filter out comments where body is [deleted] or [removed]; use parent_id to reconstruct conversation flow. No time-filter parameter — compare created_utc against a UTC cutoff to filter by date.

Retrieves posts from a specified, publicly accessible subreddit. Responses nest post data under data.children[].data; inspect the structure before parsing. Pagination uses a data.after cursor; deduplicate across pages by post id. No built-in date filtering; compare created_utc (Unix seconds, UTC) client-side. Rate limit: ~1–2 requests/second; back off on HTTP 429.

Retrieves detailed information for a single Reddit comment or post using its fullname. Returns only the specified item, not surrounding thread context; use REDDIT_RETRIEVE_POST_COMMENTS for full discussion retrieval. Deleted, removed, or quarantined items may return empty or partial payloads.

Searches Reddit for posts/comments using a query. Results nested under data.children[i].data (kind t3 for posts); a posts array may also appear — inspect actual response path. No native time-range filter; compare created_utc (Unix epoch, UTC) client-side for recency filtering. Empty children is a valid no-results outcome. Key post fields: score, num_comments, created_utc, permalink. Rate limit: ~1–2 requests/sec; HTTP 429 indicates throttling.

Enable or disable inbox replies for a submission or comment. Use when you want to control whether you receive inbox notifications for replies to your own posts or comments.