Reddit

Creates a new text or link post on a specified, existing Reddit subreddit, optionally applying a flair. Immediately publishes publicly visible content — confirm subreddit, title, and body with the user before executing. Posts may be silently removed post-submission by automoderator or subreddit rules (errors: SUBMIT_V…

Untrusted display-only summary

Deletes a Reddit comment, identified by its fullname ID, if it was authored by the authenticated user. Deletion is permanent and irreversible.

Untrusted display-only summary

Permanently and irreversibly deletes a Reddit post by its ID. Confirm with the user before calling. Only works on posts authored by the authenticated account; attempting to delete another user's post will fail.

Untrusted display-only summary

Edits the body text of the authenticated user's own existing comment or self-post on Reddit; cannot edit link posts or titles.

Untrusted display-only summary

Tool to retrieve a listing of Reddit posts sorted by the specified criteria (hot, new, top, rising, controversial, best). Use when you need to get posts from the Reddit front page or all of Reddit with a specific sort order. Supports pagination and time filtering for top and controversial sorts. For new controversial-…

Untrusted display-only summary

Tool to retrieve controversial posts from all subreddits with time filters. Use when you need to find the most controversial posts across Reddit from a specific time period (hour, day, week, month, year, or all-time). Returns a paginated listing of posts ranked by controversy within the specified time frame.

Untrusted display-only summary

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

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

DEPRECATED: Use RetrieveRedditPost with sort='top' and time_filter set instead - it now supports the same hour/day/week/month/year/all time filtering. 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, mont…

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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 f…

Untrusted display-only summary

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 sp…

Untrusted display-only summary

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 captu…

Untrusted display-only summary

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.…

Untrusted display-only summary

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.

Untrusted display-only summary

Searches Reddit for posts using a query. Results are nested under `data.children[i].data` (kind `t3` for posts); a `posts` array may also appear, so inspect the actual response path. Optional `time_filter` restricts results to a time period (hour/day/week/month/year/all). Optional `result_type` must include `link`; no…

Untrusted display-only summary

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.

Untrusted display-only summary