Focus · Reddit
Typed Focus mode operations for Reddit accounts, generated from the Reddit focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
focus_reddit- Profile1
- Preferences2
- Trophies1
- Friends3
- Blocked users3
- My posts17
- My comments8
- Saved4
- Hidden2
- Voted2
- Overview1
- My subreddits5
- Subreddits7
- Feed28
- Search26
- Post comments21
- Subreddit rules5
- Post flairs2
- User flair4
- Wiki11
- Custom feeds7
- Inbox5
- Messages7
- Mentions8
- Replies8
- Sent1
- Announcements4
- Moderated subreddits4
- Mod queue19
- Mod log1
- Modmail17
- Banned users3
- Muted users3
- Approved users3
- Wiki banned3
- Wiki contributors3
- Moderators6
- Mod notes4
- Removal reasons4
- Flair templates7
- User flairs5
- Subreddit settings2
- Stylesheet2
- Widgets5
- Emojis3
- Traffic1
- Karma1
- Post performance1
- Subreddit performance1
- Best times1
Profile
Reddit: Get Profile
/accounts/{accountId}/reddit/profileGET /api/v1/me. Your Reddit account: karma, followers, account age and inbox state. Requires scopes: identity. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/profile.
Try it with MCPAsk your agent to call reddit-profile-get (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
idstringt2_ fullname
usernamestringcreated_atstring (date-time)link_karmaintegercomment_karmaintegertotal_karmaintegerawarder_karmainteger | nullawardee_karmainteger | nullicon_urlstring (uri) | nullsnoovatar_urlstring (uri) | nullfollowersinteger | nullProfile followers
profile_titlestring | nullprofile_descriptionstring | nullover_18boolean | nullis_modboolean | nullhas_verified_emailboolean | nullis_suspendedboolean | nullaccept_followersboolean | nullinbox_countinteger | nullhas_mailboolean | nullhas_mod_mailboolean | nullResponses
Preferences
Reddit: Get Preferences
/accounts/{accountId}/reddit/preferencesGET /api/v1/me/prefs. Account preferences (privacy, content, messaging). Email and password are never exposed. Requires scopes: identity. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/preferences.
Try it with MCPAsk your agent to call reddit-preferences-get (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
langstringInterface language (e.g. en)
over_18booleanI am over 18 and willing to view adult content
search_include_over_18booleanlabel_nsfwbooleanhide_from_robotsbooleanHide profile from search engines
show_presencebooleanShow online status
enable_followersbooleanAllow people to follow you
accept_pmsstringeveryonewhitelisted
show_location_based_recommendationsbooleanactivity_relevant_adsbooleanthird_party_data_personalized_adsbooleanthird_party_site_data_personalized_adsbooleanthird_party_site_data_personalized_contentbooleanallow_clicktrackingbooleanmediastringonoffsubreddit
media_previewstringonoffsubreddit
nightmodebooleandefault_comment_sortstringconfidencetopnewcontroversialoldrandomqalive
ignore_suggested_sortbooleansend_welcome_messagesbooleanemail_messagesbooleanemail_unsubscribe_allbooleanfeed_recommendations_enabledbooleantop_karma_subredditsbooleanResponses
Reddit: Update Preferences
/accounts/{accountId}/reddit/preferencesPATCH /api/v1/me/prefs. Account preferences (privacy, content, messaging). Email and password are never exposed. Requires scopes: identity, account. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/preferences.
Try it with MCPAsk your agent to call reddit-preferences-update (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
langstringInterface language (e.g. en)
over_18booleanI am over 18 and willing to view adult content
search_include_over_18booleanlabel_nsfwbooleanhide_from_robotsbooleanHide profile from search engines
show_presencebooleanShow online status
enable_followersbooleanAllow people to follow you
accept_pmsstringeveryonewhitelisted
show_location_based_recommendationsbooleanactivity_relevant_adsbooleanthird_party_data_personalized_adsbooleanthird_party_site_data_personalized_adsbooleanthird_party_site_data_personalized_contentbooleanallow_clicktrackingbooleanmediastringonoffsubreddit
media_previewstringonoffsubreddit
nightmodebooleandefault_comment_sortstringconfidencetopnewcontroversialoldrandomqalive
ignore_suggested_sortbooleansend_welcome_messagesbooleanemail_messagesbooleanemail_unsubscribe_allbooleanfeed_recommendations_enabledbooleantop_karma_subredditsbooleanReturns object
langstringInterface language (e.g. en)
over_18booleanI am over 18 and willing to view adult content
search_include_over_18booleanlabel_nsfwbooleanhide_from_robotsbooleanHide profile from search engines
show_presencebooleanShow online status
enable_followersbooleanAllow people to follow you
accept_pmsstringeveryonewhitelisted
show_location_based_recommendationsbooleanactivity_relevant_adsbooleanthird_party_data_personalized_adsbooleanthird_party_site_data_personalized_adsbooleanthird_party_site_data_personalized_contentbooleanallow_clicktrackingbooleanmediastringonoffsubreddit
media_previewstringonoffsubreddit
nightmodebooleandefault_comment_sortstringconfidencetopnewcontroversialoldrandomqalive
ignore_suggested_sortbooleansend_welcome_messagesbooleanemail_messagesbooleanemail_unsubscribe_allbooleanfeed_recommendations_enabledbooleantop_karma_subredditsbooleanResponses
Trophies
Reddit: List Trophies
/accounts/{accountId}/reddit/trophiesGET /api/v1/me/trophies. Cursor pagination: pass next_cursor back as cursor. Requires scopes: identity. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/trophies.
Try it with MCPAsk your agent to call reddit-trophies-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
idstringnamestringdescriptionstring | nullicon_urlstring (uri) | nullgranted_atstring (date-time) | nullurlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Friends
Reddit: List Followed users
/accounts/{accountId}/reddit/friendsGET /api/v1/me/friends. Users you follow (Reddit "friends"). Following must be a human action. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/friends.
Try it with MCPAsk your agent to call reddit-friends-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
idstringusername
usernamestringuser_idstring | nullsincestring (date-time) | nullnotestring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Followed users item
/accounts/{accountId}/reddit/friendsPUT /api/v1/me/friends/{username}. Users you follow (Reddit "friends"). Following must be a human action. Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/friends.
Try it with MCPAsk your agent to call reddit-friends-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
usernamestringrequired≥ 1 characters
Returns object
idstringusername
usernamestringuser_idstring | nullsincestring (date-time) | nullnotestring | nullResponses
Reddit: Delete a Followed users item
/accounts/{accountId}/reddit/friends/{itemId}DELETE /api/v1/me/friends/{username}. Users you follow (Reddit "friends"). Following must be a human action. Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/friends.
Try it with MCPAsk your agent to call reddit-friends-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Blocked users
Reddit: List Blocked users
/accounts/{accountId}/reddit/blocked-usersGET /prefs/blocked. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/blocked-users.
Try it with MCPAsk your agent to call reddit-blocked-users-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
idstringusername
usernamestringuser_idstring | nullsincestring (date-time) | nullnotestring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Blocked users item
/accounts/{accountId}/reddit/blocked-usersPOST /api/block_user (approved OAuth apps only). Requires scopes: read, account. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/blocked-users.
Try it with MCPAsk your agent to call reddit-blocked-users-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
usernamestringrequired≥ 1 characters
Returns object
idstringusername
usernamestringuser_idstring | nullsincestring (date-time) | nullnotestring | nullResponses
Reddit: Delete a Blocked users item
/accounts/{accountId}/reddit/blocked-users/{itemId}POST /r/all/api/unfriend type=enemy (scope unverified). Requires scopes: read, account. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/blocked-users.
Try it with MCPAsk your agent to call reddit-blocked-users-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
My posts
Reddit: List My posts
/accounts/{accountId}/reddit/my-postsGET /user/{me}/submitted. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.
Try it with MCPAsk your agent to call reddit-my-posts-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
sortstringdefault: "new"newhottopcontroversial
tstringTime filter for top/controversial
hourdayweekmonthyearall
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 36 item attributes
idstringrequiredt3_ fullname
short_idstringtitlestringrequired≤ 300 characters
textstringMarkdown body (self posts)
urlstring (uri) | nullpermalinkstring (uri)subredditstringauthorstringcreated_atstring (date-time)edited_atstring (date-time) | nullscoreintegerupvote_rationumber | null0–1
num_commentsintegernum_crosspostsintegerawardsintegerview_countinteger | nullkindstringselflinkimagevideogallerypollcrosspost
domainstring | nullthumbnailstring (uri) | nullflair_textstring | nullflair_template_idstring | nullover_18booleanspoilerbooleanlockedbooleanstickiedbooleanarchivedbooleandistinguishedstring | nullsend_repliesboolean | nullsavedbooleanhiddenbooleanmy_voteinteger-101
removed_by_categorystring | nullnum_reportsinteger | nullpollobject | nullShow 3 child attributes
total_votesinteger | nullends_atstring (date-time) | nulloptionsarray of objectShow 3 item attributes
idstringtextstringvotesinteger | nullgalleryarray of object | nullShow 4 item attributes
media_idstringcaptionstring | nulloutbound_urlstring (uri) | nullurlstring (uri) | nullvideo_urlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a My posts item
/accounts/{accountId}/reddit/my-postsPublish now (POST /api/submit | submit_gallery_post | submit_poll_post). Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.
Try it with MCPAsk your agent to call reddit-my-posts-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
titlestringrequired1–300 characters
textstringMarkdown body. Use {media1}… placeholders to position inline media.
kindstringdefault: "auto"autoselflinkimagevideovideogifgallerypollcrosspost
urlstring (uri)Link post URL
mediaarray of string≤ 20 items
flairIdstring≤ 36 characters
flairTextstring≤ 64 characters
nsfwbooleandefault: falsespoilerbooleandefault: falsesendRepliesbooleandefault: truevideogifbooleannativeVideobooleandefault: truebodyWithMediastringdefault: "inline"inlinecommentdrop
pollobjectShow 2 child attributes
optionsarray of string2–6 items
durationintegerdefault: 31–7
crosspostOfstringt3_ id or permalink
collectionIdstringfirstCommentstringfirstCommentStickybooleanReturns object
idstringrequiredt3_ fullname
short_idstringtitlestringrequired≤ 300 characters
textstringMarkdown body (self posts)
urlstring (uri) | nullpermalinkstring (uri)subredditstringauthorstringcreated_atstring (date-time)edited_atstring (date-time) | nullscoreintegerupvote_rationumber | null0–1
num_commentsintegernum_crosspostsintegerawardsintegerview_countinteger | nullkindstringselflinkimagevideogallerypollcrosspost
domainstring | nullthumbnailstring (uri) | nullflair_textstring | nullflair_template_idstring | nullover_18booleanspoilerbooleanlockedbooleanstickiedbooleanarchivedbooleandistinguishedstring | nullsend_repliesboolean | nullsavedbooleanhiddenbooleanmy_voteinteger-101
removed_by_categorystring | nullnum_reportsinteger | nullpollobject | nullShow 3 child attributes
total_votesinteger | nullends_atstring (date-time) | nulloptionsarray of objectShow 3 item attributes
idstringtextstringvotesinteger | nullgalleryarray of object | nullShow 4 item attributes
media_idstringcaptionstring | nulloutbound_urlstring (uri) | nullurlstring (uri) | nullvideo_urlstring (uri) | nullResponses
Reddit: Get a My posts item
/accounts/{accountId}/reddit/my-posts/{itemId}GET /api/info. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.
Try it with MCPAsk your agent to call reddit-my-posts-get (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredt3_ fullname
short_idstringtitlestringrequired≤ 300 characters
textstringMarkdown body (self posts)
urlstring (uri) | nullpermalinkstring (uri)subredditstringauthorstringcreated_atstring (date-time)edited_atstring (date-time) | nullscoreintegerupvote_rationumber | null0–1
num_commentsintegernum_crosspostsintegerawardsintegerview_countinteger | nullkindstringselflinkimagevideogallerypollcrosspost
domainstring | nullthumbnailstring (uri) | nullflair_textstring | nullflair_template_idstring | nullover_18booleanspoilerbooleanlockedbooleanstickiedbooleanarchivedbooleandistinguishedstring | nullsend_repliesboolean | nullsavedbooleanhiddenbooleanmy_voteinteger-101
removed_by_categorystring | nullnum_reportsinteger | nullpollobject | nullShow 3 child attributes
total_votesinteger | nullends_atstring (date-time) | nulloptionsarray of objectShow 3 item attributes
idstringtextstringvotesinteger | nullgalleryarray of object | nullShow 4 item attributes
media_idstringcaptionstring | nulloutbound_urlstring (uri) | nullurlstring (uri) | nullvideo_urlstring (uri) | nullResponses
Reddit: Update a My posts item
/accounts/{accountId}/reddit/my-posts/{itemId}POST /api/editusertext (+ flags/flair). Titles cannot be edited. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.
Try it with MCPAsk your agent to call reddit-my-posts-update (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
textstringnsfwbooleanspoilerbooleansendRepliesbooleanflairIdstringflairTextstringReturns object
idstringrequiredt3_ fullname
short_idstringtitlestringrequired≤ 300 characters
textstringMarkdown body (self posts)
urlstring (uri) | nullpermalinkstring (uri)subredditstringauthorstringcreated_atstring (date-time)edited_atstring (date-time) | nullscoreintegerupvote_rationumber | null0–1
num_commentsintegernum_crosspostsintegerawardsintegerview_countinteger | nullkindstringselflinkimagevideogallerypollcrosspost
domainstring | nullthumbnailstring (uri) | nullflair_textstring | nullflair_template_idstring | nullover_18booleanspoilerbooleanlockedbooleanstickiedbooleanarchivedbooleandistinguishedstring | nullsend_repliesboolean | nullsavedbooleanhiddenbooleanmy_voteinteger-101
removed_by_categorystring | nullnum_reportsinteger | nullpollobject | nullShow 3 child attributes
total_votesinteger | nullends_atstring (date-time) | nulloptionsarray of objectShow 3 item attributes
idstringtextstringvotesinteger | nullgalleryarray of object | nullShow 4 item attributes
media_idstringcaptionstring | nulloutbound_urlstring (uri) | nullurlstring (uri) | nullvideo_urlstring (uri) | nullResponses
Reddit: Delete a My posts item
/accounts/{accountId}/reddit/my-posts/{itemId}POST /api/del. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.
Try it with MCPAsk your agent to call reddit-my-posts-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Reddit: Set flair (My posts)
/accounts/{accountId}/reddit/my-posts/{itemId}/set-flairSet flair. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, flair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.
Try it with MCPAsk your agent to call reddit-my-posts-set-flair (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
flairTemplateIdstringtextstring≤ 64 characters
subredditstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Inbox replies on/off (My posts)
/accounts/{accountId}/reddit/my-posts/{itemId}/toggle-repliesInbox replies on/off. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.
Try it with MCPAsk your agent to call reddit-my-posts-toggle-replies (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statebooleanrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Add comment (My posts)
/accounts/{accountId}/reddit/my-posts/{itemId}/commentAdd comment. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.
Try it with MCPAsk your agent to call reddit-my-posts-comment (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≥ 1 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Find processed media post (My posts)
/accounts/{accountId}/reddit/my-posts/reconcileResolve an image/video post whose processing outlived publish() (title + subreddit + submittedAt). Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.
Try it with MCPAsk your agent to call reddit-my-posts-reconcile (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
titlestringrequiredsubredditstringrequiredsubmittedAtstring (date-time)Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Vote (My posts)
/accounts/{accountId}/reddit/my-posts/{itemId}/voteUpvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.
Try it with MCPAsk your agent to call reddit-my-posts-vote (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
directionintegerrequired10-1
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Save (My posts)
/accounts/{accountId}/reddit/my-posts/{itemId}/saveSave. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.
Try it with MCPAsk your agent to call reddit-my-posts-save (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
categorystringSaved category (Reddit Premium)
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unsave (My posts)
/accounts/{accountId}/reddit/my-posts/{itemId}/unsaveUnsave. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.
Try it with MCPAsk your agent to call reddit-my-posts-unsave (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Report (My posts)
/accounts/{accountId}/reddit/my-posts/{itemId}/reportReport. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.
Try it with MCPAsk your agent to call reddit-my-posts-report (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reasonstringReason text
≤ 100 characters
rule_reasonstringSubreddit rule short_name
site_reasonstringSite-wide rule
custom_textstring≤ 2000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Hide (My posts)
/accounts/{accountId}/reddit/my-posts/{itemId}/hideHide. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.
Try it with MCPAsk your agent to call reddit-my-posts-hide (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unhide (My posts)
/accounts/{accountId}/reddit/my-posts/{itemId}/unhideUnhide. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.
Try it with MCPAsk your agent to call reddit-my-posts-unhide (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Follow post (My posts)
/accounts/{accountId}/reddit/my-posts/{itemId}/followFollow post. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.
Try it with MCPAsk your agent to call reddit-my-posts-follow (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
followbooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Crosspost (My posts)
/accounts/{accountId}/reddit/my-posts/{itemId}/crosspostCrosspost to one subreddit (customise the title; no mass cross-posting). Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.
Try it with MCPAsk your agent to call reddit-my-posts-crosspost (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
titlestringrequired≤ 300 characters
nsfwbooleanspoilerbooleanflairIdstringflairTextstringsendRepliesbooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
My comments
Reddit: List My comments
/accounts/{accountId}/reddit/my-commentsGET /user/{me}/comments. Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-comments.
Try it with MCPAsk your agent to call reddit-my-comments-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
sortstringdefault: "new"newhottopcontroversial
tstringTime filter for top/controversial
hourdayweekmonthyearall
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 22 item attributes
idstringrequiredt1_ fullname
textstringauthorstringcreated_atstring (date-time)edited_atstring (date-time) | nullscoreintegerlike_countintegerparent_idstringt3_ (top level) or t1_ parent
post_idstringpost_titlestring | nullsubredditstringpermalinkstring (uri)depthintegerreplies_countintegeris_submitterbooleanis_ownboolean | nulldistinguishedstring | nullstickiedbooleanlockedbooleansavedbooleanmy_voteinteger-101
removedbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Update a My comments item
/accounts/{accountId}/reddit/my-comments/{itemId}POST /api/editusertext. Requires scopes: history, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-comments.
Try it with MCPAsk your agent to call reddit-my-comments-update (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
textstringrequired≥ 1 characters
Returns object
idstringrequiredt1_ fullname
textstringauthorstringcreated_atstring (date-time)edited_atstring (date-time) | nullscoreintegerlike_countintegerparent_idstringt3_ (top level) or t1_ parent
post_idstringpost_titlestring | nullsubredditstringpermalinkstring (uri)depthintegerreplies_countintegeris_submitterbooleanis_ownboolean | nulldistinguishedstring | nullstickiedbooleanlockedbooleansavedbooleanmy_voteinteger-101
removedbooleanResponses
Reddit: Delete a My comments item
/accounts/{accountId}/reddit/my-comments/{itemId}POST /api/del. Requires scopes: history, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-comments.
Try it with MCPAsk your agent to call reddit-my-comments-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Reddit: Pin (sticky as moderator) (My comments)
/accounts/{accountId}/reddit/my-comments/{itemId}/pinPin (sticky as moderator). Requires scopes: history, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-comments.
Try it with MCPAsk your agent to call reddit-my-comments-pin (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
pinbooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Vote (My comments)
/accounts/{accountId}/reddit/my-comments/{itemId}/voteUpvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. Requires scopes: history, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-comments.
Try it with MCPAsk your agent to call reddit-my-comments-vote (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
directionintegerrequired10-1
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Save (My comments)
/accounts/{accountId}/reddit/my-comments/{itemId}/saveSave. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-comments.
Try it with MCPAsk your agent to call reddit-my-comments-save (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
categorystringSaved category (Reddit Premium)
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unsave (My comments)
/accounts/{accountId}/reddit/my-comments/{itemId}/unsaveUnsave. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-comments.
Try it with MCPAsk your agent to call reddit-my-comments-unsave (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Report (My comments)
/accounts/{accountId}/reddit/my-comments/{itemId}/reportReport. Requires scopes: history, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-comments.
Try it with MCPAsk your agent to call reddit-my-comments-report (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reasonstringReason text
≤ 100 characters
rule_reasonstringSubreddit rule short_name
site_reasonstringSite-wide rule
custom_textstring≤ 2000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Saved
Reddit: List Saved
/accounts/{accountId}/reddit/savedGET /user/{me}/saved. Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/saved.
Try it with MCPAsk your agent to call reddit-saved-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
typestringlinkscomments
categorystringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 45 item attributes
idstringrequiredt1_ fullname
short_idstringtitlestring≤ 300 characters
textstringurlstring (uri) | nullpermalinkstring (uri)subredditstringauthorstringcreated_atstring (date-time)edited_atstring (date-time) | nullscoreintegerupvote_rationumber | null0–1
num_commentsintegernum_crosspostsintegerawardsintegerview_countinteger | nullkindstringpostcomment
domainstring | nullthumbnailstring (uri) | nullflair_textstring | nullflair_template_idstring | nullover_18booleanspoilerbooleanlockedbooleanstickiedbooleanarchivedbooleandistinguishedstring | nullsend_repliesboolean | nullsavedbooleanhiddenbooleanmy_voteinteger-101
removed_by_categorystring | nullnum_reportsinteger | nullpollobject | nullShow 3 child attributes
total_votesinteger | nullends_atstring (date-time) | nulloptionsarray of objectShow 3 item attributes
idstringtextstringvotesinteger | nullgalleryarray of object | nullShow 4 item attributes
media_idstringcaptionstring | nulloutbound_urlstring (uri) | nullurlstring (uri) | nullvideo_urlstring (uri) | nulllike_countintegerparent_idstringt3_ (top level) or t1_ parent
post_idstringpost_titlestring | nulldepthintegerreplies_countintegeris_submitterbooleanis_ownboolean | nullremovedbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Delete a Saved item
/accounts/{accountId}/reddit/saved/{itemId}POST /api/unsave. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/saved.
Try it with MCPAsk your agent to call reddit-saved-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Reddit: Saved categories (Saved)
/accounts/{accountId}/reddit/saved/categoriesSaved categories. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/saved.
Try it with MCPAsk your agent to call reddit-saved-categories (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Save item (Saved)
/accounts/{accountId}/reddit/saved/saveSave item. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/saved.
Try it with MCPAsk your agent to call reddit-saved-save (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
idstringrequiredcategorystringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Hidden
Reddit: List Hidden posts
/accounts/{accountId}/reddit/hiddenGET /user/{me}/hidden. Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/hidden.
Try it with MCPAsk your agent to call reddit-hidden-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 36 item attributes
idstringrequiredt3_ fullname
short_idstringtitlestringrequired≤ 300 characters
textstringMarkdown body (self posts)
urlstring (uri) | nullpermalinkstring (uri)subredditstringauthorstringcreated_atstring (date-time)edited_atstring (date-time) | nullscoreintegerupvote_rationumber | null0–1
num_commentsintegernum_crosspostsintegerawardsintegerview_countinteger | nullkindstringselflinkimagevideogallerypollcrosspost
domainstring | nullthumbnailstring (uri) | nullflair_textstring | nullflair_template_idstring | nullover_18booleanspoilerbooleanlockedbooleanstickiedbooleanarchivedbooleandistinguishedstring | nullsend_repliesboolean | nullsavedbooleanhiddenbooleanmy_voteinteger-101
removed_by_categorystring | nullnum_reportsinteger | nullpollobject | nullShow 3 child attributes
total_votesinteger | nullends_atstring (date-time) | nulloptionsarray of objectShow 3 item attributes
idstringtextstringvotesinteger | nullgalleryarray of object | nullShow 4 item attributes
media_idstringcaptionstring | nulloutbound_urlstring (uri) | nullurlstring (uri) | nullvideo_urlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Delete a Hidden posts item
/accounts/{accountId}/reddit/hidden/{itemId}POST /api/unhide. Requires scopes: history, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/hidden.
Try it with MCPAsk your agent to call reddit-hidden-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Voted
Reddit: List Voted
/accounts/{accountId}/reddit/votedGET /user/{me}/upvoted | downvoted. Posts you upvoted or downvoted. Removing an item clears your vote (human action). Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/voted.
Try it with MCPAsk your agent to call reddit-voted-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
directionstringdefault: "up"updown
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 36 item attributes
idstringrequiredt3_ fullname
short_idstringtitlestringrequired≤ 300 characters
textstringMarkdown body (self posts)
urlstring (uri) | nullpermalinkstring (uri)subredditstringauthorstringcreated_atstring (date-time)edited_atstring (date-time) | nullscoreintegerupvote_rationumber | null0–1
num_commentsintegernum_crosspostsintegerawardsintegerview_countinteger | nullkindstringselflinkimagevideogallerypollcrosspost
domainstring | nullthumbnailstring (uri) | nullflair_textstring | nullflair_template_idstring | nullover_18booleanspoilerbooleanlockedbooleanstickiedbooleanarchivedbooleandistinguishedstring | nullsend_repliesboolean | nullsavedbooleanhiddenbooleanmy_voteinteger-101
removed_by_categorystring | nullnum_reportsinteger | nullpollobject | nullShow 3 child attributes
total_votesinteger | nullends_atstring (date-time) | nulloptionsarray of objectShow 3 item attributes
idstringtextstringvotesinteger | nullgalleryarray of object | nullShow 4 item attributes
media_idstringcaptionstring | nulloutbound_urlstring (uri) | nullurlstring (uri) | nullvideo_urlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Delete a Voted item
/accounts/{accountId}/reddit/voted/{itemId}POST /api/vote dir=0. Posts you upvoted or downvoted. Removing an item clears your vote (human action). Requires scopes: history, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/voted.
Try it with MCPAsk your agent to call reddit-voted-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Overview
Reddit: List Activity overview
/accounts/{accountId}/reddit/overviewGET /user/{me}/overview. Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/overview.
Try it with MCPAsk your agent to call reddit-overview-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
sortstringdefault: "new"newhottopcontroversial
tstringTime filter for top/controversial
hourdayweekmonthyearall
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 45 item attributes
idstringrequiredt1_ fullname
short_idstringtitlestring≤ 300 characters
textstringurlstring (uri) | nullpermalinkstring (uri)subredditstringauthorstringcreated_atstring (date-time)edited_atstring (date-time) | nullscoreintegerupvote_rationumber | null0–1
num_commentsintegernum_crosspostsintegerawardsintegerview_countinteger | nullkindstringpostcomment
domainstring | nullthumbnailstring (uri) | nullflair_textstring | nullflair_template_idstring | nullover_18booleanspoilerbooleanlockedbooleanstickiedbooleanarchivedbooleandistinguishedstring | nullsend_repliesboolean | nullsavedbooleanhiddenbooleanmy_voteinteger-101
removed_by_categorystring | nullnum_reportsinteger | nullpollobject | nullShow 3 child attributes
total_votesinteger | nullends_atstring (date-time) | nulloptionsarray of objectShow 3 item attributes
idstringtextstringvotesinteger | nullgalleryarray of object | nullShow 4 item attributes
media_idstringcaptionstring | nulloutbound_urlstring (uri) | nullurlstring (uri) | nullvideo_urlstring (uri) | nulllike_countintegerparent_idstringt3_ (top level) or t1_ parent
post_idstringpost_titlestring | nulldepthintegerreplies_countintegeris_submitterbooleanis_ownboolean | nullremovedbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
My subreddits
Reddit: List My subreddits
/accounts/{accountId}/reddit/my-subredditsGET /subreddits/mine/{where}. Subreddits you subscribe to, moderate or are approved in; choose the default posting subreddit. Cursor pagination: pass next_cursor back as cursor. Requires scopes: mysubreddits. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-subreddits.
Try it with MCPAsk your agent to call reddit-my-subreddits-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
wherestringdefault: "postable"postablesubscribermoderatorcontributorstreams
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 22 item attributes
idstring | nullt5_ fullname
namestringrequiredprefixed_namestringtitlestring | nulldescriptionstring | nullsubscribersinteger | nullactive_usersinteger | nulltypestring | nullpublicprivaterestrictedgold_restrictedarchivedemployees_onlygold_onlyuser
over_18booleansubmission_typestringanylinkself
post_typesobjectShow 8 child attributes
selfbooleanlinkbooleanimagebooleanvideobooleangallerybooleanvideogifbooleanpollbooleancrosspostbooleanspoilers_enabledbooleanlink_flair_enabledbooleanrestrict_postingbooleanuser_is_subscriberbooleanuser_is_moderatorbooleanuser_is_contributorbooleanuser_is_bannedbooleanicon_urlstring (uri) | nullbanner_urlstring (uri) | nullurlstring (uri) | nullcreated_atstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a My subreddits item
/accounts/{accountId}/reddit/my-subredditsPOST /api/subscribe action=sub. Subreddits you subscribe to, moderate or are approved in; choose the default posting subreddit. Requires scopes: mysubreddits, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-subreddits.
Try it with MCPAsk your agent to call reddit-my-subreddits-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
Returns object
idstring | nullt5_ fullname
namestringrequiredprefixed_namestringtitlestring | nulldescriptionstring | nullsubscribersinteger | nullactive_usersinteger | nulltypestring | nullpublicprivaterestrictedgold_restrictedarchivedemployees_onlygold_onlyuser
over_18booleansubmission_typestringanylinkself
post_typesobjectShow 8 child attributes
selfbooleanlinkbooleanimagebooleanvideobooleangallerybooleanvideogifbooleanpollbooleancrosspostbooleanspoilers_enabledbooleanlink_flair_enabledbooleanrestrict_postingbooleanuser_is_subscriberbooleanuser_is_moderatorbooleanuser_is_contributorbooleanuser_is_bannedbooleanicon_urlstring (uri) | nullbanner_urlstring (uri) | nullurlstring (uri) | nullcreated_atstring (date-time) | nullResponses
Reddit: Get a My subreddits item
/accounts/{accountId}/reddit/my-subreddits/{itemId}GET /r/{sr}/about. Subreddits you subscribe to, moderate or are approved in; choose the default posting subreddit. Requires scopes: mysubreddits, read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-subreddits.
Try it with MCPAsk your agent to call reddit-my-subreddits-get (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstring | nullt5_ fullname
namestringrequiredprefixed_namestringtitlestring | nulldescriptionstring | nullsubscribersinteger | nullactive_usersinteger | nulltypestring | nullpublicprivaterestrictedgold_restrictedarchivedemployees_onlygold_onlyuser
over_18booleansubmission_typestringanylinkself
post_typesobjectShow 8 child attributes
selfbooleanlinkbooleanimagebooleanvideobooleangallerybooleanvideogifbooleanpollbooleancrosspostbooleanspoilers_enabledbooleanlink_flair_enabledbooleanrestrict_postingbooleanuser_is_subscriberbooleanuser_is_moderatorbooleanuser_is_contributorbooleanuser_is_bannedbooleanicon_urlstring (uri) | nullbanner_urlstring (uri) | nullurlstring (uri) | nullcreated_atstring (date-time) | nullResponses
Reddit: Delete a My subreddits item
/accounts/{accountId}/reddit/my-subreddits/{itemId}POST /api/subscribe action=unsub. Subreddits you subscribe to, moderate or are approved in; choose the default posting subreddit. Requires scopes: mysubreddits, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-subreddits.
Try it with MCPAsk your agent to call reddit-my-subreddits-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Reddit: Set as default subreddit (My subreddits)
/accounts/{accountId}/reddit/my-subreddits/{itemId}/set-defaultReturns { metadata: { defaultSubreddit } } for the API to persist on the account. Subreddits you subscribe to, moderate or are approved in; choose the default posting subreddit. Requires scopes: mysubreddits. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-subreddits.
Try it with MCPAsk your agent to call reddit-my-subreddits-set-default (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Subreddits
Reddit: List Subreddit browser
/accounts/{accountId}/reddit/subredditsGET /subreddits/search | /subreddits/{popular,new,default}. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddits.
Try it with MCPAsk your agent to call reddit-subreddits-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
qstringSearch text (otherwise browse where)
wherestringdefault: "popular"popularnewdefaultgold
include_nsfwbooleandefault: falseReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 22 item attributes
idstring | nullt5_ fullname
namestringrequiredprefixed_namestringtitlestring | nulldescriptionstring | nullsubscribersinteger | nullactive_usersinteger | nulltypestring | nullpublicprivaterestrictedgold_restrictedarchivedemployees_onlygold_onlyuser
over_18booleansubmission_typestringanylinkself
post_typesobjectShow 8 child attributes
selfbooleanlinkbooleanimagebooleanvideobooleangallerybooleanvideogifbooleanpollbooleancrosspostbooleanspoilers_enabledbooleanlink_flair_enabledbooleanrestrict_postingbooleanuser_is_subscriberbooleanuser_is_moderatorbooleanuser_is_contributorbooleanuser_is_bannedbooleanicon_urlstring (uri) | nullbanner_urlstring (uri) | nullurlstring (uri) | nullcreated_atstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Get a Subreddit browser item
/accounts/{accountId}/reddit/subreddits/{itemId}GET /r/{sr}/about + /about/rules (validate subreddit). Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddits.
Try it with MCPAsk your agent to call reddit-subreddits-get (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Query parameters
include_requirementsbooleandefault: falseReturns object
idstring | nullt5_ fullname
namestringrequiredprefixed_namestringtitlestring | nulldescriptionstring | nullsubscribersinteger | nullactive_usersinteger | nulltypestring | nullpublicprivaterestrictedgold_restrictedarchivedemployees_onlygold_onlyuser
over_18booleansubmission_typestringanylinkself
post_typesobjectShow 8 child attributes
selfbooleanlinkbooleanimagebooleanvideobooleangallerybooleanvideogifbooleanpollbooleancrosspostbooleanspoilers_enabledbooleanlink_flair_enabledbooleanrestrict_postingbooleanuser_is_subscriberbooleanuser_is_moderatorbooleanuser_is_contributorbooleanuser_is_bannedbooleanicon_urlstring (uri) | nullbanner_urlstring (uri) | nullurlstring (uri) | nullcreated_atstring (date-time) | nullResponses
Reddit: Subscribe (Subreddit browser)
/accounts/{accountId}/reddit/subreddits/{itemId}/subscribeSubscribe. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddits.
Try it with MCPAsk your agent to call reddit-subreddits-subscribe (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unsubscribe (Subreddit browser)
/accounts/{accountId}/reddit/subreddits/{itemId}/unsubscribeUnsubscribe. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddits.
Try it with MCPAsk your agent to call reddit-subreddits-unsubscribe (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Posting requirements (Subreddit browser)
/accounts/{accountId}/reddit/subreddits/{itemId}/requirementsPosting requirements. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddits.
Try it with MCPAsk your agent to call reddit-subreddits-requirements (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Submission guidelines (Subreddit browser)
/accounts/{accountId}/reddit/subreddits/{itemId}/submit-textSubmission guidelines. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddits.
Try it with MCPAsk your agent to call reddit-subreddits-submit-text (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Sidebar (Subreddit browser)
/accounts/{accountId}/reddit/subreddits/{itemId}/sidebarSidebar. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddits.
Try it with MCPAsk your agent to call reddit-subreddits-sidebar (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Feed
Reddit: Get a Subreddit feed item
/accounts/{accountId}/reddit/feed/{itemId}GET /api/info. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-get (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredt3_ fullname
short_idstringtitlestringrequired≤ 300 characters
textstringMarkdown body (self posts)
urlstring (uri) | nullpermalinkstring (uri)subredditstringauthorstringcreated_atstring (date-time)edited_atstring (date-time) | nullscoreintegerupvote_rationumber | null0–1
num_commentsintegernum_crosspostsintegerawardsintegerview_countinteger | nullkindstringselflinkimagevideogallerypollcrosspost
domainstring | nullthumbnailstring (uri) | nullflair_textstring | nullflair_template_idstring | nullover_18booleanspoilerbooleanlockedbooleanstickiedbooleanarchivedbooleandistinguishedstring | nullsend_repliesboolean | nullsavedbooleanhiddenbooleanmy_voteinteger-101
removed_by_categorystring | nullnum_reportsinteger | nullpollobject | nullShow 3 child attributes
total_votesinteger | nullends_atstring (date-time) | nulloptionsarray of objectShow 3 item attributes
idstringtextstringvotesinteger | nullgalleryarray of object | nullShow 4 item attributes
media_idstringcaptionstring | nulloutbound_urlstring (uri) | nullurlstring (uri) | nullvideo_urlstring (uri) | nullResponses
Reddit: Vote (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/voteUpvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-vote (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
directionintegerrequired10-1
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Save (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/saveSave. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-save (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
categorystringSaved category (Reddit Premium)
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unsave (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/unsaveUnsave. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-unsave (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Report (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/reportReport. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-report (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reasonstringReason text
≤ 100 characters
rule_reasonstringSubreddit rule short_name
site_reasonstringSite-wide rule
custom_textstring≤ 2000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Hide (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/hideHide. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-hide (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unhide (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/unhideUnhide. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-unhide (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Follow post (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/followFollow post. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-follow (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
followbooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Crosspost (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/crosspostCrosspost to one subreddit (customise the title; no mass cross-posting). Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-crosspost (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
titlestringrequired≤ 300 characters
nsfwbooleanspoilerbooleanflairIdstringflairTextstringsendRepliesbooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Approve (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/approveApprove. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-approve (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Remove (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/removeRemove. Hot/new/top/rising posts of a subreddit (or your front page). Destructive. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-remove (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
spambooleandefault: falsereason_idstringRemoval reason id
mod_notestringPrivate note for the mod log
≤ 100 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Send removal message (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/send-removal-messageSend removal message. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-send-removal-message (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
messagestringrequired≥ 1 characters
typestringdefault: "public"publicprivateprivate_exposed
titlestringSubject (private messages)
≤ 50 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Distinguish (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/distinguishDistinguish. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-distinguish (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
howstringdefault: "yes"yesnoadminspecial
stickybooleanSticky (top-level own comments only)
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Ignore reports (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/ignore-reportsIgnore reports. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-ignore-reports (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unignore reports (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/unignore-reportsUnignore reports. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-unignore-reports (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Snooze reports (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/snooze-reportsSnooze reports. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-snooze-reports (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reasonstringrequiredReport reason to snooze for 7 days
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unsnooze reports (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/unsnooze-reportsUnsnooze reports. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-unsnooze-reports (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reasonstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Lock (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/lockLock. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-lock (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unlock (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/unlockUnlock. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-unlock (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mark NSFW (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/mark-nsfwMark NSFW. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-mark-nsfw (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unmark NSFW (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/unmark-nsfwUnmark NSFW. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-unmark-nsfw (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mark spoiler (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/spoilerMark spoiler. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-spoiler (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unmark spoiler (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/unspoilerUnmark spoiler. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-unspoiler (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Pin / unpin (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/stickyPin / unpin. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-sticky (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statebooleandefault: truenumintegerHighlight slot (1–6)
1–6
to_profilebooleanReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Contest mode (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/contest-modeContest mode. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-contest-mode (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statebooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Suggested sort (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/suggested-sortSuggested sort. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-suggested-sort (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
sortstringrequiredconfidencetopnewcontroversialoldrandomqaliveblank
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Crowd control level (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/crowd-controlCrowd control level. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-crowd-control (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
levelintegerrequired0–3
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Other discussions (Subreddit feed)
/accounts/{accountId}/reddit/feed/{itemId}/duplicatesOther discussions. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.
Try it with MCPAsk your agent to call reddit-feed-duplicates (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Search
Reddit: Vote (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/voteUpvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. User-initiated search (no bulk collection / social listening). Requires scopes: read, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-vote (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
directionintegerrequired10-1
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Save (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/saveSave. User-initiated search (no bulk collection / social listening). Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-save (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
categorystringSaved category (Reddit Premium)
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unsave (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/unsaveUnsave. User-initiated search (no bulk collection / social listening). Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-unsave (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Report (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/reportReport. User-initiated search (no bulk collection / social listening). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-report (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reasonstringReason text
≤ 100 characters
rule_reasonstringSubreddit rule short_name
site_reasonstringSite-wide rule
custom_textstring≤ 2000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Hide (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/hideHide. User-initiated search (no bulk collection / social listening). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-hide (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unhide (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/unhideUnhide. User-initiated search (no bulk collection / social listening). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-unhide (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Follow post (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/followFollow post. User-initiated search (no bulk collection / social listening). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-follow (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
followbooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Crosspost (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/crosspostCrosspost to one subreddit (customise the title; no mass cross-posting). User-initiated search (no bulk collection / social listening). Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-crosspost (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
titlestringrequired≤ 300 characters
nsfwbooleanspoilerbooleanflairIdstringflairTextstringsendRepliesbooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Approve (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/approveApprove. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-approve (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Remove (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/removeRemove. User-initiated search (no bulk collection / social listening). Destructive. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-remove (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
spambooleandefault: falsereason_idstringRemoval reason id
mod_notestringPrivate note for the mod log
≤ 100 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Send removal message (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/send-removal-messageSend removal message. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-send-removal-message (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
messagestringrequired≥ 1 characters
typestringdefault: "public"publicprivateprivate_exposed
titlestringSubject (private messages)
≤ 50 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Distinguish (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/distinguishDistinguish. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-distinguish (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
howstringdefault: "yes"yesnoadminspecial
stickybooleanSticky (top-level own comments only)
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Ignore reports (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/ignore-reportsIgnore reports. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-ignore-reports (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unignore reports (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/unignore-reportsUnignore reports. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-unignore-reports (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Snooze reports (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/snooze-reportsSnooze reports. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-snooze-reports (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reasonstringrequiredReport reason to snooze for 7 days
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unsnooze reports (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/unsnooze-reportsUnsnooze reports. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-unsnooze-reports (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reasonstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Lock (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/lockLock. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-lock (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unlock (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/unlockUnlock. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-unlock (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mark NSFW (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/mark-nsfwMark NSFW. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-mark-nsfw (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unmark NSFW (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/unmark-nsfwUnmark NSFW. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-unmark-nsfw (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mark spoiler (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/spoilerMark spoiler. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-spoiler (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unmark spoiler (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/unspoilerUnmark spoiler. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-unspoiler (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Pin / unpin (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/stickyPin / unpin. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-sticky (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statebooleandefault: truenumintegerHighlight slot (1–6)
1–6
to_profilebooleanReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Contest mode (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/contest-modeContest mode. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-contest-mode (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statebooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Suggested sort (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/suggested-sortSuggested sort. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-suggested-sort (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
sortstringrequiredconfidencetopnewcontroversialoldrandomqaliveblank
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Crowd control level (Search posts)
/accounts/{accountId}/reddit/search/{itemId}/crowd-controlCrowd control level. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call reddit-search-crowd-control (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
levelintegerrequired0–3
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Post comments
Reddit: List Post comments
/accounts/{accountId}/reddit/post-commentsGET /comments/{article}. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
post_idstringt3_ id, base36 id or permalink
≥ 1 characters
sortstringdefault: "best"besttopnewcontroversialoldqa
comment_idstringFocus a sub-thread
depthinteger1–10
limitintegerdefault: 1001–500
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 22 item attributes
idstringrequiredt1_ fullname
textstringauthorstringcreated_atstring (date-time)edited_atstring (date-time) | nullscoreintegerlike_countintegerparent_idstringt3_ (top level) or t1_ parent
post_idstringpost_titlestring | nullsubredditstringpermalinkstring (uri)depthintegerreplies_countintegeris_submitterbooleanis_ownboolean | nulldistinguishedstring | nullstickiedbooleanlockedbooleansavedbooleanmy_voteinteger-101
removedbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Post comments item
/accounts/{accountId}/reddit/post-commentsPOST /api/comment. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
parent_idstringrequiredt3_ (post) or t1_ (comment) to reply to
textstringrequired≥ 1 characters
Returns object
idstringrequiredt1_ fullname
textstringauthorstringcreated_atstring (date-time)edited_atstring (date-time) | nullscoreintegerlike_countintegerparent_idstringt3_ (top level) or t1_ parent
post_idstringpost_titlestring | nullsubredditstringpermalinkstring (uri)depthintegerreplies_countintegeris_submitterbooleanis_ownboolean | nulldistinguishedstring | nullstickiedbooleanlockedbooleansavedbooleanmy_voteinteger-101
removedbooleanResponses
Reddit: Update a Post comments item
/accounts/{accountId}/reddit/post-comments/{itemId}POST /api/editusertext (own comments). The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-update (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
textstringrequired≥ 1 characters
Returns object
idstringrequiredt1_ fullname
textstringauthorstringcreated_atstring (date-time)edited_atstring (date-time) | nullscoreintegerlike_countintegerparent_idstringt3_ (top level) or t1_ parent
post_idstringpost_titlestring | nullsubredditstringpermalinkstring (uri)depthintegerreplies_countintegeris_submitterbooleanis_ownboolean | nulldistinguishedstring | nullstickiedbooleanlockedbooleansavedbooleanmy_voteinteger-101
removedbooleanResponses
Reddit: Delete a Post comments item
/accounts/{accountId}/reddit/post-comments/{itemId}POST /api/del (own comments). The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Reddit: Reply (Post comments)
/accounts/{accountId}/reddit/post-comments/{itemId}/replyReply. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-reply (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≥ 1 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Load more comments (Post comments)
/accounts/{accountId}/reddit/post-comments/load-moreLoad more comments. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-load-more (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
post_idstringrequiredchildrenarray of stringrequiredsortstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Vote (Post comments)
/accounts/{accountId}/reddit/post-comments/{itemId}/voteUpvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-vote (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
directionintegerrequired10-1
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Save (Post comments)
/accounts/{accountId}/reddit/post-comments/{itemId}/saveSave. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-save (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
categorystringSaved category (Reddit Premium)
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unsave (Post comments)
/accounts/{accountId}/reddit/post-comments/{itemId}/unsaveUnsave. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-unsave (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Report (Post comments)
/accounts/{accountId}/reddit/post-comments/{itemId}/reportReport. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-report (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reasonstringReason text
≤ 100 characters
rule_reasonstringSubreddit rule short_name
site_reasonstringSite-wide rule
custom_textstring≤ 2000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Approve (Post comments)
/accounts/{accountId}/reddit/post-comments/{itemId}/approveApprove. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-approve (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Remove (Post comments)
/accounts/{accountId}/reddit/post-comments/{itemId}/removeRemove. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Destructive. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-remove (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
spambooleandefault: falsereason_idstringRemoval reason id
mod_notestringPrivate note for the mod log
≤ 100 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Send removal message (Post comments)
/accounts/{accountId}/reddit/post-comments/{itemId}/send-removal-messageSend removal message. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-send-removal-message (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
messagestringrequired≥ 1 characters
typestringdefault: "public"publicprivateprivate_exposed
titlestringSubject (private messages)
≤ 50 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Distinguish (Post comments)
/accounts/{accountId}/reddit/post-comments/{itemId}/distinguishDistinguish. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-distinguish (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
howstringdefault: "yes"yesnoadminspecial
stickybooleanSticky (top-level own comments only)
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Ignore reports (Post comments)
/accounts/{accountId}/reddit/post-comments/{itemId}/ignore-reportsIgnore reports. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-ignore-reports (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unignore reports (Post comments)
/accounts/{accountId}/reddit/post-comments/{itemId}/unignore-reportsUnignore reports. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-unignore-reports (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Snooze reports (Post comments)
/accounts/{accountId}/reddit/post-comments/{itemId}/snooze-reportsSnooze reports. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-snooze-reports (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reasonstringrequiredReport reason to snooze for 7 days
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unsnooze reports (Post comments)
/accounts/{accountId}/reddit/post-comments/{itemId}/unsnooze-reportsUnsnooze reports. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-unsnooze-reports (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reasonstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Lock (Post comments)
/accounts/{accountId}/reddit/post-comments/{itemId}/lockLock. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-lock (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unlock (Post comments)
/accounts/{accountId}/reddit/post-comments/{itemId}/unlockUnlock. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-unlock (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Show collapsed comment (Post comments)
/accounts/{accountId}/reddit/post-comments/{itemId}/show-commentShow collapsed comment. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.
Try it with MCPAsk your agent to call reddit-post-comments-show-comment (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Subreddit rules
Reddit: List Subreddit rules
/accounts/{accountId}/reddit/subreddit-rulesGET /r/{sr}/about/rules. Rules of a subreddit (shown in the composer). Moderators can add, edit, reorder and delete rules. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddit-rules.
Try it with MCPAsk your agent to call reddit-subreddit-rules-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
subredditstringSubreddit name without r/
≥ 1 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringsubreddit:short_name
priorityintegershort_namestring≤ 100 characters
descriptionstring | null≤ 500 characters
violation_reasonstring | null≤ 100 characters
kindstringalllinkcomment
created_atstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Subreddit rules item
/accounts/{accountId}/reddit/subreddit-rulesPOST /api/add_subreddit_rule (undocumented; scope unverified). Rules of a subreddit (shown in the composer). Moderators can add, edit, reorder and delete rules. Requires scopes: read, modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddit-rules.
Try it with MCPAsk your agent to call reddit-subreddit-rules-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
short_namestringrequired≤ 100 characters
descriptionstring≤ 500 characters
kindstringdefault: "all"alllinkcomment
violation_reasonstring≤ 100 characters
Returns object
idstringsubreddit:short_name
priorityintegershort_namestring≤ 100 characters
descriptionstring | null≤ 500 characters
violation_reasonstring | null≤ 100 characters
kindstringalllinkcomment
created_atstring (date-time) | nullResponses
Reddit: Update a Subreddit rules item
/accounts/{accountId}/reddit/subreddit-rules/{itemId}POST /api/update_subreddit_rule. Rules of a subreddit (shown in the composer). Moderators can add, edit, reorder and delete rules. Requires scopes: read, modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddit-rules.
Try it with MCPAsk your agent to call reddit-subreddit-rules-update (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
short_namestring≤ 100 characters
descriptionstring≤ 500 characters
kindstringalllinkcomment
violation_reasonstring≤ 100 characters
Returns object
idstringsubreddit:short_name
priorityintegershort_namestring≤ 100 characters
descriptionstring | null≤ 500 characters
violation_reasonstring | null≤ 100 characters
kindstringalllinkcomment
created_atstring (date-time) | nullResponses
Reddit: Delete a Subreddit rules item
/accounts/{accountId}/reddit/subreddit-rules/{itemId}POST /api/remove_subreddit_rule. Rules of a subreddit (shown in the composer). Moderators can add, edit, reorder and delete rules. Requires scopes: read, modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddit-rules.
Try it with MCPAsk your agent to call reddit-subreddit-rules-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Reddit: Reorder rules (Subreddit rules)
/accounts/{accountId}/reddit/subreddit-rules/reorderReorder rules. Rules of a subreddit (shown in the composer). Moderators can add, edit, reorder and delete rules. Requires scopes: read, modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddit-rules.
Try it with MCPAsk your agent to call reddit-subreddit-rules-reorder (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
orderarray of stringrequiredshort_names in the new order
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Post flairs
Reddit: List Post flair
/accounts/{accountId}/reddit/post-flairsGET /r/{sr}/api/link_flair_v2. Link flair templates you can apply to your posts in a subreddit. Cursor pagination: pass next_cursor back as cursor. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-flairs.
Try it with MCPAsk your agent to call reddit-post-flairs-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
subredditstringSubreddit name without r/
≥ 1 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringtextstring≤ 64 characters
textColorstring | nulllightdark
backgroundColorstring | null#rrggbb
textEditablebooleantypestringtextrichtext
modOnlybooleanallowableContentstringallemojitext
maxEmojisinteger | null1–10
cssClassstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Apply to post (Post flair)
/accounts/{accountId}/reddit/post-flairs/{itemId}/applyApply to post. Link flair templates you can apply to your posts in a subreddit. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-flairs.
Try it with MCPAsk your agent to call reddit-post-flairs-apply (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringSubreddit name without r/
≥ 1 characters
post_idstringrequiredtextstring≤ 64 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
User flair
Reddit: List My user flair
/accounts/{accountId}/reddit/user-flairGET /r/{sr}/api/user_flair_v2. User flair templates in a subreddit; select one as your flair or clear it. Cursor pagination: pass next_cursor back as cursor. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flair.
Try it with MCPAsk your agent to call reddit-user-flair-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
subredditstringSubreddit name without r/
≥ 1 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringtextstring≤ 64 characters
textColorstring | nulllightdark
backgroundColorstring | null#rrggbb
textEditablebooleantypestringtextrichtext
modOnlybooleanallowableContentstringallemojitext
maxEmojisinteger | null1–10
cssClassstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Use as my flair (My user flair)
/accounts/{accountId}/reddit/user-flair/{itemId}/selectUse as my flair. User flair templates in a subreddit; select one as your flair or clear it. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flair.
Try it with MCPAsk your agent to call reddit-user-flair-select (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
textstring≤ 64 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Clear my flair (My user flair)
/accounts/{accountId}/reddit/user-flair/clearClear my flair. User flair templates in a subreddit; select one as your flair or clear it. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flair.
Try it with MCPAsk your agent to call reddit-user-flair-clear (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Show flair in this subreddit (My user flair)
/accounts/{accountId}/reddit/user-flair/toggle-displayShow flair in this subreddit. User flair templates in a subreddit; select one as your flair or clear it. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flair.
Try it with MCPAsk your agent to call reddit-user-flair-toggle-display (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
enabledbooleanrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Wiki
Reddit: List Wiki
/accounts/{accountId}/reddit/wikiGET /r/{sr}/wiki/pages. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Cursor pagination: pass next_cursor back as cursor. Requires scopes: wikiread. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.
Try it with MCPAsk your agent to call reddit-wiki-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
subredditstringSubreddit name without r/
≥ 1 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstringsubreddit:page
subredditstringpagestringcontent_mdstringrevision_idstring | nullrevision_bystring | nullrevision_datestring (date-time) | nullreasonstring | nullmay_reviseboolean | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Wiki item
/accounts/{accountId}/reddit/wikiPOST /r/{sr}/api/wiki/edit (new page). Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, wikiedit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.
Try it with MCPAsk your agent to call reddit-wiki-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
pagestringrequired≥ 1 characters
contentstringrequiredreasonstring≤ 256 characters
Returns object
idstringsubreddit:page
subredditstringpagestringcontent_mdstringrevision_idstring | nullrevision_bystring | nullrevision_datestring (date-time) | nullreasonstring | nullmay_reviseboolean | nullResponses
Reddit: Get a Wiki item
/accounts/{accountId}/reddit/wiki/{itemId}GET /r/{sr}/wiki/{page}. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.
Try it with MCPAsk your agent to call reddit-wiki-get (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Query parameters
revisionstringRevision id (v)
Returns object
idstringsubreddit:page
subredditstringpagestringcontent_mdstringrevision_idstring | nullrevision_bystring | nullrevision_datestring (date-time) | nullreasonstring | nullmay_reviseboolean | nullResponses
Reddit: Update a Wiki item
/accounts/{accountId}/reddit/wiki/{itemId}POST /r/{sr}/api/wiki/edit. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, wikiedit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.
Try it with MCPAsk your agent to call reddit-wiki-update (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
contentstringrequiredreasonstring≤ 256 characters
previousstringRevision id the edit is based on (conflict detection)
Returns object
idstringsubreddit:page
subredditstringpagestringcontent_mdstringrevision_idstring | nullrevision_bystring | nullrevision_datestring (date-time) | nullreasonstring | nullmay_reviseboolean | nullResponses
Reddit: Revisions (Wiki)
/accounts/{accountId}/reddit/wiki/{itemId}/revisionsRevisions. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.
Try it with MCPAsk your agent to call reddit-wiki-revisions (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Revert to revision (Wiki)
/accounts/{accountId}/reddit/wiki/{itemId}/revertRevert to revision. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Destructive. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.
Try it with MCPAsk your agent to call reddit-wiki-revert (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
revisionstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Hide/unhide revision (Wiki)
/accounts/{accountId}/reddit/wiki/{itemId}/hide-revisionHide/unhide revision. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.
Try it with MCPAsk your agent to call reddit-wiki-hide-revision (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
revisionstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Page settings (Wiki)
/accounts/{accountId}/reddit/wiki/{itemId}/settingsPage settings. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.
Try it with MCPAsk your agent to call reddit-wiki-settings (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Update page settings (Wiki)
/accounts/{accountId}/reddit/wiki/{itemId}/update-settingsUpdate page settings. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.
Try it with MCPAsk your agent to call reddit-wiki-update-settings (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
permlevelinteger0 = subreddit settings, 1 = approved editors, 2 = mods only
012
listedbooleanReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Allow editor (Wiki)
/accounts/{accountId}/reddit/wiki/{itemId}/add-editorAllow editor. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.
Try it with MCPAsk your agent to call reddit-wiki-add-editor (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
usernamestringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Remove editor (Wiki)
/accounts/{accountId}/reddit/wiki/{itemId}/remove-editorRemove editor. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.
Try it with MCPAsk your agent to call reddit-wiki-remove-editor (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
usernamestringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Custom feeds
Reddit: List Custom feeds
/accounts/{accountId}/reddit/custom-feedsGET /api/multi/mine. Your multireddits (custom feeds). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/custom-feeds.
Try it with MCPAsk your agent to call reddit-custom-feeds-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringnamestringdisplay_namestringpathstring | nulldescriptionstring | nullvisibilitystringprivatepublichidden
subredditsarray of stringover_18booleanicon_urlstring (uri) | nullcreated_atstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Custom feeds item
/accounts/{accountId}/reddit/custom-feedsPOST /api/multi/{multipath}. Your multireddits (custom feeds). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/custom-feeds.
Try it with MCPAsk your agent to call reddit-custom-feeds-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequiredURL name
pattern ^[A-Za-z0-9_]{2,50}$
display_namestring≤ 50 characters
descriptionstringvisibilitystringdefault: "private"privatepublichidden
subredditsarray of stringReturns object
idstringnamestringdisplay_namestringpathstring | nulldescriptionstring | nullvisibilitystringprivatepublichidden
subredditsarray of stringover_18booleanicon_urlstring (uri) | nullcreated_atstring (date-time) | nullResponses
Reddit: Get a Custom feeds item
/accounts/{accountId}/reddit/custom-feeds/{itemId}GET /api/multi/{multipath}. Your multireddits (custom feeds). Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/custom-feeds.
Try it with MCPAsk your agent to call reddit-custom-feeds-get (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringnamestringdisplay_namestringpathstring | nulldescriptionstring | nullvisibilitystringprivatepublichidden
subredditsarray of stringover_18booleanicon_urlstring (uri) | nullcreated_atstring (date-time) | nullResponses
Reddit: Update a Custom feeds item
/accounts/{accountId}/reddit/custom-feeds/{itemId}PUT /api/multi/{multipath}. Your multireddits (custom feeds). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/custom-feeds.
Try it with MCPAsk your agent to call reddit-custom-feeds-update (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
namestringURL name
pattern ^[A-Za-z0-9_]{2,50}$
display_namestring≤ 50 characters
descriptionstringvisibilitystringdefault: "private"privatepublichidden
subredditsarray of stringReturns object
idstringnamestringdisplay_namestringpathstring | nulldescriptionstring | nullvisibilitystringprivatepublichidden
subredditsarray of stringover_18booleanicon_urlstring (uri) | nullcreated_atstring (date-time) | nullResponses
Reddit: Delete a Custom feeds item
/accounts/{accountId}/reddit/custom-feeds/{itemId}DELETE /api/multi/{multipath}. Your multireddits (custom feeds). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/custom-feeds.
Try it with MCPAsk your agent to call reddit-custom-feeds-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Reddit: Add subreddit (Custom feeds)
/accounts/{accountId}/reddit/custom-feeds/{itemId}/add-subredditAdd subreddit. Your multireddits (custom feeds). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/custom-feeds.
Try it with MCPAsk your agent to call reddit-custom-feeds-add-subreddit (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Remove subreddit (Custom feeds)
/accounts/{accountId}/reddit/custom-feeds/{itemId}/remove-subredditRemove subreddit. Your multireddits (custom feeds). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/custom-feeds.
Try it with MCPAsk your agent to call reddit-custom-feeds-remove-subreddit (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Inbox
Reddit: List Inbox
/accounts/{accountId}/reddit/inboxGET /message/inbox. Everything: messages, replies to your posts and comments, and username mentions. Cursor pagination: pass next_cursor back as cursor. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/inbox.
Try it with MCPAsk your agent to call reddit-inbox-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
filterstringdefault: "inbox"inboxunreadmessagescommentsselfreplymentions
mark_readbooleandefault: falseReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 16 item attributes
idstringrequiredt1_ (comment/mention) or t4_ (message) fullname
typestringrequiredmessagecomment_replypost_replymention
subjectstring | nulltextstringauthorstring | nulltostring | nullcreated_atstring (date-time)unreadbooleandirectionstringinout
conversation_idstring | nullparent_idstring | nullpost_idstring | nullpost_titlestring | nullsubredditstring | nullpermalinkstring (uri) | nulldistinguishedstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Reply (Inbox)
/accounts/{accountId}/reddit/inbox/{itemId}/replyReply. Everything: messages, replies to your posts and comments, and username mentions. Requires scopes: privatemessages, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/inbox.
Try it with MCPAsk your agent to call reddit-inbox-reply (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≥ 1 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mark read (Inbox)
/accounts/{accountId}/reddit/inbox/{itemId}/mark-readMark read. Everything: messages, replies to your posts and comments, and username mentions. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/inbox.
Try it with MCPAsk your agent to call reddit-inbox-mark-read (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mark all read (Inbox)
/accounts/{accountId}/reddit/inbox/mark-all-readMark all read. Everything: messages, replies to your posts and comments, and username mentions. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/inbox.
Try it with MCPAsk your agent to call reddit-inbox-mark-all-read (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Delete message (Inbox)
/accounts/{accountId}/reddit/inbox/{itemId}/deletePOST /api/del_msg (private messages only; removes it from your view). Everything: messages, replies to your posts and comments, and username mentions. Destructive. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/inbox.
Try it with MCPAsk your agent to call reddit-inbox-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Messages
Reddit: List Messages
/accounts/{accountId}/reddit/messagesGET /message/messages (+ /message/sent). Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Cursor pagination: pass next_cursor back as cursor. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/messages.
Try it with MCPAsk your agent to call reddit-messages-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
include_sentbooleandefault: trueReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 8 item attributes
idstringThread root t4_ fullname
subjectstring | nullupdated_atstring (date-time) | nullunread_countintegerlast_messagestring | nullmessage_countintegerparticipantsarray of objectShow 4 item attributes
idstringnamestringusernamestring | nullsubredditstring | nullmessagesarray of objectShow 8 item attributes
idstringtextstringdirectionstringinout
sent_atstring (date-time)from_idstring | nullto_idstring | nullsubjectstring | nullunreadbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Messages item
/accounts/{accountId}/reddit/messagesPOST /api/compose (new conversation; recipient may need to accept a chat request). Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/messages.
Try it with MCPAsk your agent to call reddit-messages-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
tostringrequiredusername, u/username, or r/subreddit (messages its moderators)
subjectstring≤ 100 characters
textstringrequired≥ 1 characters
from_subredditstringSend as a subreddit you moderate
Returns object
idstringThread root t4_ fullname
subjectstring | nullupdated_atstring (date-time) | nullunread_countintegerlast_messagestring | nullmessage_countintegerparticipantsarray of objectShow 4 item attributes
idstringnamestringusernamestring | nullsubredditstring | nullmessagesarray of objectShow 8 item attributes
idstringtextstringdirectionstringinout
sent_atstring (date-time)from_idstring | nullto_idstring | nullsubjectstring | nullunreadbooleanResponses
Reddit: Get a Messages item
/accounts/{accountId}/reddit/messages/{itemId}GET /message/messages/{id}. Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/messages.
Try it with MCPAsk your agent to call reddit-messages-get (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringThread root t4_ fullname
subjectstring | nullupdated_atstring (date-time) | nullunread_countintegerlast_messagestring | nullmessage_countintegerparticipantsarray of objectShow 4 item attributes
idstringnamestringusernamestring | nullsubredditstring | nullmessagesarray of objectShow 8 item attributes
idstringtextstringdirectionstringinout
sent_atstring (date-time)from_idstring | nullto_idstring | nullsubjectstring | nullunreadbooleanResponses
Reddit: Delete a Messages item
/accounts/{accountId}/reddit/messages/{itemId}POST /api/del_msg. Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/messages.
Try it with MCPAsk your agent to call reddit-messages-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Reddit: Reply (Messages)
/accounts/{accountId}/reddit/messages/{itemId}/replyReply. Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/messages.
Try it with MCPAsk your agent to call reddit-messages-reply (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≥ 1 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mark read (Messages)
/accounts/{accountId}/reddit/messages/{itemId}/mark-readMark read. Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/messages.
Try it with MCPAsk your agent to call reddit-messages-mark-read (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mark all read (Messages)
/accounts/{accountId}/reddit/messages/mark-all-readMark all read. Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/messages.
Try it with MCPAsk your agent to call reddit-messages-mark-all-read (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mentions
Reddit: List Mentions
/accounts/{accountId}/reddit/mentionsGET /message/mentions. Comments that mention u/you. Cursor pagination: pass next_cursor back as cursor. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call reddit-mentions-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
mark_readbooleandefault: falseReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 16 item attributes
idstringrequiredt1_ (comment/mention) or t4_ (message) fullname
typestringrequiredmessagecomment_replypost_replymention
subjectstring | nulltextstringauthorstring | nulltostring | nullcreated_atstring (date-time)unreadbooleandirectionstringinout
conversation_idstring | nullparent_idstring | nullpost_idstring | nullpost_titlestring | nullsubredditstring | nullpermalinkstring (uri) | nulldistinguishedstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Reply (Mentions)
/accounts/{accountId}/reddit/mentions/{itemId}/replyReply. Comments that mention u/you. Requires scopes: privatemessages, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call reddit-mentions-reply (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≥ 1 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mark read (Mentions)
/accounts/{accountId}/reddit/mentions/{itemId}/mark-readMark read. Comments that mention u/you. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call reddit-mentions-mark-read (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mark all read (Mentions)
/accounts/{accountId}/reddit/mentions/mark-all-readMark all read. Comments that mention u/you. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call reddit-mentions-mark-all-read (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Vote (Mentions)
/accounts/{accountId}/reddit/mentions/{itemId}/voteUpvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. Comments that mention u/you. Requires scopes: privatemessages, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call reddit-mentions-vote (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
directionintegerrequired10-1
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Save (Mentions)
/accounts/{accountId}/reddit/mentions/{itemId}/saveSave. Comments that mention u/you. Requires scopes: privatemessages, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call reddit-mentions-save (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
categorystringSaved category (Reddit Premium)
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unsave (Mentions)
/accounts/{accountId}/reddit/mentions/{itemId}/unsaveUnsave. Comments that mention u/you. Requires scopes: privatemessages, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call reddit-mentions-unsave (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Report (Mentions)
/accounts/{accountId}/reddit/mentions/{itemId}/reportReport. Comments that mention u/you. Requires scopes: privatemessages, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call reddit-mentions-report (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reasonstringReason text
≤ 100 characters
rule_reasonstringSubreddit rule short_name
site_reasonstringSite-wide rule
custom_textstring≤ 2000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Replies
Reddit: List Replies
/accounts/{accountId}/reddit/repliesGET /message/comments. Replies to your comments (comments) and to your posts (selfreply). Cursor pagination: pass next_cursor back as cursor. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call reddit-replies-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
filterstringdefault: "comments"commentsselfreply
mark_readbooleandefault: falseReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 16 item attributes
idstringrequiredt1_ (comment/mention) or t4_ (message) fullname
typestringrequiredmessagecomment_replypost_replymention
subjectstring | nulltextstringauthorstring | nulltostring | nullcreated_atstring (date-time)unreadbooleandirectionstringinout
conversation_idstring | nullparent_idstring | nullpost_idstring | nullpost_titlestring | nullsubredditstring | nullpermalinkstring (uri) | nulldistinguishedstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Reply (Replies)
/accounts/{accountId}/reddit/replies/{itemId}/replyReply. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call reddit-replies-reply (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≥ 1 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mark read (Replies)
/accounts/{accountId}/reddit/replies/{itemId}/mark-readMark read. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call reddit-replies-mark-read (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mark all read (Replies)
/accounts/{accountId}/reddit/replies/mark-all-readMark all read. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call reddit-replies-mark-all-read (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Vote (Replies)
/accounts/{accountId}/reddit/replies/{itemId}/voteUpvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call reddit-replies-vote (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
directionintegerrequired10-1
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Save (Replies)
/accounts/{accountId}/reddit/replies/{itemId}/saveSave. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call reddit-replies-save (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
categorystringSaved category (Reddit Premium)
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unsave (Replies)
/accounts/{accountId}/reddit/replies/{itemId}/unsaveUnsave. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call reddit-replies-unsave (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Report (Replies)
/accounts/{accountId}/reddit/replies/{itemId}/reportReport. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call reddit-replies-report (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reasonstringReason text
≤ 100 characters
rule_reasonstringSubreddit rule short_name
site_reasonstringSite-wide rule
custom_textstring≤ 2000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Sent
Reddit: List Sent
/accounts/{accountId}/reddit/sentGET /message/sent. Cursor pagination: pass next_cursor back as cursor. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/sent.
Try it with MCPAsk your agent to call reddit-sent-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 16 item attributes
idstringrequiredt1_ (comment/mention) or t4_ (message) fullname
typestringrequiredmessagecomment_replypost_replymention
subjectstring | nulltextstringauthorstring | nulltostring | nullcreated_atstring (date-time)unreadbooleandirectionstringinout
conversation_idstring | nullparent_idstring | nullpost_idstring | nullpost_titlestring | nullsubredditstring | nullpermalinkstring (uri) | nulldistinguishedstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Announcements
Reddit: List Reddit announcements
/accounts/{accountId}/reddit/announcementsGET /api/announcements/v1[/unread]. Admin notices delivered to the inbox (response shape unverified). Cursor pagination: pass next_cursor back as cursor. Requires scopes: announcements. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/announcements.
Try it with MCPAsk your agent to call reddit-announcements-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
unreadbooleandefault: falseReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringtitlestring | nullbodystring | nullurlstring (uri) | nullsent_atstring (date-time) | nullreadbooleanhiddenbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Mark read (Reddit announcements)
/accounts/{accountId}/reddit/announcements/{itemId}/readMark read. Admin notices delivered to the inbox (response shape unverified). Requires scopes: announcements. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/announcements.
Try it with MCPAsk your agent to call reddit-announcements-read (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Hide (Reddit announcements)
/accounts/{accountId}/reddit/announcements/{itemId}/hideHide. Admin notices delivered to the inbox (response shape unverified). Requires scopes: announcements. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/announcements.
Try it with MCPAsk your agent to call reddit-announcements-hide (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mark all read (Reddit announcements)
/accounts/{accountId}/reddit/announcements/read-allMark all read. Admin notices delivered to the inbox (response shape unverified). Requires scopes: announcements. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/announcements.
Try it with MCPAsk your agent to call reddit-announcements-read-all (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Moderated subreddits
Reddit: List Moderated subreddits
/accounts/{accountId}/reddit/moderated-subredditsGET /subreddits/mine/moderator. Communities you moderate. Moderation resources act on one of these. Cursor pagination: pass next_cursor back as cursor. Requires scopes: mysubreddits. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderated-subreddits.
Try it with MCPAsk your agent to call reddit-moderated-subreddits-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 22 item attributes
idstring | nullt5_ fullname
namestringrequiredprefixed_namestringtitlestring | nulldescriptionstring | nullsubscribersinteger | nullactive_usersinteger | nulltypestring | nullpublicprivaterestrictedgold_restrictedarchivedemployees_onlygold_onlyuser
over_18booleansubmission_typestringanylinkself
post_typesobjectShow 8 child attributes
selfbooleanlinkbooleanimagebooleanvideobooleangallerybooleanvideogifbooleanpollbooleancrosspostbooleanspoilers_enabledbooleanlink_flair_enabledbooleanrestrict_postingbooleanuser_is_subscriberbooleanuser_is_moderatorbooleanuser_is_contributorbooleanuser_is_bannedbooleanicon_urlstring (uri) | nullbanner_urlstring (uri) | nullurlstring (uri) | nullcreated_atstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Leave as moderator (Moderated subreddits)
/accounts/{accountId}/reddit/moderated-subreddits/{itemId}/leaveLeave as moderator. Communities you moderate. Moderation resources act on one of these. Destructive. Requires scopes: mysubreddits, modself. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderated-subreddits.
Try it with MCPAsk your agent to call reddit-moderated-subreddits-leave (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Leave as approved user (Moderated subreddits)
/accounts/{accountId}/reddit/moderated-subreddits/{itemId}/leave-contributorLeave as approved user. Communities you moderate. Moderation resources act on one of these. Destructive. Requires scopes: mysubreddits, modself. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderated-subreddits.
Try it with MCPAsk your agent to call reddit-moderated-subreddits-leave-contributor (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Accept moderator invite (Moderated subreddits)
/accounts/{accountId}/reddit/moderated-subreddits/accept-inviteAccept moderator invite. Communities you moderate. Moderation resources act on one of these. Requires scopes: mysubreddits, modself. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderated-subreddits.
Try it with MCPAsk your agent to call reddit-moderated-subreddits-accept-invite (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mod queue
Reddit: List Mod queue
/accounts/{accountId}/reddit/mod-queueGET /r/{sr}/about/{modqueue|reports|spam|edited|unmoderated}. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
subredditstringdefault: "mod"Subreddit, or "mod" for all moderated
locationstringdefault: "modqueue"modqueuereportsspameditedunmoderated
onlystringlinkscomments
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 51 item attributes
idstringt1_ fullname
short_idstringtitlestring≤ 300 characters
textstringurlstring (uri) | nullpermalinkstring (uri)subredditstringauthorstringcreated_atstring (date-time)edited_atstring (date-time) | nullscoreintegerupvote_rationumber | null0–1
num_commentsintegernum_crosspostsintegerawardsintegerview_countinteger | nullkindstringpostcomment
domainstring | nullthumbnailstring (uri) | nullflair_textstring | nullflair_template_idstring | nullover_18booleanspoilerbooleanlockedbooleanstickiedbooleanarchivedbooleandistinguishedstring | nullsend_repliesboolean | nullsavedbooleanhiddenbooleanmy_voteinteger-101
removed_by_categorystring | nullnum_reportsintegerpollobject | nullShow 3 child attributes
total_votesinteger | nullends_atstring (date-time) | nulloptionsarray of objectShow 3 item attributes
idstringtextstringvotesinteger | nullgalleryarray of object | nullShow 4 item attributes
media_idstringcaptionstring | nulloutbound_urlstring (uri) | nullurlstring (uri) | nullvideo_urlstring (uri) | nulllike_countintegerparent_idstringt3_ (top level) or t1_ parent
post_idstringpost_titlestring | nulldepthintegerreplies_countintegeris_submitterbooleanis_ownboolean | nullremovedbooleanmod_reportsarray of array of string[[reason, count|moderator]]
user_reportsarray of array of string[[reason, count|moderator]]
approved_bystring | nullbanned_bystring | nullremoval_reasonstring | nullignore_reportsbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Approve (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/approveApprove. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-approve (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Remove (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/removeRemove. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Destructive. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-remove (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
spambooleandefault: falsereason_idstringRemoval reason id
mod_notestringPrivate note for the mod log
≤ 100 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Send removal message (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/send-removal-messageSend removal message. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-send-removal-message (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
messagestringrequired≥ 1 characters
typestringdefault: "public"publicprivateprivate_exposed
titlestringSubject (private messages)
≤ 50 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Distinguish (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/distinguishDistinguish. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-distinguish (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
howstringdefault: "yes"yesnoadminspecial
stickybooleanSticky (top-level own comments only)
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Ignore reports (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/ignore-reportsIgnore reports. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-ignore-reports (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unignore reports (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/unignore-reportsUnignore reports. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-unignore-reports (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Snooze reports (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/snooze-reportsSnooze reports. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-snooze-reports (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reasonstringrequiredReport reason to snooze for 7 days
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unsnooze reports (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/unsnooze-reportsUnsnooze reports. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-unsnooze-reports (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reasonstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Lock (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/lockLock. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-lock (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unlock (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/unlockUnlock. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-unlock (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mark NSFW (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/mark-nsfwMark NSFW. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-mark-nsfw (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unmark NSFW (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/unmark-nsfwUnmark NSFW. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-unmark-nsfw (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mark spoiler (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/spoilerMark spoiler. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-spoiler (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unmark spoiler (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/unspoilerUnmark spoiler. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-unspoiler (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Pin / unpin (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/stickyPin / unpin. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-sticky (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statebooleandefault: truenumintegerHighlight slot (1–6)
1–6
to_profilebooleanReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Contest mode (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/contest-modeContest mode. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-contest-mode (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statebooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Suggested sort (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/suggested-sortSuggested sort. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-suggested-sort (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
sortstringrequiredconfidencetopnewcontroversialoldrandomqaliveblank
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Crowd control level (Mod queue)
/accounts/{accountId}/reddit/mod-queue/{itemId}/crowd-controlCrowd control level. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.
Try it with MCPAsk your agent to call reddit-mod-queue-crowd-control (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
levelintegerrequired0–3
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mod log
Reddit: List Mod log
/accounts/{accountId}/reddit/mod-logGET /r/{sr}/about/log. Cursor pagination: pass next_cursor back as cursor. Requires scopes: modlog. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-log.
Try it with MCPAsk your agent to call reddit-mod-log-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
subredditstringdefault: "mod"typestringAction type, e.g. removelink, banuser, approvecomment
modstringModerator username (comma-separated)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 12 item attributes
idstringactionstringmodstringsubredditstringtarget_fullnamestring | nulltarget_authorstring | nulltarget_titlestring | nulltarget_bodystring | nulltarget_permalinkstring (uri) | nulldetailsstring | nulldescriptionstring | nullcreated_atstring (date-time)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Modmail
Reddit: List Modmail
/accounts/{accountId}/reddit/modmailGET /api/mod/conversations. New modmail conversations for your communities (replies reach users via Reddit Chat). Cursor pagination: pass next_cursor back as cursor. Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.
Try it with MCPAsk your agent to call reddit-modmail-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
statestringdefault: "all"allappealsnotificationsinboxfilteredinprogressmodarchiveddefaulthighlightedjoin_requestsnew
subredditsstringComma-separated subreddits (default: all)
sortstringdefault: "recent"recentmoduserunread
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 14 item attributes
idstringsubjectstring≤ 100 characters
subredditstringstateinteger | null0 new, 1 in progress, 2 archived, …
is_highlightedbooleanis_internalbooleanis_appealbooleannum_messagesintegerparticipantstring | nullauthorsarray of stringlast_updatedstring (date-time) | nullunreadbooleanlast_messagestring | nullmessagesarray of objectShow 8 item attributes
idstringtextstringauthorstringauthor_is_modbooleanauthor_hiddenbooleanis_internalbooleansent_atstring (date-time)directionstringinout
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Modmail item
/accounts/{accountId}/reddit/modmailPOST /api/mod/conversations. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.
Try it with MCPAsk your agent to call reddit-modmail-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
tostringusername (omit for a mod discussion)
subjectstringrequired≤ 100 characters
bodystringrequired≥ 1 characters
is_author_hiddenbooleandefault: falseReturns object
idstringsubjectstring≤ 100 characters
subredditstringstateinteger | null0 new, 1 in progress, 2 archived, …
is_highlightedbooleanis_internalbooleanis_appealbooleannum_messagesintegerparticipantstring | nullauthorsarray of stringlast_updatedstring (date-time) | nullunreadbooleanlast_messagestring | nullmessagesarray of objectShow 8 item attributes
idstringtextstringauthorstringauthor_is_modbooleanauthor_hiddenbooleanis_internalbooleansent_atstring (date-time)directionstringinout
Responses
Reddit: Get a Modmail item
/accounts/{accountId}/reddit/modmail/{itemId}GET /api/mod/conversations/{id}. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.
Try it with MCPAsk your agent to call reddit-modmail-get (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Query parameters
mark_readbooleandefault: falseReturns object
idstringsubjectstring≤ 100 characters
subredditstringstateinteger | null0 new, 1 in progress, 2 archived, …
is_highlightedbooleanis_internalbooleanis_appealbooleannum_messagesintegerparticipantstring | nullauthorsarray of stringlast_updatedstring (date-time) | nullunreadbooleanlast_messagestring | nullmessagesarray of objectShow 8 item attributes
idstringtextstringauthorstringauthor_is_modbooleanauthor_hiddenbooleanis_internalbooleansent_atstring (date-time)directionstringinout
Responses
Reddit: Reply (Modmail)
/accounts/{accountId}/reddit/modmail/{itemId}/replyReply. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.
Try it with MCPAsk your agent to call reddit-modmail-reply (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
bodystringrequired≥ 1 characters
is_internalbooleandefault: falsePrivate moderator note
is_author_hiddenbooleandefault: falseReply as the subreddit
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Archive (Modmail)
/accounts/{accountId}/reddit/modmail/{itemId}/archiveArchive. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.
Try it with MCPAsk your agent to call reddit-modmail-archive (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unarchive (Modmail)
/accounts/{accountId}/reddit/modmail/{itemId}/unarchiveUnarchive. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.
Try it with MCPAsk your agent to call reddit-modmail-unarchive (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Highlight (Modmail)
/accounts/{accountId}/reddit/modmail/{itemId}/highlightHighlight. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.
Try it with MCPAsk your agent to call reddit-modmail-highlight (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Remove highlight (Modmail)
/accounts/{accountId}/reddit/modmail/{itemId}/unhighlightRemove highlight. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.
Try it with MCPAsk your agent to call reddit-modmail-unhighlight (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mark read (Modmail)
/accounts/{accountId}/reddit/modmail/{itemId}/readMark read. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.
Try it with MCPAsk your agent to call reddit-modmail-read (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mark unread (Modmail)
/accounts/{accountId}/reddit/modmail/{itemId}/unreadMark unread. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.
Try it with MCPAsk your agent to call reddit-modmail-unread (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Mute user (Modmail)
/accounts/{accountId}/reddit/modmail/{itemId}/muteMute user. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.
Try it with MCPAsk your agent to call reddit-modmail-mute (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
num_hoursintegerdefault: 7272168672
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unmute user (Modmail)
/accounts/{accountId}/reddit/modmail/{itemId}/unmuteUnmute user. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.
Try it with MCPAsk your agent to call reddit-modmail-unmute (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Temporarily ban user (Modmail)
/accounts/{accountId}/reddit/modmail/{itemId}/temp-banTemporarily ban user. New modmail conversations for your communities (replies reach users via Reddit Chat). Destructive. Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.
Try it with MCPAsk your agent to call reddit-modmail-temp-ban (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
durationintegerdefault: 7Days
1–999
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unban user (Modmail)
/accounts/{accountId}/reddit/modmail/{itemId}/unbanUnban user. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.
Try it with MCPAsk your agent to call reddit-modmail-unban (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Approve user (Modmail)
/accounts/{accountId}/reddit/modmail/{itemId}/approveApprove user. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.
Try it with MCPAsk your agent to call reddit-modmail-approve (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Remove approved user (Modmail)
/accounts/{accountId}/reddit/modmail/{itemId}/disapproveRemove approved user. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.
Try it with MCPAsk your agent to call reddit-modmail-disapprove (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Unread counts (Modmail)
/accounts/{accountId}/reddit/modmail/unread-countUnread counts. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.
Try it with MCPAsk your agent to call reddit-modmail-unread-count (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Banned users
Reddit: List Banned users
/accounts/{accountId}/reddit/banned-usersGET /r/{sr}/about/banned. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/banned-users.
Try it with MCPAsk your agent to call reddit-banned-users-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
subredditstringSubreddit name without r/
≥ 1 characters
userstringFind one user
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstringsubreddit:username
subredditstringusernamestringuser_idstring | nullsincestring (date-time) | nullnotestring | nulldays_leftinteger | nullpermissionsarray of string | nullflair_textstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Banned users item
/accounts/{accountId}/reddit/banned-usersPOST /r/{sr}/api/friend type=banned. Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/banned-users.
Try it with MCPAsk your agent to call reddit-banned-users-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
usernamestringrequired≥ 1 characters
durationintegerDays; omit for permanent
1–999
ban_reasonstringReason (rule)
≤ 100 characters
notestringPrivate mod note
≤ 300 characters
ban_messagestringMessage sent to the user
ban_contextstringFullname of the offending post/comment
Returns object
idstringsubreddit:username
subredditstringusernamestringuser_idstring | nullsincestring (date-time) | nullnotestring | nulldays_leftinteger | nullpermissionsarray of string | nullflair_textstring | nullResponses
Reddit: Delete a Banned users item
/accounts/{accountId}/reddit/banned-users/{itemId}POST /r/{sr}/api/unfriend type=banned. Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/banned-users.
Try it with MCPAsk your agent to call reddit-banned-users-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Muted users
Reddit: List Muted users
/accounts/{accountId}/reddit/muted-usersGET /r/{sr}/about/muted. Users muted from modmail. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/muted-users.
Try it with MCPAsk your agent to call reddit-muted-users-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
subredditstringSubreddit name without r/
≥ 1 characters
userstringFind one user
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstringsubreddit:username
subredditstringusernamestringuser_idstring | nullsincestring (date-time) | nullnotestring | nulldays_leftinteger | nullpermissionsarray of string | nullflair_textstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Muted users item
/accounts/{accountId}/reddit/muted-usersPOST /r/{sr}/api/friend type=muted. Users muted from modmail. Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/muted-users.
Try it with MCPAsk your agent to call reddit-muted-users-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
usernamestringrequired≥ 1 characters
notestring≤ 300 characters
Returns object
idstringsubreddit:username
subredditstringusernamestringuser_idstring | nullsincestring (date-time) | nullnotestring | nulldays_leftinteger | nullpermissionsarray of string | nullflair_textstring | nullResponses
Reddit: Delete a Muted users item
/accounts/{accountId}/reddit/muted-users/{itemId}POST /r/{sr}/api/unfriend type=muted. Users muted from modmail. Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/muted-users.
Try it with MCPAsk your agent to call reddit-muted-users-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Approved users
Reddit: List Approved users
/accounts/{accountId}/reddit/approved-usersGET /r/{sr}/about/contributors. Approved contributors (can post in restricted/private communities). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/approved-users.
Try it with MCPAsk your agent to call reddit-approved-users-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
subredditstringSubreddit name without r/
≥ 1 characters
userstringFind one user
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstringsubreddit:username
subredditstringusernamestringuser_idstring | nullsincestring (date-time) | nullnotestring | nulldays_leftinteger | nullpermissionsarray of string | nullflair_textstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Approved users item
/accounts/{accountId}/reddit/approved-usersPOST /r/{sr}/api/friend type=contributor. Approved contributors (can post in restricted/private communities). Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/approved-users.
Try it with MCPAsk your agent to call reddit-approved-users-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
usernamestringrequired≥ 1 characters
Returns object
idstringsubreddit:username
subredditstringusernamestringuser_idstring | nullsincestring (date-time) | nullnotestring | nulldays_leftinteger | nullpermissionsarray of string | nullflair_textstring | nullResponses
Reddit: Delete a Approved users item
/accounts/{accountId}/reddit/approved-users/{itemId}POST /r/{sr}/api/unfriend type=contributor. Approved contributors (can post in restricted/private communities). Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/approved-users.
Try it with MCPAsk your agent to call reddit-approved-users-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Wiki banned
Reddit: List Wiki-banned users
/accounts/{accountId}/reddit/wiki-bannedGET /r/{sr}/about/wikibanned. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki-banned.
Try it with MCPAsk your agent to call reddit-wiki-banned-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
subredditstringSubreddit name without r/
≥ 1 characters
userstringFind one user
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstringsubreddit:username
subredditstringusernamestringuser_idstring | nullsincestring (date-time) | nullnotestring | nulldays_leftinteger | nullpermissionsarray of string | nullflair_textstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Wiki-banned users item
/accounts/{accountId}/reddit/wiki-bannedPOST /r/{sr}/api/friend type=wikibanned. Requires scopes: read, modcontributors, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki-banned.
Try it with MCPAsk your agent to call reddit-wiki-banned-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
usernamestringrequired≥ 1 characters
durationinteger1–999
notestring≤ 300 characters
Returns object
idstringsubreddit:username
subredditstringusernamestringuser_idstring | nullsincestring (date-time) | nullnotestring | nulldays_leftinteger | nullpermissionsarray of string | nullflair_textstring | nullResponses
Reddit: Delete a Wiki-banned users item
/accounts/{accountId}/reddit/wiki-banned/{itemId}POST /r/{sr}/api/unfriend type=wikibanned. Requires scopes: read, modcontributors, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki-banned.
Try it with MCPAsk your agent to call reddit-wiki-banned-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Wiki contributors
Reddit: List Wiki contributors
/accounts/{accountId}/reddit/wiki-contributorsGET /r/{sr}/about/wikicontributors. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki-contributors.
Try it with MCPAsk your agent to call reddit-wiki-contributors-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
subredditstringSubreddit name without r/
≥ 1 characters
userstringFind one user
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstringsubreddit:username
subredditstringusernamestringuser_idstring | nullsincestring (date-time) | nullnotestring | nulldays_leftinteger | nullpermissionsarray of string | nullflair_textstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Wiki contributors item
/accounts/{accountId}/reddit/wiki-contributorsPOST /r/{sr}/api/friend type=wikicontributor. Requires scopes: read, modcontributors, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki-contributors.
Try it with MCPAsk your agent to call reddit-wiki-contributors-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
usernamestringrequired≥ 1 characters
Returns object
idstringsubreddit:username
subredditstringusernamestringuser_idstring | nullsincestring (date-time) | nullnotestring | nulldays_leftinteger | nullpermissionsarray of string | nullflair_textstring | nullResponses
Reddit: Delete a Wiki contributors item
/accounts/{accountId}/reddit/wiki-contributors/{itemId}POST /r/{sr}/api/unfriend type=wikicontributor. Requires scopes: read, modcontributors, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki-contributors.
Try it with MCPAsk your agent to call reddit-wiki-contributors-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Moderators
Reddit: List Moderators
/accounts/{accountId}/reddit/moderatorsGET /r/{sr}/about/moderators. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderators.
Try it with MCPAsk your agent to call reddit-moderators-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
subredditstringSubreddit name without r/
≥ 1 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstringsubreddit:username
subredditstringusernamestringuser_idstring | nullsincestring (date-time) | nullnotestring | nulldays_leftinteger | nullpermissionsarray of string | nullflair_textstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Moderators item
/accounts/{accountId}/reddit/moderatorsPOST /r/{sr}/api/friend type=moderator_invite. Requires scopes: read, modothers. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderators.
Try it with MCPAsk your agent to call reddit-moderators-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
usernamestringrequired≥ 1 characters
permissionsarray of stringdefault: ["all"]Returns object
idstringsubreddit:username
subredditstringusernamestringuser_idstring | nullsincestring (date-time) | nullnotestring | nulldays_leftinteger | nullpermissionsarray of string | nullflair_textstring | nullResponses
Reddit: Update a Moderators item
/accounts/{accountId}/reddit/moderators/{itemId}POST /r/{sr}/api/setpermissions. Requires scopes: read, modothers. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderators.
Try it with MCPAsk your agent to call reddit-moderators-update (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
permissionsarray of stringrequiredinvitebooleandefault: falseChange a pending invite instead
Returns object
idstringsubreddit:username
subredditstringusernamestringuser_idstring | nullsincestring (date-time) | nullnotestring | nulldays_leftinteger | nullpermissionsarray of string | nullflair_textstring | nullResponses
Reddit: Delete a Moderators item
/accounts/{accountId}/reddit/moderators/{itemId}POST /r/{sr}/api/unfriend type=moderator. Requires scopes: read, modothers. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderators.
Try it with MCPAsk your agent to call reddit-moderators-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Reddit: Pending invites (Moderators)
/accounts/{accountId}/reddit/moderators/invitedPending invites. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderators.
Try it with MCPAsk your agent to call reddit-moderators-invited (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Cancel invite (Moderators)
/accounts/{accountId}/reddit/moderators/{itemId}/cancel-inviteCancel invite. Requires scopes: read, modothers. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderators.
Try it with MCPAsk your agent to call reddit-moderators-cancel-invite (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mod notes
Reddit: List Mod notes
/accounts/{accountId}/reddit/mod-notesGET /api/mod/notes. Private moderator notes about users (note ≤250 chars). Cursor pagination: pass next_cursor back as cursor. Requires scopes: modnote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-notes.
Try it with MCPAsk your agent to call reddit-mod-notes-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
subredditstringSubreddit name without r/
≥ 1 characters
userstring≥ 1 characters
filterstringdefault: "ALL"NOTEAPPROVALREMOVALBANMUTEINVITESPAMCONTENT_CHANGEMOD_ACTIONALL
cursorstringlimitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 12 item attributes
idstringsubreddit:user:note_id
note_idstringtypestring | nullsubredditstringuserstringoperatorstring | nullcreated_atstring (date-time)notestring | null≤ 250 characters
labelstring | nullBOT_BANPERMA_BANBANABUSE_WARNINGSPAM_WARNINGSPAM_WATCHSOLID_CONTRIBUTORHELPFUL_USER
reddit_idstring | nullactionstring | nulldetailsstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Mod notes item
/accounts/{accountId}/reddit/mod-notesPOST /api/mod/notes. Private moderator notes about users (note ≤250 chars). Requires scopes: modnote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-notes.
Try it with MCPAsk your agent to call reddit-mod-notes-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
userstringrequirednotestringrequired1–250 characters
labelstringBOT_BANPERMA_BANBANABUSE_WARNINGSPAM_WARNINGSPAM_WATCHSOLID_CONTRIBUTORHELPFUL_USER
reddit_idstringRelated t3_/t1_ fullname
Returns object
idstringsubreddit:user:note_id
note_idstringtypestring | nullsubredditstringuserstringoperatorstring | nullcreated_atstring (date-time)notestring | null≤ 250 characters
labelstring | nullBOT_BANPERMA_BANBANABUSE_WARNINGSPAM_WARNINGSPAM_WATCHSOLID_CONTRIBUTORHELPFUL_USER
reddit_idstring | nullactionstring | nulldetailsstring | nullResponses
Reddit: Delete a Mod notes item
/accounts/{accountId}/reddit/mod-notes/{itemId}DELETE /api/mod/notes. Private moderator notes about users (note ≤250 chars). Requires scopes: modnote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-notes.
Try it with MCPAsk your agent to call reddit-mod-notes-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Reddit: Latest note per user (Mod notes)
/accounts/{accountId}/reddit/mod-notes/recentLatest note per user. Private moderator notes about users (note ≤250 chars). Requires scopes: modnote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-notes.
Try it with MCPAsk your agent to call reddit-mod-notes-recent (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditsarray of stringrequiredusersarray of stringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Removal reasons
Reddit: List Removal reasons
/accounts/{accountId}/reddit/removal-reasonsGET /api/v1/{sr}/removal_reasons. Reusable removal reasons (undocumented endpoints; scope unverified). Cursor pagination: pass next_cursor back as cursor. Requires one of: modposts | modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/removal-reasons.
Try it with MCPAsk your agent to call reddit-removal-reasons-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
subredditstringSubreddit name without r/
≥ 1 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
idstringsubreddit:reason_id
reason_idstringsubredditstringtitlestring≤ 50 characters
messagestringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Removal reasons item
/accounts/{accountId}/reddit/removal-reasonsPOST /api/v1/{sr}/removal_reasons. Reusable removal reasons (undocumented endpoints; scope unverified). Requires one of: modposts | modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/removal-reasons.
Try it with MCPAsk your agent to call reddit-removal-reasons-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
titlestringrequired1–50 characters
messagestringrequired≥ 1 characters
Returns object
idstringsubreddit:reason_id
reason_idstringsubredditstringtitlestring≤ 50 characters
messagestringResponses
Reddit: Update a Removal reasons item
/accounts/{accountId}/reddit/removal-reasons/{itemId}PUT /api/v1/{sr}/removal_reasons/{id}. Reusable removal reasons (undocumented endpoints; scope unverified). Requires one of: modposts | modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/removal-reasons.
Try it with MCPAsk your agent to call reddit-removal-reasons-update (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestring≤ 50 characters
messagestringReturns object
idstringsubreddit:reason_id
reason_idstringsubredditstringtitlestring≤ 50 characters
messagestringResponses
Reddit: Delete a Removal reasons item
/accounts/{accountId}/reddit/removal-reasons/{itemId}DELETE /api/v1/{sr}/removal_reasons/{id}. Reusable removal reasons (undocumented endpoints; scope unverified). Requires one of: modposts | modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/removal-reasons.
Try it with MCPAsk your agent to call reddit-removal-reasons-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Flair templates
Reddit: List Flair templates
/accounts/{accountId}/reddit/flair-templatesGET /r/{sr}/api/link_flair_v2 | user_flair_v2. Create, edit, reorder and delete link (post) and user flair templates. Cursor pagination: pass next_cursor back as cursor. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/flair-templates.
Try it with MCPAsk your agent to call reddit-flair-templates-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
subredditstringSubreddit name without r/
≥ 1 characters
flair_typestringdefault: "LINK_FLAIR"LINK_FLAIRUSER_FLAIR
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 12 item attributes
idstringsubreddit:template_id
template_idstringsubredditstringflair_typestringLINK_FLAIRUSER_FLAIR
textstring≤ 64 characters
textColorstring | nulllightdark
backgroundColorstring | nulltextEditablebooleanmodOnlybooleanallowableContentstringallemojitext
maxEmojisinteger | nullcssClassstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Flair templates item
/accounts/{accountId}/reddit/flair-templatesPOST /r/{sr}/api/flairtemplate_v2. Create, edit, reorder and delete link (post) and user flair templates. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/flair-templates.
Try it with MCPAsk your agent to call reddit-flair-templates-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
flair_typestringdefault: "LINK_FLAIR"LINK_FLAIRUSER_FLAIR
textstringrequired≤ 64 characters
text_colorstringlightdark
background_colorstringpattern ^#?[0-9a-fA-F]{6}$|^transparent$
css_classstringtext_editablebooleandefault: falsemod_onlybooleandefault: falseallowable_contentstringdefault: "all"allemojitext
max_emojisinteger1–10
Returns object
idstringsubreddit:template_id
template_idstringsubredditstringflair_typestringLINK_FLAIRUSER_FLAIR
textstring≤ 64 characters
textColorstring | nulllightdark
backgroundColorstring | nulltextEditablebooleanmodOnlybooleanallowableContentstringallemojitext
maxEmojisinteger | nullcssClassstring | nullResponses
Reddit: Update a Flair templates item
/accounts/{accountId}/reddit/flair-templates/{itemId}POST /r/{sr}/api/flairtemplate_v2 (flair_template_id). Create, edit, reorder and delete link (post) and user flair templates. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/flair-templates.
Try it with MCPAsk your agent to call reddit-flair-templates-update (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
flair_typestringdefault: "LINK_FLAIR"LINK_FLAIRUSER_FLAIR
textstring≤ 64 characters
text_colorstringlightdark
background_colorstringpattern ^#?[0-9a-fA-F]{6}$|^transparent$
css_classstringtext_editablebooleandefault: falsemod_onlybooleandefault: falseallowable_contentstringdefault: "all"allemojitext
max_emojisinteger1–10
Returns object
idstringsubreddit:template_id
template_idstringsubredditstringflair_typestringLINK_FLAIRUSER_FLAIR
textstring≤ 64 characters
textColorstring | nulllightdark
backgroundColorstring | nulltextEditablebooleanmodOnlybooleanallowableContentstringallemojitext
maxEmojisinteger | nullcssClassstring | nullResponses
Reddit: Delete a Flair templates item
/accounts/{accountId}/reddit/flair-templates/{itemId}POST /r/{sr}/api/deleteflairtemplate. Create, edit, reorder and delete link (post) and user flair templates. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/flair-templates.
Try it with MCPAsk your agent to call reddit-flair-templates-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Reddit: Reorder templates (Flair templates)
/accounts/{accountId}/reddit/flair-templates/reorderReorder templates. Create, edit, reorder and delete link (post) and user flair templates. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/flair-templates.
Try it with MCPAsk your agent to call reddit-flair-templates-reorder (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
flair_typestringrequiredLINK_FLAIRUSER_FLAIR
orderarray of stringrequiredtemplate ids
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Delete all templates (Flair templates)
/accounts/{accountId}/reddit/flair-templates/clear-allDelete all templates. Create, edit, reorder and delete link (post) and user flair templates. Destructive. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/flair-templates.
Try it with MCPAsk your agent to call reddit-flair-templates-clear-all (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
flair_typestringrequiredLINK_FLAIRUSER_FLAIR
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reddit: Flair settings (Flair templates)
/accounts/{accountId}/reddit/flair-templates/configureFlair settings. Create, edit, reorder and delete link (post) and user flair templates. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/flair-templates.
Try it with MCPAsk your agent to call reddit-flair-templates-configure (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
flair_enabledbooleanflair_positionstringleftright
flair_self_assign_enabledbooleanlink_flair_positionstringleftright
link_flair_self_assign_enabledbooleanReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
User flairs
Reddit: List User flair assignments
/accounts/{accountId}/reddit/user-flairsGET /r/{sr}/api/flairlist. Cursor pagination: pass next_cursor back as cursor. Requires scopes: modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flairs.
Try it with MCPAsk your agent to call reddit-user-flairs-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Reddit after fullname)
limitintegerdefault: 251–100
subredditstringSubreddit name without r/
≥ 1 characters
userstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
idstringsubreddit:username
subredditstringusernamestringflair_textstring | null≤ 64 characters
flair_css_classstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a User flair assignments item
/accounts/{accountId}/reddit/user-flairsPOST /r/{sr}/api/flair | selectflair. Requires scopes: modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flairs.
Try it with MCPAsk your agent to call reddit-user-flairs-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
usernamestringrequired≥ 1 characters
textstring≤ 64 characters
css_classstringflair_template_idstringReturns object
idstringsubreddit:username
subredditstringusernamestringflair_textstring | null≤ 64 characters
flair_css_classstring | nullResponses
Reddit: Update a User flair assignments item
/accounts/{accountId}/reddit/user-flairs/{itemId}POST /r/{sr}/api/flair | selectflair. Requires scopes: modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flairs.
Try it with MCPAsk your agent to call reddit-user-flairs-update (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
textstring≤ 64 characters
css_classstringflair_template_idstringReturns object
idstringsubreddit:username
subredditstringusernamestringflair_textstring | null≤ 64 characters
flair_css_classstring | nullResponses
Reddit: Delete a User flair assignments item
/accounts/{accountId}/reddit/user-flairs/{itemId}POST /r/{sr}/api/deleteflair. Requires scopes: modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flairs.
Try it with MCPAsk your agent to call reddit-user-flairs-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Reddit: Bulk set (CSV) (User flair assignments)
/accounts/{accountId}/reddit/user-flairs/bulk-setUp to 100 lines of "user,text,css_class" per call. Requires scopes: modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flairs.
Try it with MCPAsk your agent to call reddit-user-flairs-bulk-set (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
csvstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Subreddit settings
Reddit: Get Community settings
/accounts/{accountId}/reddit/subreddit-settingsGET /r/{sr}/about/edit. Subreddit settings. Updates are merged onto the current settings (site_admin needs the full set). Requires scopes: modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddit-settings.
Try it with MCPAsk your agent to call reddit-subreddit-settings-get (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
subredditstringSubreddit name without r/
≥ 1 characters
Returns object
subredditstringSubreddit name without r/
≥ 1 characters
titlestring≤ 100 characters
public_descriptionstring≤ 500 characters
descriptionstringOld-reddit sidebar (markdown)
submit_textstringsubmit_link_labelstring≤ 60 characters
submit_text_labelstring≤ 60 characters
subreddit_typestringpublicprivaterestrictedgold_restrictedarchivedemployees_onlygold_only
content_optionsstringanylinkself
over_18booleanallow_imagesbooleanallow_videosbooleanallow_pollsbooleanallow_galleriesbooleanallow_post_crosspostsbooleanspoilers_enabledbooleanoriginal_content_tag_enabledbooleanallow_discoverybooleandefault_setbooleanAllow in r/all & popular
languagestringwelcome_message_enabledbooleanwelcome_message_textstringwikimodestringdisabledmodonlyanyone
wiki_edit_ageintegerwiki_edit_karmaintegerspam_linksstringlowhighall
spam_selfpostsstringlowhighall
spam_commentsstringlowhighall
exclude_banned_modqueuebooleancollapse_deleted_commentsbooleancomment_score_hide_minsinteger0–1440
suggested_comment_sortstring | nullconfidencetopnewcontroversialoldrandomqalive
show_mediabooleanshow_media_previewbooleancrowd_control_modebooleanfree_form_reportsbooleankey_colorstringheader_hover_textstring≤ 500 characters
Responses
Reddit: Update Community settings
/accounts/{accountId}/reddit/subreddit-settingsGET /r/{sr}/about/edit → merge → POST /api/site_admin. Subreddit settings. Updates are merged onto the current settings (site_admin needs the full set). Requires scopes: modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddit-settings.
Try it with MCPAsk your agent to call reddit-subreddit-settings-update (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
titlestring≤ 100 characters
public_descriptionstring≤ 500 characters
descriptionstringOld-reddit sidebar (markdown)
submit_textstringsubmit_link_labelstring≤ 60 characters
submit_text_labelstring≤ 60 characters
subreddit_typestringpublicprivaterestrictedgold_restrictedarchivedemployees_onlygold_only
content_optionsstringanylinkself
over_18booleanallow_imagesbooleanallow_videosbooleanallow_pollsbooleanallow_galleriesbooleanallow_post_crosspostsbooleanspoilers_enabledbooleanoriginal_content_tag_enabledbooleanallow_discoverybooleandefault_setbooleanAllow in r/all & popular
languagestringwelcome_message_enabledbooleanwelcome_message_textstringwikimodestringdisabledmodonlyanyone
wiki_edit_ageintegerwiki_edit_karmaintegerspam_linksstringlowhighall
spam_selfpostsstringlowhighall
spam_commentsstringlowhighall
exclude_banned_modqueuebooleancollapse_deleted_commentsbooleancomment_score_hide_minsinteger0–1440
suggested_comment_sortstring | nullconfidencetopnewcontroversialoldrandomqalive
show_mediabooleanshow_media_previewbooleancrowd_control_modebooleanfree_form_reportsbooleankey_colorstringheader_hover_textstring≤ 500 characters
Returns object
subredditstringSubreddit name without r/
≥ 1 characters
titlestring≤ 100 characters
public_descriptionstring≤ 500 characters
descriptionstringOld-reddit sidebar (markdown)
submit_textstringsubmit_link_labelstring≤ 60 characters
submit_text_labelstring≤ 60 characters
subreddit_typestringpublicprivaterestrictedgold_restrictedarchivedemployees_onlygold_only
content_optionsstringanylinkself
over_18booleanallow_imagesbooleanallow_videosbooleanallow_pollsbooleanallow_galleriesbooleanallow_post_crosspostsbooleanspoilers_enabledbooleanoriginal_content_tag_enabledbooleanallow_discoverybooleandefault_setbooleanAllow in r/all & popular
languagestringwelcome_message_enabledbooleanwelcome_message_textstringwikimodestringdisabledmodonlyanyone
wiki_edit_ageintegerwiki_edit_karmaintegerspam_linksstringlowhighall
spam_selfpostsstringlowhighall
spam_commentsstringlowhighall
exclude_banned_modqueuebooleancollapse_deleted_commentsbooleancomment_score_hide_minsinteger0–1440
suggested_comment_sortstring | nullconfidencetopnewcontroversialoldrandomqalive
show_mediabooleanshow_media_previewbooleancrowd_control_modebooleanfree_form_reportsbooleankey_colorstringheader_hover_textstring≤ 500 characters
Responses
Stylesheet
Reddit: Get Old-reddit stylesheet
/accounts/{accountId}/reddit/stylesheetGET /r/{sr}/about/stylesheet. Requires scopes: modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/stylesheet.
Try it with MCPAsk your agent to call reddit-stylesheet-get (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
subredditstringSubreddit name without r/
≥ 1 characters
Returns object
subredditstringstylesheetstringimagesarray of objectShow 3 item attributes
namestringurlstring (uri)linkstringResponses
Reddit: Update Old-reddit stylesheet
/accounts/{accountId}/reddit/stylesheetPOST /r/{sr}/api/subreddit_stylesheet. Requires scopes: modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/stylesheet.
Try it with MCPAsk your agent to call reddit-stylesheet-update (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
stylesheetstringrequiredreasonstring≤ 256 characters
Returns object
subredditstringstylesheetstringimagesarray of objectShow 3 item attributes
namestringurlstring (uri)linkstringResponses
Widgets
Reddit: List Sidebar widgets
/accounts/{accountId}/reddit/widgetsGET /r/{sr}/api/widgets. New-reddit widgets (text, button, community list, calendar, rules, images…). Bodies follow Reddit widget JSON. Cursor pagination: pass next_cursor back as cursor. Requires scopes: structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/widgets.
Try it with MCPAsk your agent to call reddit-widgets-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
subredditstringSubreddit name without r/
≥ 1 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringsubreddit:widget_id
widget_idstringsubredditstringsectionstringsidebartopbaridcardmoderators
kindstringshort_namestring | nulldataobjectlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Sidebar widgets item
/accounts/{accountId}/reddit/widgetsPOST /r/{sr}/api/widget. New-reddit widgets (text, button, community list, calendar, rules, images…). Bodies follow Reddit widget JSON. Requires scopes: structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/widgets.
Try it with MCPAsk your agent to call reddit-widgets-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
widgetobjectrequiredShow 2 child attributes
kindstringrequiredshortNamestringReturns object
idstringsubreddit:widget_id
widget_idstringsubredditstringsectionstringsidebartopbaridcardmoderators
kindstringshort_namestring | nulldataobjectResponses
Reddit: Update a Sidebar widgets item
/accounts/{accountId}/reddit/widgets/{itemId}PUT /r/{sr}/api/widget/{id}. New-reddit widgets (text, button, community list, calendar, rules, images…). Bodies follow Reddit widget JSON. Requires scopes: structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/widgets.
Try it with MCPAsk your agent to call reddit-widgets-update (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
widgetobjectrequiredReturns object
idstringsubreddit:widget_id
widget_idstringsubredditstringsectionstringsidebartopbaridcardmoderators
kindstringshort_namestring | nulldataobjectResponses
Reddit: Delete a Sidebar widgets item
/accounts/{accountId}/reddit/widgets/{itemId}DELETE /r/{sr}/api/widget/{id}. New-reddit widgets (text, button, community list, calendar, rules, images…). Bodies follow Reddit widget JSON. Requires scopes: structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/widgets.
Try it with MCPAsk your agent to call reddit-widgets-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Reddit: Reorder sidebar (Sidebar widgets)
/accounts/{accountId}/reddit/widgets/reorderReorder sidebar. New-reddit widgets (text, button, community list, calendar, rules, images…). Bodies follow Reddit widget JSON. Requires scopes: structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/widgets.
Try it with MCPAsk your agent to call reddit-widgets-reorder (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
sectionstringsidebar
orderarray of stringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Emojis
Reddit: List Emojis
/accounts/{accountId}/reddit/emojisGET /api/v1/{sr}/emojis/all. Custom subreddit emojis for flair and comments. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/emojis.
Try it with MCPAsk your agent to call reddit-emojis-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
subredditstringSubreddit name without r/
≥ 1 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 8 item attributes
idstringsubreddit:name
subredditstringnamestringpattern ^[A-Za-z0-9_-]{1,24}$
urlstring (uri)mod_flair_onlybooleanpost_flair_allowedbooleanuser_flair_allowedbooleancreated_bystring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reddit: Create a Emojis item
/accounts/{accountId}/reddit/emojisPOST /api/v1/{sr}/emoji_asset_upload_s3.json → S3 → POST /api/v1/{sr}/emoji.json. Custom subreddit emojis for flair and comments. Requires scopes: read, structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/emojis.
Try it with MCPAsk your agent to call reddit-emojis-create (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subredditstringrequiredSubreddit name without r/
≥ 1 characters
namestringrequiredpattern ^[A-Za-z0-9_-]{1,24}$
imagestringrequiredmod_flair_onlybooleandefault: falsepost_flair_allowedbooleandefault: trueuser_flair_allowedbooleandefault: trueReturns object
idstringsubreddit:name
subredditstringnamestringpattern ^[A-Za-z0-9_-]{1,24}$
urlstring (uri)mod_flair_onlybooleanpost_flair_allowedbooleanuser_flair_allowedbooleancreated_bystring | nullResponses
Reddit: Delete a Emojis item
/accounts/{accountId}/reddit/emojis/{itemId}DELETE /api/v1/{sr}/emoji/{name}. Custom subreddit emojis for flair and comments. Requires scopes: read, structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/emojis.
Try it with MCPAsk your agent to call reddit-emojis-delete (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Traffic
Reddit: List Community traffic
/accounts/{accountId}/reddit/trafficGET /r/{sr}/about/traffic. Uniques, pageviews and new subscribers of a subreddit you moderate. Cursor pagination: pass next_cursor back as cursor. Requires one of: modconfig | modtraffic. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/traffic.
Try it with MCPAsk your agent to call reddit-traffic-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
subredditstringSubreddit name without r/
≥ 1 characters
periodstringdefault: "day"dayhourmonth
sincestring (date)YYYY-MM-DD
untilstring (date)YYYY-MM-DD
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
datestring (date)uniquesintegerpageviewsintegersubscriptionsintegerlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Karma
Reddit: List Karma by subreddit
/accounts/{accountId}/reddit/karmaGET /api/v1/me/karma. Cursor pagination: pass next_cursor back as cursor. Requires scopes: mysubreddits. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/karma.
Try it with MCPAsk your agent to call reddit-karma-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
subredditstringlink_karmaintegercomment_karmaintegertotalintegerlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Post performance
Reddit: List Post performance
/accounts/{accountId}/reddit/post-performanceGET /user/{me}/submitted (aggregated). Daily upvotes, comments and crossposts of posts you created in the period (by post creation day). Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-performance.
Try it with MCPAsk your agent to call reddit-post-performance-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD
untilstring (date)YYYY-MM-DD
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
datestring (date)likesintegercommentsintegersharesintegerengagementsintegerpostsintegerfollowersinteger | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Subreddit performance
Reddit: List Performance by subreddit
/accounts/{accountId}/reddit/subreddit-performanceGET /user/{me}/submitted (aggregated per subreddit). Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddit-performance.
Try it with MCPAsk your agent to call reddit-subreddit-performance-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD
untilstring (date)YYYY-MM-DD
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 8 item attributes
subredditstringpostsintegertotal_scoreintegeravg_scorenumberavg_upvote_rationumber | nulltotal_commentsintegeravg_commentsnumberremovedintegerlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Best times
Reddit: List Best times to post
/accounts/{accountId}/reddit/best-timesGET /user/{me}/submitted (aggregated by weekday × hour). Average score and comments of your posts by UTC weekday (0 = Sunday) and hour. Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/best-times.
Try it with MCPAsk your agent to call reddit-best-times-list (toolset focus_reddit)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD
untilstring (date)YYYY-MM-DD
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
keystringweekdayinteger0–6
hourinteger0–23
postsintegeravg_scorenumberavg_commentsnumberlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | null