NewAnswers MCP: one question, one checked answer for your agent.See how it works

Guides

Reddit MCP server and search API: connecting Reddit to Claude, Cursor and ChatGPT

By , founder of HyperresearchPublished

You connect Reddit to Claude, Cursor or another AI assistant with a Reddit MCP server, which needs the client ID and secret of a Reddit API app, or by calling Reddit’s search endpoint yourself with the same credentials. Reddit stopped accepting new requests for public API access on October 31, 2026, so both routes now work only if you already hold approved credentials, and Reddit says the remaining public API access ends in March 2027. Without credentials, the working route is a research tool that finds the threads for you: logged-out requests to Reddit’s .json endpoints all returned HTTP 403 when we tested them on November 15, 2026.

Everything below was read from Reddit’s help center, its Data API Terms and its API docs, and from each MCP server’s repository, on November 15, 2026.

Reddit API access in November 2026

Reddit is moving apps that use its public Data API onto its Developer Platform, and the dates are on Reddit’s own pages. The Changelog for October 8, 2026 says public Data API apps and bots “are moving to Reddit’s Developer Platform as part of efforts to reduce scraping and automated abuse”, and lists the timeline:

Date What Reddit says happens Source
October 31, 2026 “New requests for public API access will no longer be accepted.” Reddit Changelog, October 8, 2026
November 13, 2026 RSS feed support ends Reddit Changelog, October 8, 2026
November 30, 2026 Last day to register an app and possibly qualify for a $1,000 porting bounty developers.reddit.com/app-registration
January 12, 2027 “API access removal begins for apps and users that haven’t registered or responded to Reddit’s outreach.” Reddit Changelog; app registration page
March 2027 “Remaining public API access ends.” Reddit Changelog; app registration page

If you already have a Reddit API app, register it at developers.reddit.com/app-registration before January 12, 2027. The page asks for “the account information associated with your API app” and a personal Reddit account, and says “You’ll need a human Reddit account to register.”

The older rule still applies until then. Reddit’s Responsible Builder Policy (updated October 5, 2026) says “You must request access and get explicit approval before accessing any Reddit data through our API.” The Data API Wiki adds: “Traffic not using OAuth or login credentials will be blocked.” Tutorials that tell you to open reddit.com/prefs/apps, click “create app” and copy a key describe a process that no longer gives new users access.

Three ways to search Reddit from an AI assistant

MCP server with your Reddit app Search API in your own code Hosted research tool
What you set up A local MCP server in Claude Desktop, Claude Code or Cursor A script that calls oauth.reddit.com/search An MCP connection or API key for the tool
Reddit credentials Client ID and secret of an app Reddit already approved Same None on your side
Rate limit Reddit’s 100 queries a minute per OAuth client ID, averaged over 10 minutes; some servers cap themselves lower Same The tool’s own limits
Cost Free for approved non-commercial use; commercial use needs Reddit’s written approval and a contract Same The tool’s pricing
What breaks it No new credentials since October 31, 2026; unregistered apps lose access from January 12, 2027; public API access ends March 2027 Same Results are the tool’s selection and summary, not full threads
Best for Asking about threads in a chat, with you choosing the subreddit Repeatable searches, pagination, saving results People with no approved Reddit app

A fourth option, the “no API key” MCP servers, read Reddit’s logged-out .json pages, its RSS feeds or a third-party copy of Reddit. From the network we tested on, every logged-out .json request returned 403, and Reddit set November 13, 2026 as the end of RSS support. Treat keyless servers as unreliable, and read the section on Reddit’s rules before you use a copy of Reddit’s data.

Reddit MCP servers compared

The open-source Reddit MCP servers with the most GitHub stars, as of November 15, 2026:

Repository Stars Latest release or commit Reddit auth Search tool Notes
karanb192/reddit-mcp-buddy 897 v1.3.0 on npm, November 11, 2026 Required: approved client ID and secret; username and password or a refresh token optional search_reddit Also browse_subreddit, get_post_details, user_analysis, find_subreddits. Posting is off unless you turn it on. Caps itself at 60 requests a minute app-only, 100 with a user
adhikasp/mcp-reddit 438 Last commit May 11, 2025 None in its config None Fetches hot threads and post content only
jordanburke/reddit-mcp-server 331 v2.0.2 on npm, November 14, 2026 Optional client ID and secret; keyless mode without them search_reddit 17 read tools plus write tools. Keyless mode reads RSS (until November 13, 2026) and the Arctic Shift archive, which its README calls “a third-party copy of Reddit” whose scores and comment counts lag
Arindam200/reddit-mcp 301 Last commit December 21, 2025 Client ID and secret (PRAW) search_posts README still points to reddit.com/prefs/apps for credentials
Hawstein/mcp-server-reddit 185 Last commit June 10, 2026 None in its config None Front page, subreddit listings, post content and comments
eliasbiondo/reddit-mcp-server 167 v0.2.1 on PyPI, October 24, 2026 Optional client ID and secret search, search_subreddit Its README warns Reddit blocks anonymous requests “from many networks” with “HTTP 403: You’ve been blocked by network security”

The two most active projects, reddit-mcp-buddy and reddit-mcp-server, are both listed in the official MCP registry under io.github.karanb192/reddit-mcp-buddy and io.github.jordanburke/reddit-mcp-server. The registry also lists many hosted Reddit servers run by companies; a hosted server reads Reddit on its operator’s terms, so check those terms before you send it your queries.

reddit-mcp-buddy’s README puts the current situation plainly: “You need Reddit API credentials that Reddit has already approved.” The snippets below use it, because its tools are read-only unless you enable posting and it refuses to start the write tools over HTTP.

Install a Reddit MCP server in Claude, Cursor and ChatGPT

Each snippet runs the server with npx, so install Node.js first. Replace the placeholder values with your approved app’s client ID and secret.

Claude Desktop

Open Settings > Developer > Edit Config, which opens claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows), and add the server:

{
"mcpServers": {
"reddit": {
"command": "npx",
"args": ["-y", "reddit-mcp-buddy"],
"env": {
"REDDIT_CLIENT_ID": "YOUR_CLIENT_ID",
"REDDIT_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
}
}
}
}

Quit Claude Desktop completely and reopen it. To see the tools, click the “Add files, connectors, and more” button in the message box, then Connectors > Manage connectors. reddit-mcp-buddy also ships a one-click Claude Desktop extension, reddit-mcp-buddy.mcpb, on its releases page; you enter the same two values in its settings.

Claude Code

claude mcp add takes Claude’s own options, then --, then the command that starts the server:

Terminal window
claude mcp add --transport stdio reddit -s user \
-e REDDIT_CLIENT_ID=YOUR_CLIENT_ID -e REDDIT_CLIENT_SECRET=YOUR_CLIENT_SECRET \
-- npx -y reddit-mcp-buddy

-s user makes the server available in every project; leave it out to add it to the current project only.

Cursor

Put the server in ~/.cursor/mcp.json for every project, or .cursor/mcp.json in one project. Cursor can read the secrets from your environment instead of the file:

{
"mcpServers": {
"reddit": {
"command": "npx",
"args": ["-y", "reddit-mcp-buddy"],
"env": {
"REDDIT_CLIENT_ID": "${env:REDDIT_CLIENT_ID}",
"REDDIT_CLIENT_SECRET": "${env:REDDIT_CLIENT_SECRET}"
}
}
}
}

ChatGPT

ChatGPT connects only to remote MCP servers, so a Reddit server running on your computer cannot be added directly. OpenAI’s help page on connecting custom MCP servers says full MCP is for Business and Enterprise/Edu workspaces, that “Pro users can connect custom MCP servers with read/fetch permissions”, and that a server on a private network or developer machine needs OpenAI’s Secure MCP Tunnel. You add one from Plugins, then the plus button, then Add custom MCP server.

reddit-mcp-buddy can run over HTTP (npx -y reddit-mcp-buddy --http), but its README warns that “HTTP mode has no authentication.” Do not expose it to the internet with your Reddit credentials inside. For ChatGPT, a hosted research tool is the simpler route.

Reddit search API endpoint and parameters

Reddit’s search endpoint is GET /search for all of Reddit or GET /r/{subreddit}/search for one subreddit, called on https://oauth.reddit.com with a bearer token and the read scope. The parameters, from Reddit’s API documentation:

Parameter Values What it does
q Up to 512 characters The search query
restrict_sr Boolean Limit results to the subreddit in the path; set it whenever you search one subreddit
sort relevance, hot, top, new, comments Result order
t hour, day, week, month, year, all Time window
limit Default 25, maximum 100 Results per page
after, before A fullname such as t3_abc123 Page forward or back from that item
type Comma-separated sr, link, user Search subreddits, posts or users
count, show, sr_detail, include_facets, category See the docs Rarely needed

Search results are a Listing. Each page returns an after value, the fullname of the last item, which you pass back to get the next page; Reddit’s docs say listings “do not use page numbers because their content changes so frequently.” Search does not return comments: to read a thread, fetch its permalink with the same token.

Tokens come from https://www.reddit.com/api/v1/access_token. For read-only search, Reddit’s OAuth2 docs describe an app-only token: POST grant_type=client_credentials, with the client ID and secret as HTTP Basic auth. “All bearer tokens expire after 1 hour”, and API requests “should be made to https://oauth.reddit.com, NOT www.reddit.com.”

Python example: search Reddit with requests

This script gets an app-only token, searches one subreddit, follows after for a second page, and waits when the rate-limit headers say the window is used up. It needs only requests.

import os
import time
import requests
CLIENT_ID = os.environ["REDDIT_CLIENT_ID"]
CLIENT_SECRET = os.environ["REDDIT_CLIENT_SECRET"]
# Reddit's format: <platform>:<app ID>:<version> (by /u/<reddit username>)
USER_AGENT = os.environ.get(
"REDDIT_USER_AGENT", "python:thread-finder:v0.1 (by /u/YOUR_REDDIT_USERNAME)"
)
TOKEN_URL = "https://www.reddit.com/api/v1/access_token"
API_BASE = "https://oauth.reddit.com" # token requests go to www, API calls to oauth
def get_token():
"""App-only token (client_credentials grant). Tokens last one hour."""
resp = requests.post(
TOKEN_URL,
auth=(CLIENT_ID, CLIENT_SECRET),
data={"grant_type": "client_credentials"},
headers={"User-Agent": USER_AGENT},
timeout=30,
)
if resp.status_code == 401:
raise RuntimeError("401 from access_token: wrong client ID or secret, or access revoked")
resp.raise_for_status()
return resp.json()["access_token"]
def search(query, subreddit=None, sort="relevance", t="all", limit=25, max_pages=2):
"""Yield posts matching query, across Reddit or inside one subreddit."""
headers = {"Authorization": f"bearer {get_token()}", "User-Agent": USER_AGENT}
path = f"/r/{subreddit}/search" if subreddit else "/search"
params = {"q": query, "sort": sort, "t": t, "limit": limit, "type": "link"}
if subreddit:
params["restrict_sr"] = "true"
for _ in range(max_pages):
resp = requests.get(API_BASE + path, headers=headers, params=params, timeout=30)
if resp.status_code == 429:
time.sleep(float(resp.headers.get("X-Ratelimit-Reset", 60)))
continue
resp.raise_for_status()
listing = resp.json()["data"]
for child in listing["children"]:
post = child["data"]
yield {
"title": post["title"],
"subreddit": post["subreddit"],
"score": post["score"],
"num_comments": post["num_comments"],
"created_utc": post["created_utc"],
"url": "https://www.reddit.com" + post["permalink"],
}
if float(resp.headers.get("X-Ratelimit-Remaining", 1)) < 1:
time.sleep(float(resp.headers.get("X-Ratelimit-Reset", 60)))
if not listing.get("after"):
break
params["after"] = listing["after"]
if __name__ == "__main__":
for post in search("standing desk", subreddit="BuyItForLife", sort="top", t="year"):
print(post["score"], post["num_comments"], post["title"], post["url"])

Set REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET in your environment, and put your own Reddit username in the User-Agent. Reddit’s Data API Wiki asks for that format and warns that “Many default User-Agents (like “Python/urllib” or “Java”) are drastically limited.” We ran the script with fake credentials on November 15, 2026 and got the 401 branch; the search path needs real approved credentials.

The same search in PRAW (version 8.0.3, August 2026), which handles the token and paging for you:

import os
import praw
reddit = praw.Reddit(
client_id=os.environ["REDDIT_CLIENT_ID"],
client_secret=os.environ["REDDIT_CLIENT_SECRET"],
user_agent="python:thread-finder:v0.1 (by /u/YOUR_REDDIT_USERNAME)",
)
results = reddit.subreddit("BuyItForLife").search(
"standing desk", sort="top", time_filter="year", limit=50
)
for post in results:
print(post.score, post.num_comments, post.title, "https://www.reddit.com" + post.permalink)

PRAW sets restrict_sr for you. Use reddit.subreddit("all").search(...) to search all of Reddit.

The public .json endpoints in 2026

Adding .json to a Reddit URL used to return the page as JSON with no account. On November 15, 2026, from the network we tested on, it did not:

Request (logged out) Result
www.reddit.com/search.json?q=... with three different User-Agents 403, HTML page “You’ve been blocked by network security”
www.reddit.com/r/redditdev/search.json?q=api&restrict_sr=1 403, same page
www.reddit.com/r/ClaudeAI/new.json 403, same page
oauth.reddit.com/search?q=... with no token 403, same page
old.reddit.com/search.json?q=... 302 redirect to the login page
POST www.reddit.com/api/v1/access_token with no or fake credentials 401, {"message": "Unauthorized", "error": 401}
www.reddit.com/r/redditdev/.rss 200, an Atom feed, two days after Reddit’s November 13 end date

Reddit says the block covers hosted networks in particular: “If you’re accessing Reddit from an IP address in a hosted service provider’s netblock, you will be required to have a valid OAuth token or be logged in.” Results from a home connection can differ, but Reddit’s wiki says traffic without OAuth or login credentials “will be blocked”, so code built on logged-out .json requests should be expected to fail. Reddit’s robots.txt disallows all crawling and points to its Public Content Policy; the Data API Wiki notes that robots.txt “is for search engines, not Data API users.”

Errors and limits when an assistant searches Reddit

Symptom Cause Fix
403 with an HTML page “You’ve been blocked by network security” A request with no OAuth token, often from a hosted network Use an OAuth token on oauth.reddit.com; keyless servers fail the same way
resp.json() fails on a .json URL The response was that 403 HTML page, not JSON Same fix
401 {"message": "Unauthorized", "error": 401} from access_token Wrong or missing client ID and secret, or credentials sent in the POST body instead of Basic auth Send them as HTTP Basic auth; check the app still has access
reddit.com/prefs/apps does not give you working credentials New public API requests closed on October 31, 2026 Use credentials you already hold, or a hosted research tool
MCP tools say credentials are needed The server started without REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET Add both to the server’s env block and restart the client
X-Ratelimit-Remaining reaches 0, then requests fail Over 100 queries a minute per client ID, averaged over 10 minutes Wait X-Ratelimit-Reset seconds; cache results; lower page counts
Very slow or failing requests with a default User-Agent Reddit limits default agents like “Python/urllib” Use platform:app-id:version (by /u/username)
Search returns posts but no comments Search returns Listings of posts Fetch each post’s permalink for its comments
Claude Code’s web fetch says “Claude Code is unable to fetch from www.reddit.com” The built-in fetch tool would not open reddit.com in our test Use an MCP server with credentials, or a research tool
The server does not appear in Claude Desktop Invalid JSON, or the app was not fully restarted Fix the JSON, quit and reopen; read mcp*.log in ~/Library/Logs/Claude or %APPDATA%\Claude\logs
Your app stops working in 2027 Not registered by January 12, 2027, or public access ended in March 2027 Register at developers.reddit.com/app-registration; plan for March 2027

Reddit’s rules on commercial use and AI training

Reddit’s terms separate reading threads for yourself from building a product on them, and they treat model training as its own case. Quoted from Reddit’s pages as of November 15, 2026:

  • Commercial use needs permission and a contract. “You cannot use any Reddit developer tools and services for commercial purposes without first getting our permission.” Reddit counts “any use of our services by a business or on behalf of a business or as part of a monetized product or service”, and its examples include “Services, research, or data access for fees” and “Free product features available for upsell”. Using Reddit data “to power, augment, or enhance your product or service for any commercial purposes” requires permission, “and we’ll require a contract.” (Developer Platform & Accessing Reddit Data, updated May 28, 2026)
  • No model training without consent. “You may not use content on Reddit as an input for any model training without explicit consent from Reddit. Commercial use of any model trained with Reddit data is prohibited without explicit approval.” (same page) The Developer Terms (revised March 24, 2026) bar using Reddit data, “including by accessing our API or indexing, caching, or crawling”, to “train large language, artificial intelligence, or other algorithmic models or related services without our permission.”
  • What the API license covers. The Data API Terms (revised July 20, 2026) license you “to copy and display the User Content using the Data API solely as necessary to develop, deploy, distribute, and run your App to your App Users”, and say no right is implied “to use User Content for other purposes, such as for training a machine learning or AI model, without the express permission of rightsholders.” They also forbid deriving revenue from the APIs “unless there is express written approval from Reddit.”
  • No ads next to Reddit content. “You cannot display Reddit content and run advertisements within your app, website, or other services.”
  • Research has one route. “The only official and authorized avenue for performing research using Reddit data is through the Reddit For Researchers (RFR) program.” The Responsible Builder Policy adds: “Any research that uses Reddit data collected outside of the RFR Program is in violation of this policy.”
  • Deleted content must go. “You must remove any user content in your possession that has been deleted from Reddit”, and Reddit recommends “routinely deleting any stored user data and content within 48 hours.” (Data API Wiki)
  • No sensitive inferences. The Responsible Builder Policy forbids processing data “to derive or infer potentially sensitive characteristics about Reddit users (e.g., health, political affiliation, sexual orientation).”

These rules apply to the data, whichever route fetched it. A keyless MCP server or a third-party archive does not change what you may do with Reddit content.

Finding Reddit threads without Reddit credentials

A hosted research tool runs the search on its side and returns thread links with a short account of what each says, so you need no Reddit app. Hyperresearch’s Answers tool can return Reddit or forum threads for questions about experiences or opinions; each one is labeled “community discussion, not quote-checked”, and its summary is a search model’s summary of the thread, never the thread’s own words.

Whatever tool you use, open the thread before you rely on it. A summary of a discussion is not a quote, and upvotes measure agreement, not accuracy. For giving an agent general web search, see How to add web search to an AI agent; for checking what an assistant cites, see How to verify citations in AI output; for research runs inside Claude Code, see the Claude Code research harness.

Sources