scalekit105 toolsOAuth 2.0CommunicationMedia

Connect to Reddit to access user identity, subreddit data, posts, comments, and mod tools.

Reddit connector

Install the SDK
Section titled “Install the SDK”
- Node.js
- Python
Terminal window
1 npm install @scalekit-sdk/node
Terminal window
1 pip install scalekit
Full SDK reference: Node.js | Python
Set your credentials
Section titled “Set your credentials”

Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.
.env
```
SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
SCALEKIT_CLIENT_ID=<your-client-id>
SCALEKIT_CLIENT_SECRET=<your-client-secret>
```

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3

4
const scalekit = new ScalekitClient(
5
  process.env.SCALEKIT_ENV_URL,
6
  process.env.SCALEKIT_CLIENT_ID,
7
  process.env.SCALEKIT_CLIENT_SECRET,
8
)
9
const actions = scalekit.actions
10

11
const connector = 'reddit'
12
const identifier = 'user_123'
13

14
// Generate an authorization link for the user
15
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
16
console.log('Authorize Reddit:', link)
17
process.stdout.write('Press Enter after authorizing...')
18
await new Promise(r => process.stdin.once('data', r))
19

20
// Make your first call
21
const result = await actions.executeTool({
22
  connector,
23
  identifier,
24
  toolName: 'reddit_inbox_get',
25
  toolInput: {},
26
})
27
console.log(result)

1
import os
2
from scalekit.client import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENV_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "reddit"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize Reddit:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={},
27
    tool_name="reddit_inbox_get",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

What you can do

Connect this agent connector to let your agent:

List wiki pages, subreddits new — Get the list of wiki pages in a subreddit
Revisions wiki page — Get the revision history of a specific wiki page
Get wiki page, user flair, unread — Get the content and metadata of a wiki page in a subreddit
Edit wiki page, content — Edit or create a wiki page in a subreddit
Vote records — Cast an upvote (1), downvote (-1), or remove vote (0) on a post or comment identified by its fullname
Upvoted user — Get the posts and comments upvoted by a user

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

reddit_best#Get the best posts from the authenticated user's personalized front page. Requires the read scope.5 params

Get the best posts from the authenticated user's personalized front page. Requires the read scope.

NameTypeRequiredDescription

afterstringoptionalFullname of the last post for pagination

countintegeroptionalNumber of items already seen for accurate pagination

limitintegeroptionalMaximum number of posts to return (default 25, max 100)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_comment_submit#Submit a comment on a post or reply to an existing comment. The thing_id is the fullname of the post (t3_xxx) or comment (t1_xxx) being replied to. Requires the submit scope.4 params

Submit a comment on a post or reply to an existing comment. The thing_id is the fullname of the post (t3_xxx) or comment (t1_xxx) being replied to. Requires the submit scope.

NameTypeRequiredDescription

textstringrequiredComment body text in Markdown

thing_idstringrequiredFullname of the post or comment to reply to (e.g. t3_xxx for post, t1_xxx for comment)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_content_approve#Approve a post or comment in a subreddit, removing it from the mod queue. Requires modposts scope and moderator access.3 params

Approve a post or comment in a subreddit, removing it from the mod queue. Requires modposts scope and moderator access.

NameTypeRequiredDescription

idstringrequiredFullname of the post or comment to approve (e.g. t3_xxx or t1_xxx)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_content_delete#Delete a post (t3_xxx) or comment (t1_xxx) by its fullname. Only works on content owned by the authenticated user. Requires the edit scope.3 params

Delete a post (t3_xxx) or comment (t1_xxx) by its fullname. Only works on content owned by the authenticated user. Requires the edit scope.

NameTypeRequiredDescription

idstringrequiredFullname of the post or comment to delete (e.g. t3_xxx or t1_xxx)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_content_distinguish#Mark a post or comment as distinguished (moderator or admin), which highlights it visually. Use 'yes' to distinguish as mod, 'no' to remove distinction, 'admin' for admin. Requires modposts scope.5 params

Mark a post or comment as distinguished (moderator or admin), which highlights it visually. Use 'yes' to distinguish as mod, 'no' to remove distinction, 'admin' for admin. Requires modposts scope.

NameTypeRequiredDescription

howstringrequiredHow to distinguish: yes (mod), no (remove), admin, special

idstringrequiredFullname of the post or comment to distinguish

schema_versionstringoptionalOptional schema version to use for tool execution

stickybooleanoptionalSticky the distinguished comment at the top of the thread

tool_versionstringoptionalOptional tool version to use for execution

reddit_content_edit#Edit the text of a self post or comment owned by the current user. The thing_id must be a fullname (t3_xxx for posts, t1_xxx for comments). Requires the edit scope.4 params

Edit the text of a self post or comment owned by the current user. The thing_id must be a fullname (t3_xxx for posts, t1_xxx for comments). Requires the edit scope.

NameTypeRequiredDescription

textstringrequiredNew body text in Markdown

thing_idstringrequiredFullname of the post or comment to edit (e.g. t3_xxx or t1_xxx)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_content_lock#Lock a post or comment to prevent further replies. Requires modposts scope and moderator access.3 params

Lock a post or comment to prevent further replies. Requires modposts scope and moderator access.

NameTypeRequiredDescription

idstringrequiredFullname of the post or comment to lock (e.g. t3_xxx or t1_xxx)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_content_nsfw#Mark a post as Not Safe For Work (NSFW). Requires modposts scope; usable by subreddit moderators or by the post's own author.3 params

Mark a post as Not Safe For Work (NSFW). Requires modposts scope; usable by subreddit moderators or by the post's own author.

NameTypeRequiredDescription

idstringrequiredFullname of the post to mark NSFW (e.g. t3_xxx)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_content_remove#Remove a post or comment from a subreddit as a moderator. Optionally mark it as spam. Requires modposts scope and moderator access.4 params

Remove a post or comment from a subreddit as a moderator. Optionally mark it as spam. Requires modposts scope and moderator access.

NameTypeRequiredDescription

idstringrequiredFullname of the post or comment to remove (e.g. t3_xxx or t1_xxx)

schema_versionstringoptionalOptional schema version to use for tool execution

spambooleanoptionalSet to true if the removal is for spam (affects account ranking)

tool_versionstringoptionalOptional tool version to use for execution

reddit_content_report#Report a post or comment for a rule violation. Provide the fullname of the thing (t3_xxx for posts, t1_xxx for comments) and the reason. Requires the report scope.5 params

Report a post or comment for a rule violation. Provide the fullname of the thing (t3_xxx for posts, t1_xxx for comments) and the reason. Requires the report scope.

NameTypeRequiredDescription

reasonstringrequiredReason for the report

thing_idstringrequiredFullname of the post or comment to report (e.g. t3_xxx or t1_xxx)

other_reasonstringoptionalAdditional details about the report

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_content_save#Save a post or comment to the current user's saved list. Accepts the fullname of the post (t3_xxx) or comment (t1_xxx). Requires the save scope.3 params

Save a post or comment to the current user's saved list. Accepts the fullname of the post (t3_xxx) or comment (t1_xxx). Requires the save scope.

NameTypeRequiredDescription

idstringrequiredFullname of the post or comment to save (e.g. t3_xxx or t1_xxx)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_content_sfw#Remove the NSFW (Not Safe For Work) marking from a post. Requires modposts scope; usable by subreddit moderators or by the post's own author.3 params

Remove the NSFW (Not Safe For Work) marking from a post. Requires modposts scope; usable by subreddit moderators or by the post's own author.

NameTypeRequiredDescription

idstringrequiredFullname of the post to unmark NSFW (e.g. t3_xxx)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_content_spoiler#Mark a post as a spoiler. Requires modposts scope; usable by subreddit moderators or by the post's own author.3 params

Mark a post as a spoiler. Requires modposts scope; usable by subreddit moderators or by the post's own author.

NameTypeRequiredDescription

idstringrequiredFullname of the post to mark as spoiler (e.g. t3_xxx)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_content_unlock#Unlock a previously locked post or comment to re-enable replies. Requires modposts scope and moderator access.3 params

Unlock a previously locked post or comment to re-enable replies. Requires modposts scope and moderator access.

NameTypeRequiredDescription

idstringrequiredFullname of the post or comment to unlock (e.g. t3_xxx or t1_xxx)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_content_unsave#Remove a post or comment from the current user's saved list. Accepts the fullname of the post (t3_xxx) or comment (t1_xxx). Requires the save scope.3 params

Remove a post or comment from the current user's saved list. Accepts the fullname of the post (t3_xxx) or comment (t1_xxx). Requires the save scope.

NameTypeRequiredDescription

idstringrequiredFullname of the post or comment to unsave (e.g. t3_xxx or t1_xxx)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_content_unspoiler#Remove the spoiler marking from a post. Requires modposts scope; usable by subreddit moderators or by the post's own author.3 params

Remove the spoiler marking from a post. Requires modposts scope; usable by subreddit moderators or by the post's own author.

NameTypeRequiredDescription

idstringrequiredFullname of the post to unmark as spoiler (e.g. t3_xxx)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_flair_select#Select a flair template for a post (link) or user in a subreddit. Requires flair scope. To set a post's flair, provide link; to set a user's flair, provide name.7 params

Select a flair template for a post (link) or user in a subreddit. Requires flair scope. To set a post's flair, provide link; to set a user's flair, provide name.

NameTypeRequiredDescription

flair_template_idstringrequiredID of the flair template to apply

subredditstringrequiredSubreddit name (without r/ prefix)

linkstringoptionalFullname of the post/link to apply flair to (e.g. t3_abc123). Mutually exclusive with name.

namestringoptionalUsername to set flair for. Mutually exclusive with link.

schema_versionstringoptionalOptional schema version to use for tool execution

textstringoptionalCustom flair text (if allowed by the template)

tool_versionstringoptionalOptional tool version to use for execution

reddit_inbox_get#Get all messages in the current user's inbox, including private messages, comment replies, and post replies. Requires the privatemessages scope.6 params

Get all messages in the current user's inbox, including private messages, comment replies, and post replies. Requires the privatemessages scope.

NameTypeRequiredDescription

afterstringoptionalFullname of the last message for pagination

countintegeroptionalNumber of items already seen for accurate pagination

limitintegeroptionalMaximum number of messages to return (default 25, max 100)

markbooleanoptionalIf true, mark all returned messages as read

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_info_get#Get information about one or more Reddit things (posts, comments, subreddits) by their fullnames (e.g. t3_abc123) or by URL. Requires the read scope.4 params

Get information about one or more Reddit things (posts, comments, subreddits) by their fullnames (e.g. t3_abc123) or by URL. Requires the read scope.

NameTypeRequiredDescription

idstringoptionalComma-separated list of fullnames (e.g. t3_abc123,t1_def456). Use either id or url.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

urlstringoptionalURL of a Reddit post to look up. Use either url or id.

reddit_link_flair_get#Get the list of link flair templates for a subreddit. Requires flair scope and moderator or user access (if user flair is enabled).3 params

Get the list of link flair templates for a subreddit. Requires flair scope and moderator or user access (if user flair is enabled).

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_live_create#Create a new live thread for real-time updates. Requires submit scope.6 params

Create a new live thread for real-time updates. Requires submit scope.

NameTypeRequiredDescription

titlestringrequiredTitle of the live thread

descriptionstringoptionalMarkdown description of the live thread

nsfwbooleanoptionalMark the live thread as NSFW

resourcesstringoptionalMarkdown text for the resources section

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_live_happening_now#Get the currently featured live thread on Reddit, if one is active. Requires read scope.2 params

Get the currently featured live thread on Reddit, if one is active. Requires read scope.

NameTypeRequiredDescription

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_live_thread_get#Get details about a live thread including title, description, state, and viewer count. Requires read scope.3 params

Get details about a live thread including title, description, state, and viewer count. Requires read scope.

NameTypeRequiredDescription

threadstringrequiredID of the live thread

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_live_update_post#Post a new update to an active live thread. Requires submit scope and contributor access to the live thread.4 params

Post a new update to an active live thread. Requires submit scope and contributor access to the live thread.

NameTypeRequiredDescription

bodystringrequiredMarkdown content of the update

threadstringrequiredID of the live thread to post to

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_live_updates_get#Get a listing of updates posted to a live thread. Requires read scope.5 params

Get a listing of updates posted to a live thread. Requires read scope.

NameTypeRequiredDescription

threadstringrequiredID of the live thread

afterstringoptionalFullname of the last update for pagination

limitintegeroptionalMaximum number of updates to return (default 25, max 100)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_me_friends_get#Get the list of users the current Reddit user has added as friends. Returns friend username, ID, and date added. This is a flat list, not paginated. Requires the read scope.2 params

Get the list of users the current Reddit user has added as friends. Returns friend username, ID, and date added. This is a flat list, not paginated. Requires the read scope.

NameTypeRequiredDescription

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_me_get#Get the identity of the currently authenticated Reddit user. Returns username, karma, account age, and other profile info. Requires the identity scope.2 params

Get the identity of the currently authenticated Reddit user. Returns username, karma, account age, and other profile info. Requires the identity scope.

NameTypeRequiredDescription

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_me_karma_get#Get the karma breakdown for the current user, showing link karma and comment karma per subreddit. Requires the mysubreddits scope.2 params

Get the karma breakdown for the current user, showing link karma and comment karma per subreddit. Requires the mysubreddits scope.

NameTypeRequiredDescription

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_me_prefs_get#Get the preference settings for the current Reddit user, including content preferences, notification settings, and display options. Requires the identity scope.2 params

Get the preference settings for the current Reddit user, including content preferences, notification settings, and display options. Requires the identity scope.

NameTypeRequiredDescription

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_me_prefs_update#Update the authenticated user's account preferences such as language, over_18, show_trending, and other settings. Requires the account scope, which is not currently offered by this connector's OAuth consent (pending Reddit app approval) -- this tool will fail with a permissions error until that's granted.11 params

Update the authenticated user's account preferences such as language, over_18, show_trending, and other settings. Requires the account scope, which is not currently offered by this connector's OAuth consent (pending Reddit app approval) -- this tool will fail with a permissions error until that's granted.

NameTypeRequiredDescription

accept_pmsstringoptionalWho can send private messages: everyone or whitelisted

activity_relevant_adsbooleanoptionalAllow Reddit to use activity for personalized ads

betabooleanoptionalOpt in to beta features

country_codestringoptionalTwo-letter country code for location

email_messagesbooleanoptionalReceive email notifications for private messages

langstringoptionalLanguage preference (IETF language tag, e.g. en, fr)

over_18booleanoptionalEnable viewing NSFW content

schema_versionstringoptionalOptional schema version to use for tool execution

search_include_over_18booleanoptionalInclude NSFW results in search

show_trendingbooleanoptionalShow trending subreddits on the front page

tool_versionstringoptionalOptional tool version to use for execution

reddit_me_trophies_get#Get the list of trophies (awards) earned by the current Reddit user. Requires the identity scope.2 params

Get the list of trophies (awards) earned by the current Reddit user. Requires the identity scope.

NameTypeRequiredDescription

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_message_compose#Send a private message to a Reddit user or subreddit. Requires the privatemessages scope.5 params

Send a private message to a Reddit user or subreddit. Requires the privatemessages scope.

NameTypeRequiredDescription

subjectstringrequiredSubject of the message (max 100 characters)

textstringrequiredBody of the message in Markdown

tostringrequiredUsername or subreddit to send the message to (e.g. username or /r/subreddit)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_message_read#Mark one or more messages as read by their fullnames (t4_xxx), comma-separated. Requires the privatemessages scope.3 params

Mark one or more messages as read by their fullnames (t4_xxx), comma-separated. Requires the privatemessages scope.

NameTypeRequiredDescription

idstringrequiredComma-separated list of message fullnames to mark as read (e.g. t4_abc123,t4_def456)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_messages_read_all#Mark all messages in the current user's inbox as read. Requires the privatemessages scope.2 params

Mark all messages in the current user's inbox as read. Requires the privatemessages scope.

NameTypeRequiredDescription

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_mod_edited_get#Get posts and comments that have been edited, for moderator review. Requires read scope and moderator access.6 params

Get posts and comments that have been edited, for moderator review. Requires read scope and moderator access.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix)

afterstringoptionalFullname of the last item for pagination

limitintegeroptionalMaximum number of items to return (default 25, max 100)

onlystringoptionalFilter by type: links or comments

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_mod_invite_accept#Accept an invitation to become a moderator of a subreddit. Requires the modself scope, which is not currently offered by this connector's OAuth consent (Reddit gates moderator-level API access per-app; pending approval) -- this tool will fail with a permissions error until that's granted.3 params

Accept an invitation to become a moderator of a subreddit. Requires the modself scope, which is not currently offered by this connector's OAuth consent (Reddit gates moderator-level API access per-app; pending approval) -- this tool will fail with a permissions error until that's granted.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix) to accept the mod invite for

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_mod_leave#Abdicate moderator status in a subreddit. Requires the subreddit fullname (e.g. t5_abc123), obtainable from reddit_subreddit_about. Requires the modself scope, which is not currently offered by this connector's OAuth consent (Reddit gates moderator-level API access per-app; pending approval) -- this tool will fail with a permissions error until that's granted.3 params

Abdicate moderator status in a subreddit. Requires the subreddit fullname (e.g. t5_abc123), obtainable from reddit_subreddit_about. Requires the modself scope, which is not currently offered by this connector's OAuth consent (Reddit gates moderator-level API access per-app; pending approval) -- this tool will fail with a permissions error until that's granted.

NameTypeRequiredDescription

idstringrequiredFullname of the subreddit to leave moderatorship of (e.g. t5_abc123). Get from reddit_subreddit_about.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_mod_log_get#Get the moderation action log for a subreddit. Optionally filter by moderator or action type. Requires modlog scope and moderator access.7 params

Get the moderation action log for a subreddit. Optionally filter by moderator or action type. Requires modlog scope and moderator access.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix)

actionstringoptionalFilter by action type (e.g. banuser, removelink, approvecomment)

afterstringoptionalFullname of the last log entry for pagination

limitintegeroptionalMaximum number of entries to return (default 25, max 500)

modstringoptionalFilter by moderator username (without u/ prefix)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_mod_reports_get#Get reported posts and comments in a subreddit awaiting moderator action. Requires the read scope and moderator access.7 params

Get reported posts and comments in a subreddit awaiting moderator action. Requires the read scope and moderator access.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix)

afterstringoptionalFullname of the last item for pagination

countintegeroptionalNumber of items already seen for accurate pagination

limitintegeroptionalMaximum number of items to return (default 25, max 100)

onlystringoptionalFilter by type: links (posts only) or comments (comments only)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_mod_spam_get#Get posts and comments that have been caught by spam filters in a subreddit. Requires read scope and moderator access.6 params

Get posts and comments that have been caught by spam filters in a subreddit. Requires read scope and moderator access.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix)

afterstringoptionalFullname of the last item for pagination

limitintegeroptionalMaximum number of items to return (default 25, max 100)

onlystringoptionalFilter by type: links or comments

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_mod_unmoderated_get#Get posts that haven't been moderated yet. Requires read scope and moderator access.5 params

Get posts that haven't been moderated yet. Requires read scope and moderator access.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix)

afterstringoptionalFullname of the last item for pagination

limitintegeroptionalMaximum number of items to return (default 25, max 100)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_modmail_conversation_create#Create a new modmail conversation with a user. Requires modmail scope and moderator access; modmail is not currently offered by this connector's OAuth consent (Reddit gates moderator-level API access per-app; pending approval) -- this tool will fail with a permissions error until that's granted.7 params

Create a new modmail conversation with a user. Requires modmail scope and moderator access; modmail is not currently offered by this connector's OAuth consent (Reddit gates moderator-level API access per-app; pending approval) -- this tool will fail with a permissions error until that's granted.

NameTypeRequiredDescription

bodystringrequiredMarkdown body of the initial message

sr_namestringrequiredSubreddit name (without r/ prefix) to send the message from

subjectstringrequiredSubject line of the modmail conversation

tostringrequiredUsername of the recipient

is_author_hiddenbooleanoptionalHide the moderator's identity from the user

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_modmail_conversation_get#Get a single modmail conversation by ID including all messages and actions. Requires modmail scope and moderator access; modmail is not currently offered by this connector's OAuth consent (Reddit gates moderator-level API access per-app; pending approval) -- this tool will fail with a permissions error until that's granted.4 params

Get a single modmail conversation by ID including all messages and actions. Requires modmail scope and moderator access; modmail is not currently offered by this connector's OAuth consent (Reddit gates moderator-level API access per-app; pending approval) -- this tool will fail with a permissions error until that's granted.

NameTypeRequiredDescription

conversation_idstringrequiredID of the modmail conversation

mark_readbooleanoptionalWhether to mark the conversation as read when fetching

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_modmail_conversation_reply#Reply to an existing modmail conversation. Requires modmail scope and moderator access; modmail is not currently offered by this connector's OAuth consent (Reddit gates moderator-level API access per-app; pending approval) -- this tool will fail with a permissions error until that's granted.6 params

Reply to an existing modmail conversation. Requires modmail scope and moderator access; modmail is not currently offered by this connector's OAuth consent (Reddit gates moderator-level API access per-app; pending approval) -- this tool will fail with a permissions error until that's granted.

NameTypeRequiredDescription

bodystringrequiredMarkdown body of the reply

conversation_idstringrequiredID of the modmail conversation to reply to

is_author_hiddenbooleanoptionalHide the moderator's identity from the user

is_internalbooleanoptionalSend as an internal moderator note (not visible to the user)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_modmail_conversations_get#Get a list of modmail conversations for a subreddit. Requires modmail scope and moderator access; modmail is not currently offered by this connector's OAuth consent (Reddit gates moderator-level API access per-app; pending approval) -- this tool will fail with a permissions error until that's granted.7 params

Get a list of modmail conversations for a subreddit. Requires modmail scope and moderator access; modmail is not currently offered by this connector's OAuth consent (Reddit gates moderator-level API access per-app; pending approval) -- this tool will fail with a permissions error until that's granted.

NameTypeRequiredDescription

afterstringoptionalPagination cursor (conversation ID) to fetch conversations after

entitystringoptionalComma-separated list of subreddit names to filter conversations (without r/ prefix)

limitintegeroptionalMaximum number of conversations to return (default 25, max 100)

schema_versionstringoptionalOptional schema version to use for tool execution

sortstringoptionalSort order: recent, mod, user, unread

statestringoptionalFilter by conversation state: new, inprogress, mod, notifications, archived, appeals, highlighted, all

tool_versionstringoptionalOptional tool version to use for execution

reddit_modqueue_get#Get the moderation queue for a subreddit, containing posts and comments that need moderator review. Requires the read scope and moderator access.7 params

Get the moderation queue for a subreddit, containing posts and comments that need moderator review. Requires the read scope and moderator access.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix)

afterstringoptionalFullname of the last item for pagination

countintegeroptionalNumber of items already seen for accurate pagination

limitintegeroptionalMaximum number of items to return (default 25, max 100)

onlystringoptionalFilter by type: links (posts only) or comments (comments only). Omit for both.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_more_comments_get#Retrieve additional comments from a comment tree that were collapsed as 'load more comments'. Used to expand comment threads beyond the initial load. Requires read scope.8 params

Retrieve additional comments from a comment tree that were collapsed as 'load more comments'. Used to expand comment threads beyond the initial load. Requires read scope.

NameTypeRequiredDescription

childrenstringrequiredComma-separated list of comment IDs (without t1_ prefix) to expand

link_idstringrequiredFullname of the post/link containing the comments (e.g. t3_abc123)

depthintegeroptionalMaximum depth of subtrees in the returned listing

idstringoptionalFullname of the 'more' comment object (e.g. t1_abc123)

limit_childrenbooleanoptionalOnly return the children requested, not their subtrees

schema_versionstringoptionalOptional schema version to use for tool execution

sortstringoptionalSort order for comments: confidence, top, new, controversial, old, random, qa

tool_versionstringoptionalOptional tool version to use for execution

reddit_multi_create#Create a new multireddit for the authenticated user. Requires subscribe scope.8 params

Create a new multireddit for the authenticated user. Requires subscribe scope.

NameTypeRequiredDescription

multinamestringrequiredURL-safe name for the multireddit (lowercase letters, numbers, underscores)

usernamestringrequiredUsername of the authenticated user (owner of the multireddit)

description_mdstringoptionalMarkdown description of the multireddit

display_namestringoptionalHuman-readable display name for the multireddit

schema_versionstringoptionalOptional schema version to use for tool execution

subredditsstringoptionalComma-separated list of subreddit names to include

tool_versionstringoptionalOptional tool version to use for execution

visibilitystringoptionalVisibility of the multireddit: public, private, or hidden

reddit_multi_delete#Delete a multireddit owned by the authenticated user. Requires subscribe scope.4 params

Delete a multireddit owned by the authenticated user. Requires subscribe scope.

NameTypeRequiredDescription

multinamestringrequiredName of the multireddit to delete

usernamestringrequiredOwner's Reddit username

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_multi_get#Get information about a multireddit by its path. The multipath is in the format /user/{username}/m/{multiname}. Requires read scope.5 params

Get information about a multireddit by its path. The multipath is in the format /user/{username}/m/{multiname}. Requires read scope.

NameTypeRequiredDescription

multinamestringrequiredName of the multireddit

usernamestringrequiredOwner's Reddit username

expand_srsbooleanoptionalExpand subreddit objects in the response

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_multi_subreddit_add#Add a subreddit to an existing multireddit. Requires subscribe scope.5 params

Add a subreddit to an existing multireddit. Requires subscribe scope.

NameTypeRequiredDescription

multinamestringrequiredName of the multireddit to add to

srnamestringrequiredName of the subreddit to add (without r/ prefix)

usernamestringrequiredOwner's Reddit username

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_multi_subreddit_remove#Remove a subreddit from an existing multireddit. Requires subscribe scope.5 params

Remove a subreddit from an existing multireddit. Requires subscribe scope.

NameTypeRequiredDescription

multinamestringrequiredName of the multireddit to remove from

srnamestringrequiredName of the subreddit to remove (without r/ prefix)

usernamestringrequiredOwner's Reddit username

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_multis_mine#Get the list of multireddits owned by the authenticated user. Requires read scope.3 params

Get the list of multireddits owned by the authenticated user. Requires read scope.

NameTypeRequiredDescription

expand_srsbooleanoptionalExpand subreddit objects in the response

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_post_comments_get#Get the comment tree for a specific post. Returns the post and its comments. Requires read scope.9 params

Get the comment tree for a specific post. Returns the post and its comments. Requires read scope.

NameTypeRequiredDescription

post_idstringrequiredThe base36 ID of the post (without t3_ prefix)

subredditstringrequiredSubreddit name (without r/ prefix)

commentstringoptionalThe base36 ID of a specific comment to focus on (without t1_ prefix)

contextintegeroptionalNumber of parent comments to include when focusing on a specific comment (0-8)

depthintegeroptionalMaximum depth of comment subtrees to return

limitintegeroptionalMaximum number of comments to return

schema_versionstringoptionalOptional schema version to use for tool execution

sortstringoptionalSort order for comments: confidence, top, new, controversial, old, random, qa, live

tool_versionstringoptionalOptional tool version to use for execution

reddit_post_hide#Hide a post from the current user's default view. Hidden posts are moved to /hidden. Accepts one or more post fullnames (t3_xxx), comma-separated. Requires the report scope.3 params

Hide a post from the current user's default view. Hidden posts are moved to /hidden. Accepts one or more post fullnames (t3_xxx), comma-separated. Requires the report scope.

NameTypeRequiredDescription

idstringrequiredComma-separated list of post fullnames to hide (e.g. t3_abc123,t3_def456)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_post_requirements#Get the submission requirements and restrictions for a subreddit, including title length, body length, flair requirements, and post type restrictions. Requires read scope.3 params

Get the submission requirements and restrictions for a subreddit, including title length, body length, flair requirements, and post type restrictions. Requires read scope.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_post_submit#Submit a new post to a subreddit. Supports self (text) posts, link posts, and crossposts. Returns the new post URL and ID. Requires the submit scope.11 params

Submit a new post to a subreddit. Supports self (text) posts, link posts, and crossposts. Returns the new post URL and ID. Requires the submit scope.

NameTypeRequiredDescription

kindstringrequiredType of post: self (text), link, or crosspost

srstringrequiredSubreddit name to post to (without r/ prefix)

titlestringrequiredTitle of the post (max 300 characters)

crosspost_fullnamestringoptionalFullname of the post to crosspost (required when kind=crosspost)

nsfwbooleanoptionalMark the post as NSFW (not safe for work)

schema_versionstringoptionalOptional schema version to use for tool execution

sendrepliesbooleanoptionalSend reply notifications to the user's inbox

spoilerbooleanoptionalMark the post as a spoiler

textstringoptionalBody text in Markdown for self posts (required when kind=self)

tool_versionstringoptionalOptional tool version to use for execution

urlstringoptionalURL to link to (required when kind=link)

reddit_post_unhide#Unhide a previously hidden post so it appears in the user's default view again. Accepts one or more post fullnames (t3_xxx), comma-separated. Requires the report scope.3 params

Unhide a previously hidden post so it appears in the user's default view again. Accepts one or more post fullnames (t3_xxx), comma-separated. Requires the report scope.

NameTypeRequiredDescription

idstringrequiredComma-separated list of post fullnames to unhide (e.g. t3_abc123,t3_def456)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_search#Search Reddit for posts, subreddits, or users matching a query. Supports sorting by relevance, new, hot, top, or comments, and time filtering. Requires the read scope.10 params

Search Reddit for posts, subreddits, or users matching a query. Supports sorting by relevance, new, hot, top, or comments, and time filtering. Requires the read scope.

NameTypeRequiredDescription

qstringrequiredSearch query string

afterstringoptionalFullname of the last result for pagination

beforestringoptionalFullname of the first result for reverse pagination

countintegeroptionalNumber of items already seen for accurate pagination

limitintegeroptionalMaximum number of results to return (default 25, max 100)

schema_versionstringoptionalOptional schema version to use for tool execution

sortstringoptionalSort order: relevance, new, hot, top, comments (default relevance)

tstringoptionalTime filter when sort=top: hour, day, week, month, year, all

tool_versionstringoptionalOptional tool version to use for execution

typestringoptionalComma-separated result types: link, sr, user (default link)

reddit_sent_get#Get private messages sent by the current user. Requires the privatemessages scope.5 params

Get private messages sent by the current user. Requires the privatemessages scope.

NameTypeRequiredDescription

afterstringoptionalFullname of the last message for pagination

countintegeroptionalNumber of items already seen for accurate pagination

limitintegeroptionalMaximum number of messages to return (default 25, max 100)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_subreddit_about#Get metadata about a subreddit including description, subscriber count, rules, creation date, and settings. Requires the read scope.3 params

Get metadata about a subreddit including description, subscriber count, rules, creation date, and settings. Requires the read scope.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_subreddit_banned#Get the list of users banned from a subreddit, including ban reason and duration. Requires read scope and moderator access.6 params

Get the list of users banned from a subreddit, including ban reason and duration. Requires read scope and moderator access.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix)

afterstringoptionalFullname cursor for pagination

limitintegeroptionalMaximum number of users to return (default 25, max 100)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

userstringoptionalFilter by username to check if a specific user is banned

reddit_subreddit_contributors#Get the list of approved submitters (contributors) for a subreddit. Requires read scope and moderator access.6 params

Get the list of approved submitters (contributors) for a subreddit. Requires read scope and moderator access.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix)

afterstringoptionalFullname cursor for pagination

limitintegeroptionalMaximum number of users to return (default 25, max 100)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

userstringoptionalFilter by username to check if a specific user is a contributor

reddit_subreddit_controversial#Get controversial posts from a subreddit filtered by time period. Requires the read scope.8 params

Get controversial posts from a subreddit filtered by time period. Requires the read scope.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix). Use 'all' for all of Reddit.

afterstringoptionalFullname of the last post for pagination

beforestringoptionalFullname of the first post for reverse pagination

countintegeroptionalNumber of items already seen for accurate pagination

limitintegeroptionalMaximum number of posts to return (default 25, max 100)

schema_versionstringoptionalOptional schema version to use for tool execution

tstringoptionalTime period filter: hour, day, week, month, year, all (default all)

tool_versionstringoptionalOptional tool version to use for execution

reddit_subreddit_hot#Get the hot posts from a subreddit, sorted by upvotes and recency. Use 'all' as the subreddit to get posts from across Reddit. Requires the read scope.7 params

Get the hot posts from a subreddit, sorted by upvotes and recency. Use 'all' as the subreddit to get posts from across Reddit. Requires the read scope.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix). Use 'all' for all of Reddit.

afterstringoptionalFullname of the last post in the previous page for pagination

beforestringoptionalFullname of the first post in the previous page for pagination

countintegeroptionalNumber of items already seen for accurate pagination

limitintegeroptionalMaximum number of posts to return (default 25, max 100)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_subreddit_moderators#Get the list of moderators for a subreddit with their permissions and mod date. Requires the read scope.3 params

Get the list of moderators for a subreddit with their permissions and mod date. Requires the read scope.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_subreddit_muted#Get the list of users muted in a subreddit. Requires read scope and moderator access.6 params

Get the list of users muted in a subreddit. Requires read scope and moderator access.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix)

afterstringoptionalFullname cursor for pagination

limitintegeroptionalMaximum number of users to return (default 25, max 100)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

userstringoptionalFilter by username to check if a specific user is muted

reddit_subreddit_new#Get the newest posts from a subreddit, sorted by submission time. Use 'all' as the subreddit to get new posts from across Reddit. Requires the read scope.7 params

Get the newest posts from a subreddit, sorted by submission time. Use 'all' as the subreddit to get new posts from across Reddit. Requires the read scope.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix). Use 'all' for all of Reddit.

afterstringoptionalFullname of the last post for pagination

beforestringoptionalFullname of the first post for reverse pagination

countintegeroptionalNumber of items already seen for accurate pagination

limitintegeroptionalMaximum number of posts to return (default 25, max 100)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_subreddit_rising#Get the rising posts from a subreddit — posts gaining momentum with recent upvotes. Requires the read scope.7 params

Get the rising posts from a subreddit — posts gaining momentum with recent upvotes. Requires the read scope.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix)

afterstringoptionalFullname of the last post for pagination

beforestringoptionalFullname of the first post for reverse pagination

countintegeroptionalNumber of items already seen for accurate pagination

limitintegeroptionalMaximum number of posts to return (default 25, max 100)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_subreddit_rules#Get the rules of a subreddit, including short name, full description, and whether the rule applies to links or comments. Requires the read scope.3 params

Get the rules of a subreddit, including short name, full description, and whether the rule applies to links or comments. Requires the read scope.

NameTypeRequiredDescription

subredditstringrequiredSubreddit name (without r/ prefix)

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

reddit_subreddit_search#Search for posts within a specific subreddit. Equivalent to using the search bar within a subreddit. Requires the read scope.10 params

Search for posts within a specific subreddit. Equivalent to using the search bar within a subreddit. Requires the read scope.

NameTypeRequiredDescription

qstringrequiredSearch query string

subredditstringrequiredSubreddit name to search within (without r/ prefix)