reddit-research-mcp
Provides tools for extracting Reddit URLs, resolving subreddits, creating research packs, searching Reddit, fetching threads and subreddit information, and tracking trends via Reddit.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@reddit-research-mcp search Reddit for latest AI trends"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
reddit-research-mcp
reddit-research-mcp is a fork/remake of the pi-reddit-research Pi extension by SaintNerona — github.com/SaintNerona/pi-reddit-research. It was converted from a Pi extension into a standalone MCP Server, with the core logic minimally changed.
MCP server for compact Reddit research packs.
Features
Registers these tools:
reddit_url_extract— parse Reddit URLs, permalinks, post IDs, and comment IDs.reddit_resolve_subreddits— find and rank subreddit candidates for a topic.reddit_pack— build a compact evidence pack from posts and top comments.reddit_search— search Reddit posts without fetching full comment threads.reddit_thread— fetch one thread and top comments.reddit_subreddits— raw subreddit search.reddit_trends— inspect hot/top/new posts in one or more subreddits.
Related MCP server: Reddit MCP Server
Install
{
"mcpServers": {
"reddit-research": {
"command": "npx",
"args": [
"-y",
"git+https://github.com/jhartum/reddit-research-mcp.git"
],
"env": {
"REDDIT_SESSION": "${REDDIT_SESSION}",
"REDDIT_TOKEN_V2": "${REDDIT_TOKEN_V2}"
}
}
}
}For local development:
git clone https://github.com/jhartum/reddit-research-mcp.git
cd reddit-research-mcp
npm install
npm run buildThen point your MCP client at node /path/to/reddit-research-mcp/dist/index.js.
Usage
Ask questions like:
"What does Reddit think about Claude Code vs OpenCode?"
"Find Reddit fixes for this error: ..."
"What settings do ComfyUI users recommend for ...?"
Configuration
1. JSON config (recommended)
Since mid-2026, Reddit requires authentication for .json access. Create ~/.pi/agent/reddit-research.json:
{
"cookie": "reddit_session=abc123; token_v2=def456"
}Or reference a separate cookie file:
{
"cookieFile": "/home/user/.config/pi-reddit-research/cookie.txt"
}Advantages:
No env vars to manage
The server re-reads the config before requests, so you can update the cookie without restarting
cookieFilekeeps the secret outside the JSON config and shell startup files
Security: your Reddit cookie is a secret. Do not commit it to git or public dotfiles.
2. Environment variables (alternative)
Variable | Default | Description |
|
| Cache directory. |
|
| SQLite cache path. |
|
| User-Agent for Reddit JSON requests. |
|
| Minimum delay between Reddit requests. |
|
| Search/request cache TTL. |
|
| Thread cache TTL. |
|
| Subreddit cache TTL. |
|
| Topic-to-subreddit cache TTL. |
|
| Max compact output size. |
| — | Reddit session cookie value. Overrides config file. |
| — | Path to a file with the Cookie header value. Overrides config file. |
|
| Path to JSON config file. |
Cookie source priority (highest to lowest):
REDDIT_COOKIEenv varREDDIT_COOKIE_FILEenv var → reads filecookiefield in JSON configcookieFilefield in JSON config → reads file
Notes
This server uses Reddit's .json endpoints with local SQLite caching. Since mid-2026, Reddit requires authentication for .json access. Set your cookie in ~/.pi/agent/reddit-research.json, via cookieFile, or via env vars to restore functionality.
Treat Reddit posts and comments as anecdotal evidence, not verified facts.
How to get your Reddit cookie
Open a private/incognito browser window (to avoid unrelated cookies).
Go to https://www.reddit.com/login and sign in.
F12 → Application → Cookies →
reddit.com.Method A (full Cookie header): Click any cookie → Ctrl+A → Ctrl+C, then pick "Copy as string" (Chrome) or paste into an editor and join with
;.Method B (only
reddit_session): Copy the value of thereddit_sessioncookie and use:# Via config file: echo '{"cookie": "reddit_session=YOUR_VALUE"}' > ~/.pi/agent/reddit-research.json # Or keep the secret in a separate file: mkdir -p ~/.config/reddit-research-mcp printf '%s\n' 'reddit_session=YOUR_VALUE' > ~/.config/reddit-research-mcp/cookie.txt printf '{"cookieFile":"%s/.config/reddit-research-mcp/cookie.txt"}\n' "$HOME" > ~/.pi/agent/reddit-research.json # Or via env: export REDDIT_COOKIE="reddit_session=YOUR_VALUE"
Important: Avoid cookies with JSON values (like g_state={"i_l":1,...}) — they break the JSON config file. If you copy the full Cookie header, remove entries like g_state, eu_cookie, and seeker_session. Only reddit_session and token_v2 are needed for authentication.
The cookie expires after a few days. When that happens, just update it in the config or cookie file — the server will pick up the change automatically.
License
MIT
Available Tools
7 toolsreddit_packReddit PackC
Build a compact Reddit research pack for opinions, bugs, fixes, comparisons, settings, alternatives, trends, guides, hardware, or general research.
Inputs: topic (required), sort, time, depth, +4 more.
reddit_resolve_subredditsReddit Resolve SubredditsB
Resolve a topic into ranked subreddit candidates using Reddit subreddit search, post search, SQLite cache, and subreddit priority hints.
Inputs: topic (required), limit, refresh.
reddit_searchReddit SearchA
Search Reddit posts and return a compact list without fetching comment threads.
Inputs: query (required), sort, time, limit, +1 more.
reddit_subredditsReddit SubredditsC
Find subreddit candidates for a topic.
Inputs: query (required), limit.
reddit_threadReddit ThreadA
Fetch one Reddit thread by URL or post id and return compact post details plus top comments.
Inputs: url_or_id (required), sort, top_comments, comment_limit.
reddit_trendsReddit TrendsC
Get hot, top, or new posts from one or more subreddits.
Inputs: subreddits (required), time, limit, listing.
reddit_url_extractReddit URL ExtractA
Parse a Reddit URL, permalink, t3 post id, or t1 comment id into normalized identifiers.
Inputs: url_or_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Reddit_subreddits and reddit_resolve_subreddits both find subreddits for a topic, creating potential confusion. Reddit_search and reddit_trends both return posts but differ in scope and parameters, though still somewhat distinct. The remaining tools are well-differentiated.
Tool names lack a consistent pattern; some are nouns (reddit_pack, reddit_subreddits, reddit_thread, reddit_trends) while others are verbs (reddit_search) or verb-noun phrases (reddit_resolve_subreddits, reddit_url_extract). This mixed convention reduces predictability.
With 7 tools, the server covers essential Reddit research capabilities without being bloated or sparse. Each tool serves a distinct purpose within the domain, and the count feels well-scoped for a research-oriented MCP server.
The tool set covers major research workflows: finding subreddits, searching posts, fetching threads, and getting trends. Minor gaps exist, such as lacking a dedicated tool for subreddit-specific search or comment-only extraction, but these can be worked around.
Related MCP Connectors
Reddit MCP server: search posts, subreddit feeds, comments & user profiles as JSON. No API key.
Real-time Reddit posts, subreddit search, comments & mentions MCP. Local npx or hosted OAuth.
Reddit & X data for AI agents over MCP. Semantic search, hosted, no Reddit API.
Reddit Ads MCP server: run Reddit campaigns, ad groups, ads and reports from AI.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI assistants like Claude to browse and analyze Reddit content, including searching subreddits, retrieving post details with comments, and viewing trending posts.10MIT
- AlicenseAqualityDmaintenanceAn MCP server that enables AI assistants to access and interact with Reddit content through features like user analysis, post retrieval, subreddit statistics, and authenticated posting capabilities.15302MIT
- FlicenseNot gradedqualityDmaintenanceA multi-purpose MCP server that enables Reddit research for market validation, data visualization with charts, medicine information lookup, user preference management, and task management tools. Provides comprehensive utilities for research, data analysis, and personal productivity through natural language interactions.1-
- AlicenseNot gradedqualityDmaintenanceA read-only MCP server that connects to the Reddit Data API to search posts, browse subreddits, read comments, view user profiles, and check trending content through the Model Context Protocol.24 npm2MIT