{"report":{"v":1,"package":"reddit-mcp-server","version":"2.0.2","ranAt":"2026-11-16T11:38:50.957Z","install":{"ok":true,"integrity":"sha512-/Gypdip2KE9HvKhftX0JCuMNc9sjlT3qUQo7A29kYv+L0Cn8CQZgYxJQwr0azrNtb66IwsFuZjpkhC+e9IiagA==","deps":34,"scripts":[],"bins":["reddit-mcp-server"],"license":"MIT","repository":"git+https://github.com/jordanburke/reddit-mcp-server.git","bin":"reddit-mcp-server"},"start":{"ok":true,"ms":266,"serverName":"reddit-mcp-server","serverVersion":"2.0.2","protocol":"2025-06-18","stderr":"[Setup] No REDDIT_USERNAME set — using anonymous User-Agent. Set REDDIT_USERNAME for a personalized agent.\n[Setup] Reddit client initialized\n[Setup] Authentication mode: auto\n[Setup] Keyless mode — no OAuth credentials detected.\n[Setup] Reads come from RSS feeds (ranked listings; Reddit said it would end them 2026-11-13)\n[Setup] and the Arctic Shift archive (a free third-party Reddit archive; scores lag).\n[Setup] Existing REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET still give live data (60-100 req/min).\n[Setup] Reddit takes no new API access requests and closes its public API in March 2027.\n[Setup] See: https://github.com/jordanburke/reddit-mcp-server#reddit-is-closing-its-public-api\n[Setup] Read-only mode (no user credentials)\n[Setup] For write operations, set REDDIT_USERNAME and REDDIT_PASSWORD\n[Setup] ✓ Safe mode enabled: standard\n[Setup]   - Write delay: 2000ms between operations\n[Setup]   - Duplicate detection: enabled (tracking last 10 items)\n[Setup] Bot disclosure: off\n[Setup] For Reddit policy compliance, consider REDDIT_BOT_DISCLOSURE=auto\n[Setup] Starting in stdio mode\n"},"tools":[{"name":"test_reddit_mcp_server","description":"Health check for the Reddit MCP server. Read-only and side-effect-free — inspects local configuration only and makes no Reddit API calls. Returns the server version, whether the Reddit client is initialized, whether OAuth credentials are present, and whether write access (REDDIT_USERNAME/REDDIT_PASSWORD) is configured. Use this first to diagnose setup/auth problems. Do NOT use it to check Reddit's own status or connectivity — it never contacts Reddit. A \"✗ Write Access\" result means the write tools (create_post, reply_to_post, edit_*, delete_*) will fail.","params":[]},{"name":"get_user_info","description":"Get a public profile for any Reddit user: comment/post/total karma, account age and status flags, plus a short activity analysis and engagement tips. Read-only; works without credentials via the Arctic Shift archive (scores lag). Returns profile stats only — use get_user_posts / get_user_comments for their actual content. Use get_me instead for your own authenticated account; do NOT expect private fields here, as only public data is returned.","params":["username"]},{"name":"get_me","description":"Get the authenticated user's own profile (karma, account age, status flags). Read-only, but requires user credentials (REDDIT_USERNAME/REDDIT_PASSWORD) and fails without user credentials. Use this instead of get_user_info when you need the current account rather than an arbitrary user. Do NOT use it to look up other users — it always returns the logged-in account.","params":[]},{"name":"get_my_overview","description":"Get the authenticated user's own recent activity — posts and comments interleaved, newest first. Read-only but requires user credentials (REDDIT_USERNAME/REDDIT_PASSWORD). Returns up to `limit` items plus an `after` cursor for the next page. Use get_my_saved for saved items, or get_user_posts / get_user_comments for another user. Do NOT use this to fetch a specific post's thread — use get_post_comments.","params":["limit","after"]},{"name":"get_my_saved","description":"Get the authenticated user's saved posts and comments (private to the account). Read-only but requires user credentials (REDDIT_USERNAME/REDDIT_PASSWORD). Returns up to `limit` items plus an `after` pagination cursor. Use get_my_overview for your authored activity. Do NOT use this for another user — saved items are private and have no cross-user equivalent.","params":["limit","after"]},{"name":"get_user_posts","description":"Get posts submitted by a specific user, with sort (new/hot/top) and time filter. Read-only; works without credentials via the Arctic Shift archive, newest first and without scores or comment counts. Returns a page of posts (title, subreddit, score, upvote ratio, comment count, permalink) plus an `after` cursor for paging. Use get_user_comments for their comments, or get_user_info for karma/profile stats. Do NOT use this to search a subreddit — use search_reddit or browse_subreddit.","params":["username","sort","time_filter","limit","after"]},{"name":"get_user_comments","description":"Get comments made by a specific user, with sort (new/hot/top) and time filter. Read-only; works without credentials via the Arctic Shift archive, newest first and without scores. Returns a page of comments (subreddit, parent post title, body excerpt, score, permalink) plus an `after` cursor. Use get_user_posts for their submissions, or get_user_info for karma/profile stats. Do NOT use this to read one post's thread — use get_post_comments.","params":["username","sort","time_filter","limit","after"]},{"name":"get_reddit_post","description":"Get a single post by subreddit + post id: title, author, self-text or link content, score, upvote ratio, comment count, flair/flags, and an engagement analysis. Read-only; works without credentials via the Arctic Shift archive, which omits the score, upvote ratio, comment count and engagement analysis. Returns the post only — use get_post_comments for its comment thread. Do NOT use this to list a subreddit's posts (use browse_subreddit / get_top_posts) or to find posts by keyword (use search_reddit).","params":["subreddit","post_id"]},{"name":"get_top_posts","description":"Get the top-scoring posts from a subreddit — or from the authenticated home feed if no subreddit is given — within a time window (hour…all). Read-only; works without credentials via RSS (titles and links only, no scores); if RSS fails, it falls back to the Arctic Shift archive's newest posts, which have no ranking. Returns a page of posts plus an `after` cursor. This is a shortcut for the 'top' sort; use browse_subreddit for hot/new/rising/controversial, or search_reddit to find posts by keyword.","params":["subreddit","time_filter","limit","after"]},{"name":"browse_subreddit","description":"Browse a subreddit — or the authenticated home feed when no subreddit is given — by sort order: hot, new, top, rising, or controversial. Read-only; works without credentials via RSS (titles and links only, no scores); if RSS fails, it falls back to the Arctic Shift archive's newest posts, which have no ranking. `time_filter` applies only to the top and controversial sorts. Returns a page of posts plus an `after` cursor. Use get_top_posts as a shortcut for the top sort, or search_reddit to find posts by keyword rather than by feed order.","params":["subreddit","sort","time_filter","limit","after"]},{"name":"get_subreddit_info","description":"Get a subreddit's profile: title, description, subscriber and active-user counts, creation date, flags, wiki/link URLs, plus a community analysis and posting tips. Read-only; works without credentials via the Arctic Shift archive (scores lag). Returns metadata about the community itself — use browse_subreddit / get_top_posts for its posts, or get_subreddit_rules for its posting rules. Do NOT use this to find subreddits by topic — use search_reddit with type='sr'.","params":["subreddit_name"]},{"name":"get_subreddit_rules","description":"Get a subreddit's posting rules (each rule's name, what it applies to, and its description). Read-only; works without credentials via the Arctic Shift archive (scores lag). Returns the rules list, or a note when the subreddit lists none. Call this before create_post to check requirements and avoid auto-removal. For available post flairs use get_post_flairs instead.","params":["subreddit_name"]},{"name":"get_post_flairs","description":"List a subreddit's selectable link flairs (flair text + flair_id) for use with create_post. Read-only, but requires user credentials; many subreddits expose flairs only to members, so this can 403 or return empty without credentials. Pass a returned flair_id (and flair_text for text-editable flairs) to create_post. For the subreddit's posting rules use get_subreddit_rules instead.","params":["subreddit_name"]},{"name":"get_trending_subreddits","description":"Get the subreddits Reddit is currently featuring as trending/popular. Read-only, no parameters; requires OAuth credentials. Returns a list of subreddit names that changes through the day (cached briefly server-side). To find subreddits by keyword instead of by trend, use search_reddit with type='sr'.","params":[]},{"name":"search_reddit","description":"Search Reddit for posts — or subreddits/users via `type` — optionally scoped to one subreddit, with sort and time filters. Read-only. Without credentials it uses the Arctic Shift archive, which needs `subreddit` for post search, matches subreddit names by prefix, cannot search users, and omits scores and comment counts. Returns a page of results (title, subreddit, author, score, comments, link) plus an `after` cursor for paging. Use this to find content by keyword; use browse_subreddit / get_top_posts to list a known subreddit's feed instead.","params":["query","subreddit","sort","time_filter","limit","type","after"]},{"name":"create_post","description":"Create a new text or link post in a subreddit. Mutating and NOT idempotent — each call publishes a separate post. Requires REDDIT_USERNAME and REDDIT_PASSWORD; fails without them. Returns the new post's id and URL. Check get_subreddit_rules and get_post_flairs first, since many subreddits require a flair or reject certain content. WARNING: rapid posting or duplicate content may trigger Reddit's spam detection and account bans — enable REDDIT_SAFE_MODE=standard for rate limiting and duplicate detection.","params":["subreddit","title","content","is_self","flair_id","flair_text"]},{"name":"reply_to_post","description":"Post a reply to an existing post or comment. Mutating and NOT idempotent — each call adds a new comment. Requires REDDIT_USERNAME and REDDIT_PASSWORD. The parent is identified by its thing id — t3_ for a post, t1_ for a comment — so this creates both top-level and nested replies. Returns the new comment's id. Use edit_comment to change a reply you already posted. WARNING: rapid or duplicate replies may trigger Reddit's spam detection; enable REDDIT_SAFE_MODE=standard for rate limiting and duplicate detection.","params":["post_id","content"]},{"name":"delete_post","description":"Permanently delete one of your own posts. Mutating and destructive but idempotent — deleting an already-deleted post is a no-op. Requires REDDIT_USERNAME and REDDIT_PASSWORD, and only works on posts authored by the authenticated account. Only affects the post you name; use delete_comment for comments. WARNING: this cannot be undone — the content is removed, though the post id remains.","params":["thing_id"]},{"name":"delete_comment","description":"Permanently delete one of your own comments. Mutating and destructive but idempotent — deleting an already-deleted comment is a no-op. Requires REDDIT_USERNAME and REDDIT_PASSWORD, and only works on comments authored by the authenticated account. Only affects the comment you name; use delete_post for posts. WARNING: this cannot be undone — the content is removed, though the comment id remains.","params":["thing_id"]},{"name":"edit_post","description":"Replace the body text of one of your own self-text posts. Mutating and idempotent (same text → same result); it overwrites the previous body. Requires REDDIT_USERNAME and REDDIT_PASSWORD, and works only on self posts you authored — titles and link posts cannot be edited. Adds an \"edited\" marker. Use create_post to make a new post, or edit_comment for comments. WARNING: rapid edits may trigger spam detection; enable REDDIT_SAFE_MODE for protection.","params":["thing_id","new_text"]},{"name":"edit_comment","description":"Replace the text of one of your own comments. Mutating and idempotent (same text → same result); it overwrites the previous content. Requires REDDIT_USERNAME and REDDIT_PASSWORD, and works only on comments you authored. Adds an \"edited\" marker. Use reply_to_post to add a new comment, or edit_post for posts. WARNING: rapid edits may trigger spam detection; enable REDDIT_SAFE_MODE for protection.","params":["thing_id","new_text"]},{"name":"save_content","description":"Save a post or comment to your account (a private bookmark, listed by get_my_saved). Mutating but idempotent — saving an already-saved item is a no-op. Requires REDDIT_USERNAME and REDDIT_PASSWORD; works on any post/comment you can see, not just your own. Accepts a full thing id (t3_ for a post, t1_ for a comment) — a bare id is treated as a post. Use unsave_content to undo.","params":["thing_id","category"]},{"name":"unsave_content","description":"Remove a post or comment from your saved items (undoes save_content). Mutating but idempotent — unsaving an item that isn't saved is a no-op. Requires REDDIT_USERNAME and REDDIT_PASSWORD. Accepts a full thing id (t3_ for a post, t1_ for a comment) — a bare id is treated as a post.","params":["thing_id"]},{"name":"get_post_comments","description":"Get the comment thread for a post (by post id + subreddit), sorted best/top/new/controversial/old/qa. Read-only; works without credentials via the Arctic Shift archive (scores lag). Returns the post header plus threaded comments (author, OP/edited badges, score, body, nesting depth) up to `limit`. Long threads are truncated with 'load more' stubs — expand those with get_more_comments. Use get_reddit_post for just the post body, not the thread.","params":["post_id","subreddit","sort","limit"]},{"name":"get_more_comments","description":"Expand truncated 'load more comments' stubs in a thread. Read-only; works without credentials via the Arctic Shift archive (scores lag). Pass the post's link id and the comment ids from a 'more' node (surfaced by get_post_comments) to fetch those hidden comments; returns the expanded comments (author, body excerpt, score, link). Call get_post_comments first to obtain the thread and its 'more' node ids — do NOT invent ids.","params":["link_id","comment_ids"]}],"toolsHash":"c91e004fba5446b10e6a0a0aa24e548d327f18752d900394d7cbbbd68e402312","wrote":[],"callsAt":"2026-11-16T11:38:57.132Z","calls":[{"tool":"get_me","ok":false,"ms":5,"bytes":0,"error":"tool reported an error: Failed to get authenticated user: get_me requires OAuth credentials (REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET). Keyless mode (RSS feeds and the Arctic Shift archive) cannot provide it."},{"tool":"get_my_overview","ok":false,"ms":2,"bytes":0,"error":"tool reported an error: Failed to get your overview: get_my_overview requires OAuth credentials (REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET). Keyless mode (RSS feeds and the Arctic Shift archive) cannot provide it."},{"tool":"get_my_saved","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: Failed to get saved content: get_my_saved requires OAuth credentials (REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET). Keyless mode (RSS feeds and the Arctic Shift archive) cannot provide it."},{"tool":"get_top_posts","ok":true,"ms":441,"bytes":1616},{"tool":"get_trending_subreddits","ok":false,"ms":2,"bytes":0,"error":"tool reported an error: Failed to get trending subreddits: get_trending_subreddits requires OAuth credentials (REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET). Keyless mode (RSS feeds and the Arctic Shift archive) cannot provide "}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":["www.reddit.com"],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":25,"wrote":0,"callsTried":5,"callsAnswered":1,"callContacts":["www.reddit.com"]},"history":[{"package":"reddit-mcp-server","version":"2.0.2","ranAt":"2026-11-16T11:38:50.957Z","outcome":"started","tools":25,"contacts":0,"flags":0,"serious":0,"toolsHash":"c91e004fba5446b10e6a0a0aa24e548d327f18752d900394d7cbbbd68e402312"},{"package":"reddit-mcp-server","version":"2.0.1","ranAt":"2026-11-12T17:53:13.334Z","outcome":"started","tools":25,"contacts":0,"flags":0,"serious":0,"toolsHash":"c91e004fba5446b10e6a0a0aa24e548d327f18752d900394d7cbbbd68e402312"}],"page":"https://bragproof.smaverk.com/r/reddit-mcp-server"}