Reddit MCP server for your AI

Get the moderator-defined submission-form text for a subreddit.

Return information about a subreddit (a t5 object).

Subreddits the current user relates to; where ∈ {subscriber, contributor, moderator, streams}.

Get a subreddit's rules plus the relevant site-wide rules.

Listing of subreddits; where ∈ {popular, new, gold, default}.

List subreddit names beginning with a query string.

Search subreddits by name/description; returns a paginated listing.

Return partial subreddit objects suggested for a query (v2).

Subscribe to or unsubscribe from one or more subreddits.

Delete a link or comment authored by the user.

Edit the body text of a self-post or comment.

Follow or unfollow a post (push notification when an event post starts).

Return Link, Comment, and Subreddit objects by fullname, id, or URL.

Retrieve additional comments omitted from a comment tree ("load more comments").

Hide one or more links (removes them from default views).

Comment on a submission, reply to a comment, or reply to a message.

Save a link or comment to the user's saved items (optionally into a category).

Submit a link, self/text, image, video, videogif, or crosspost to a subreddit.

Unhide one or more previously hidden links.

Remove a link or comment from the user's saved items.

Cast or clear a vote on a link or comment.

Fetch the multireddit described by the given path.

Fetch a list of multireddits (custom feeds) belonging to the current user.

Fetch a list of public multireddits belonging to the given user.

Return the identity (account object) of the authenticated user.

Return a breakdown of the authenticated user's subreddit karma.

Return the preference settings of the logged-in user.

Return a list of the authenticated user's trophies.

Send a private message to an user or subreddit (modmail).

Get a listing of links by fullname; names is a comma-separated list of t3_ fullnames.

Get the comment tree for a link by its article id.

Return other submissions of the same URL ("other discussions") for a link.

Get the authenticated user's front-page "best" listing.

Get the controversial listing for a subreddit; t ∈ {hour, day, week, month, year, all}.

Get the hot listing for a subreddit (use "all" or "popular" for the global feed).

Listing of inbox items; where ∈ {inbox, unread, sent, mentions, messages, comments, selfreply}.

Get the newest listing for a subreddit (use "all"/"popular" for the global feed).

Get the rising listing for a subreddit.

Get the top listing for a subreddit; t ∈ {hour, day, week, month, year, all}.

Mark one or more inbox items as read.

Get information about an user by account name (a t2 object).

Listing of an user's content; where ∈ {overview, submitted, comments, upvoted, downvoted, hidden, saved, gilded}.

Get the trophy list for an user.

Search posts/links site-wide.

Search posts/links within a specific subreddit.

Create a subreddit (pass name) or configure an existing one (pass sr); send all settings on every call (mod).

Remove the subreddit's mobile banner image (mod).

Remove the subreddit's header image (mod).

Remove the subreddit's mobile icon image (mod).

Remove an uploaded image from the subreddit's stylesheet image set (mod).

Update a subreddit's stylesheet CSS (mod).

Get the current (editable) settings of a subreddit (mod).

Return a subreddit's stickied post; num (1 or 2) selects which sticky.

Get traffic statistics (hour/day/month) for a subreddit (mod).

Paginated listing of banned users in a subreddit (mod).

Paginated listing of approved contributors in a subreddit (mod).

Listing of a subreddit's moderators.

Paginated listing of muted users in a subreddit (mod).

Paginated listing of users banned from the subreddit wiki (mod).

Paginated listing of approved wiki contributors in a subreddit (mod).

Listing of user (profile) subreddits; where ∈ {popular, new}.

List partial subreddit objects whose names begin with a query string.

Return up to 5 subreddit name suggestions for a query (legacy v1).

Upload a stylesheet image or set the subreddit icon/banner (multipart upload; mod).

Return the user's configured saved-item categories.

Lock a link or comment, preventing new comments (mod or author).

Mark a link as NSFW.

Report an award (e.g.

Report a link, comment, message, award, or modmail message to mods/admins.

Set or unset contest mode for a link's comments (mod).

Enable or disable inbox replies for a link or comment.

Mark a link as a spoiler.

Set or unset a link as a sticky in its subreddit (slot 1 or 2) (mod).

Set or unset the suggested sort for a link's comments (mod).

Record that the user visited the given links (requires Reddit Premium).

Unlock a link or comment, re-allowing comments.

Remove the NSFW mark from a link.

Remove the spoiler mark from a link.

Accept an invite to moderate the specified subreddit.

Approve a post or comment; a removed target is re-inserted into listings (mod).

Distinguish a submission/comment by its author (mod).

Get recent moderation actions (the mod log).

Get a subreddit's current CSS stylesheet.

Prevent future reports on a thing from causing notifications (mod).

Abdicate approved-user (contributor) status in a subreddit.

Abdicate moderator status in a subreddit.

Listing of recently edited submissions/comments.

Listing of items requiring moderator review.

Listing of reported submissions/comments relevant to moderators.

Listing of items removed as spam.

Listing of items that have yet to be approved or removed.

Mute the author of a modmail message for 72 hours (mod).

Remove a post, comment, or modmail message; set spam=true to mark as spam (mod).

Set permissions for a moderator/contributor or a pending invite (mod).

Mark a comment so it is not collapsed due to crowd control (mod).

Snooze reports of a given reason on a thing for 7 days (mod).

Allow future reports on a thing to cause notifications again (mod).

Unmute the author of a modmail message (mod).

Un-snooze a previously snoozed report reason on a thing (mod).

Change the crowd-control level of a post (0–3) (mod).

Accept a pending invite to contribute to a live thread.

Permanently close a live thread, disallowing future updates.

Create a new live thread.

Delete a live update.

Configure/edit a live thread's settings.

Get details (about) of a live thread.

Get a listing of live threads by fullname (comma-separated, up to 100).

Get a list of contributors (and pending invites if mod) for a live thread.

Get a listing of submissions linking to a live thread.

Get a listing of updates in a live thread.

Get the currently featured ("happening now") live thread.

Hide a linked discussion (submission) from a live thread.

Invite an user to contribute to a live thread.

Abdicate your contributorship of a live thread.

Post a new update to a live thread.

Revoke another user's contributorship of a live thread.

Revoke an outstanding contributor invite on a live thread.

Report a live thread for a rule violation.

Change a contributor's (or invite's) permissions on a live thread.

Strike (cross out) the content of a live update.

Unhide a previously hidden linked discussion on a live thread.

Approve the non-mod user of a modmail conversation.

Mark a modmail conversation as archived.

Mark all conversations across selected mailboxes/subreddits as read.

Create a new modmail conversation for a subreddit.

Disapprove the non-mod user of a modmail conversation.

Get a single modmail conversation with its messages and participant dossier.

Get the user dossier (recent activity, mute/ban status) for a conversation participant.

Mark a modmail conversation as highlighted.

Get recent modmail conversations for one or more subreddits.

Return subreddits the current user moderates that have new modmail enabled.

Mark one or more modmail conversations as read.

Mark one or more modmail conversations as unread.

Mute the non-mod user of a modmail conversation; num_hours ∈ {72, 168, 672}.

Create a new message (reply) on an existing modmail conversation.

Temporarily ban the user of a modmail conversation (1–999 days).

Mark a modmail conversation as unarchived.

Unban the user of a modmail conversation.

Remove the highlight from a modmail conversation.

Unmute the non-mod user of a modmail conversation.

Get unread modmail conversation counts by mailbox state.

Delete all flair templates of a type (mod).

Configure subreddit-wide flair settings (mod).

Create or update a flair template (v2; returns the template) (mod).

Revoke an user's flair (mod).

Delete a single flair template by id (mod).

Return an user's or post's flair options (current + choices).

List available post (link) flair templates (v2).

List available user flair templates (v2; mod).

Return paginated user→flair associations in a subreddit (mod).

Reorder flair templates of a type (mod).

Assign or clear a flair template on an user (name) or post (link).

Assign flair to an user (name) or a submission (link) (mod).

Bulk-assign user flairs via CSV (user,flairtext,cssclass; ≤100 rows) (mod).

Toggle the current user's "show my flair on this subreddit" option.

Add a subreddit to a multireddit.

Copy an existing multireddit to a new path owned by the current user.

Create a multireddit at the given path (errors if it already exists).

Delete the multireddit at the given path.

Get a multireddit's description (markdown + rendered HTML).

Get info about / test whether a subreddit belongs to a multireddit.

Remove a subreddit from a multireddit.

Rename (move) a multireddit to a new path/display name.

Create or update the multireddit at the given path.

Change a multireddit's description.

Create or update a friend relationship (a note requires Reddit Premium).

Add a submission to a collection (mod).

Create a collection in a subreddit (mod).

Delete a collection (mod).

Follow or unfollow a collection.

Get a single collection by its UUID.

Get a list of collection details for a subreddit.

Remove a submission from a collection (mod).

Reorder the posts within a collection (mod).

Update a collection's description (≤500 chars) (mod).

Update a collection's display layout (TIMELINE|GALLERY) (mod).

Update a collection's title (≤300 chars) (mod).

Get information (including any note) about a specific friend.

Get a list of users blocked by the authenticated user.

Get a list of the authenticated user's friends.

Get a listing of relationships; where ∈ {friends, blocked, messaging, trusted}.

Stop being friends with an user.

Update the preference settings of the logged-in user.

Allow or deny an user as an editor of a wiki page; act ∈ {add, del} (mod).

Edit a wiki page's content.

Get a paginated listing of recent revisions across all wiki pages.

Get a listing of submissions (discussions) linking to a wiki page.

Get the content of a wiki page, optionally at a specific revision.

Get a paginated listing of revisions for a specific wiki page.

Get the visibility and permission settings of a wiki page (mod).

Toggle the public visibility of a wiki page revision (mod).

Get a list of wiki pages in a subreddit.

Revert a wiki page to a previous revision (mod).

Update the permissions and visibility of a wiki page (mod).

Block the author of a link, comment, or message by the thing's fullname.

Collapse one or more messages in the inbox.

Delete a message from the recipient's inbox view.

Get a random link from a subreddit.

Mark all of the user's messages/notifications as read.

Unblock a subreddit the user had blocked.

Uncollapse one or more messages in the inbox.

Mark one or more inbox items as unread.

Create an user↔subreddit relationship: ban, mute, contributor, wikibanned, wikicontributor, or a moderator invite (mod).

Block an user by account id or name.

Bulk-get partial user objects mapped by t2_ fullname.

Remove an user↔subreddit relationship (ban/mute/contributor/wiki*/moderator/moderator_invite) (mod).

Report an user to Reddit admins.

Add an emoji to a subreddit from an uploaded S3 asset (mod).

Delete an emoji from a subreddit (mod).

Get all emojis (snoomoji + custom) for a subreddit.

Set or enable a custom emoji display size (width/height 16–40) (mod).

Change permissions/flags for an existing emoji (mod).

Acquire an S3 upload lease for an emoji image, then upload and call emoji_add (mod).

Add a widget to a subreddit; the JSON body's shape varies by widget kind (mod).

Delete a widget (mod).

Acquire an S3 upload lease for a widget image (mod).

Retrieve the structured-styles widgets for a subreddit.

Reorder widgets within a section (e.g.

Update an existing widget (same JSON shape as create) (mod).

Retrieve descriptions of Reddit's OAuth2 scopes.

Check whether CAPTCHAs are needed for API methods that take the captcha/iden parameters.

Check whether an username is available for registration.

Gild a post or comment by fullname, spending the user's creddits.

Give gold to an user, optionally for a number of months.