Skip to content
Back to search

reddit-research-mcp

Turn Reddit's chaos into structured insights with full citations. MCP server for competitive analysis, customer discovery, and market research. Zero-setup hosted solution with semantic search across 20,000+ subreddits.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dialog-tools--reddit-research-mcp/badge.svg)](/listings/dialog-tools--reddit-research-mcp)

HTML

<a href="/listings/dialog-tools--reddit-research-mcp"><img src="/api/listings/dialog-tools--reddit-research-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

claude mcp add --scope local --transport http dialog-mcp https://mcp.dialog.tools/mcp

Cursor

cursor://anysphere.cursor-deeplink/mcp/install?name=dialog-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWFsb2cudG9vbHMvbWNwIn0%3D

OpenAI Codex CLI

codex mcp add dialog-mcp \
    npx -y mcp-remote \
    https://mcp.dialog.tools/mcp \
    --auth-timeout 120 \
    --allow-http \

Gemini CLI

gemini mcp add dialog-mcp \
  npx -y mcp-remote \
  https://mcp.dialog.tools/mcp \
  --auth-timeout 120 \
  --allow-http

Direct MCP Server URL

For other AI assistants: `https://mcp.dialog.tools/mcp`

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 268 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. mcp-name: io.github.king-of-the-grackles/reddit-research-mcp
  2. # Dialog MCP Server
  3. **Open source Reddit intelligence, part of the research engine that powers [Dialog](https://app.dialog.tools)**
  4. [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
  5. [![FastMCP](https://img.shields.io/badge/Built%20with-FastMCP-orange.svg)](https://github.com/jlowin/fastmcp)
  6. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  7. **Version**: 1.0.1
  8. ---
  9. Turn Reddit's chaos into evidence-backed insights. This MCP server gives any AI assistant semantic search across 20,000+ active subreddits, deep-dive access to posts and comment threads, and saved feeds for ongoing monitoring. Every finding comes with citations to real posts and comments.
  10. It's fully usable on its own, for free, in Claude Code, Cursor, Codex, Gemini CLI, or any MCP-compatible client. It's also part of the research engine that powers [Dialog](https://app.dialog.tools), the AI agent platform for continuous market intelligence, where it ships connected to every agent.
  11. ---
  12. ## Why This Server?
  13. **Evidence-based insights with full citations.** Every finding links back to real Reddit posts and comments with upvote counts, awards, and direct URLs. When you say "users are complaining about X," you'll have the receipts to prove it.
  14. **Zero-friction setup.** No Reddit API credentials needed. No terminal commands. No credential management. Just connect and start researching.
  15. **Semantic search at scale.** Reddit's API caps at 250 search results. This server searches conceptually across 20,000+ indexed subreddits using vector embeddings, finding relevant communities you didn't know existed.
  16. **Persistent research management.** Save subreddit collections into feeds for ongoing monitoring. Perfect for long-term competitive analysis and market research campaigns.
  17. ---
  18. ## Quick Setup (60 Seconds)
  19. ### Claude Code
  20. ```bash
  21. claude mcp add --scope local --transport http dialog-mcp https://mcp.dialog.tools/mcp
  22. ```
  23. ### Cursor
  24. ```
  25. cursor://anysphere.cursor-deeplink/mcp/install?name=dialog-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWFsb2cudG9vbHMvbWNwIn0%3D
  26. ```
  27. ### OpenAI Codex CLI
  28. ```bash
  29. codex mcp add dialog-mcp \
  30. npx -y mcp-remote \
  31. https://mcp.dialog.tools/mcp \
  32. --auth-timeout 120 \
  33. --allow-http \
  34. ```
  35. ### Gemini CLI
  36. ```bash
  37. gemini mcp add dialog-mcp \
  38. npx -y mcp-remote \
  39. https://mcp.dialog.tools/mcp \
  40. --auth-timeout 120 \
  41. --allow-http
  42. ```
  43. ### Direct MCP Server URL
  44. For other AI assistants: `https://mcp.dialog.tools/mcp`
  45. ---
  46. ## What You Can Do
  47. ### Competitive Analysis
  48. ```
  49. "What are developers saying about Next.js vs Remix?"
  50. ```
  51. Get a comprehensive report comparing sentiment, feature requests, pain points, and migration experiences with links to every mentioned discussion.
  52. ### Customer Discovery
  53. ```
  54. "Find the top complaints about existing CRM tools in small business communities"
  55. ```
  56. Discover unmet needs, feature gaps, and pricing concerns directly from your target market with citations to real user feedback.
  57. ### Market Research
  58. ```
  59. "Analyze sentiment about AI coding assistants across developer communities"
  60. ```
  61. Track adoption trends, concerns, success stories, and emerging use cases with temporal analysis showing how opinions evolved.
  62. ### Product Validation
  63. ```
  64. "What problems are SaaS founders having with subscription billing?"
  65. ```
  66. Identify pain points and validate your solution with evidence from actual Reddit discussions, not assumptions.
  67. ### Ongoing Monitoring
  68. ```
  69. "Save these communities as a feed so we can track competitor sentiment over time"
  70. ```
  71. Build curated feeds of the communities that matter to you, then come back to them in any session. Want this to run on a schedule and land in Slack? That's what [Dialog](https://app.dialog.tools) adds on top.
  72. ---
  73. ## Server Capabilities
  74. | Category | Count | Description |
  75. |----------|-------|-------------|
  76. | **MCP Tools** | 3 | discover_operations, get_operation_schema, execute_operation |
  77. | **Reddit Operations** | 5 | discover, search, fetch_posts, fetch_multiple, fetch_comments |
  78. | **Feed Operations** | 5 | create, list, get, update, delete |
  79. | **Indexed Subreddits** | 20,000+ | Active communities (2k+ members, updated weekly) |
  80. | **MCP Prompts** | 1 | reddit_research for automated workflows |
  81. | **Resources** | 1 | reddit://server-info for documentation |
  82. ---
  83. ## Use Cases by Role
  84. ### For Indie Hackers & SaaS Founders
  85. - Validate product ideas before building
  86. - Find communities where your target customers hang out
  87. - Monitor competitor mentions and sentiment
  88. - Discover unmet needs in your niche
  89. ### For Product Managers
  90. - Gather customer feedback at scale
  91. - Track feature requests across communities
  92. - Understand competitive landscape
  93. - Identify emerging trends before they peak
  94. ### For Market Researchers
  95. - Conduct sentiment analysis with full citations
  96. - Build audience personas from real discussions
  97. - Track how opinions evolve over time
  98. - Generate evidence-based reports
  99. ---
  100. ## Technical Details
  101. <details>
  102. <summary><strong>Three-Layer MCP Architecture</strong></summary>
  103. The server follows the **layered abstraction pattern** for scalability and self-documentation:
  104. ### Layer 1: Discovery
  105. ```python
  106. discover_operations()
  107. ```
  108. See what operations are available and get workflow recommendations.
  109. ### Layer 2: Schema Inspection
  110. ```python
  111. get_operation_schema("discover_subreddits", include_examples=True)
  112. ```
  113. Understand parameter requirements, validation rules, and see examples before executing.
  114. ### Layer 3: Execution
  115. ```python
  116. execute_operation("discover_subreddits", {
  117. "query": "machine learning",
  118. "limit": 15,
  119. "min_confidence": 0.6
  120. })
  121. ```
  122. Perform the actual operation with validated parameters.
  123. </details>
  124. <details>
  125. <summary><strong>Reddit Research Operations</strong></summary>
  126. ### discover_subreddits
  127. Find relevant communities using semantic vector search across 20,000+ indexed subreddits.
  128. ### search_subreddit
  129. Search for posts within a specific subreddit with filters for time range and sort order.
  130. ### fetch_posts
  131. Get posts from a single subreddit by listing type (hot, new, top, rising).
  132. ### fetch_multiple
  133. **70% more efficient** - Batch fetch posts from multiple subreddits concurrently.
  134. ### fetch_comments
  135. Get complete comment trees for deep analysis of discussions.
  136. </details>
  137. <details>
  138. <summary><strong>Feed Management Operations</strong></summary>
  139. Feeds let you save research configurations for ongoing monitoring:
  140. - **create_feed** - Save discovered subreddits with analysis and metadata
  141. - **list_feeds** - View all your saved feeds with pagination
  142. - **get_feed** - Retrieve a specific feed by ID
  143. - **update_feed** - Modify feed name, subreddits, or analysis
  144. - **delete_feed** - Remove a feed permanently
  145. </details>
  146. <details>
  147. <summary><strong>Authentication</strong></summary>
  148. The server uses **Descope OAuth2** for secure authentication:
  149. - **Setup**: No Reddit credentials needed - server handles authentication
  150. - **Token**: Automatically managed by your MCP client
  151. - **Privacy**: Only accesses public Reddit data
  152. - **First use**: Authentication takes ~30 seconds, then you're set
  153. </details>
  154. ---
  155. ## Want This Running on Autopilot? Meet Dialog
  156. This server is free and fully usable standalone. [Dialog](https://app.dialog.tools) is the hosted platform where it plugs into a larger research engine: AI agents that combine this Reddit server with 45+ other integrations to run your research continuously and deliver the results where you work.
  157. | | This MCP server (free, open source) | Dialog platform |
  158. |---|---|---|
  159. | **Reddit research** | Full access: semantic discovery, search, posts, comments, feeds | This same server, connected by default to every agent |
  160. | **How it runs** | On demand, inside your AI assistant | Autonomous agents powered by Claude that plan and execute multi-step research |
  161. | **Scheduling** | Manual, session by session | Automations that run on a schedule and land in a persistent inbox |
  162. | **Delivery** | Your chat window | Formatted reports with inline charts in Slack, Telegram, or the web app |
  163. | **Data sources** | Reddit | Reddit plus 45+ integrations: Gmail, Slack, Linear, HubSpot, Apollo, PostHog, Google Drive, and more |
  164. | **Memory** | Per session | Persistent agent workspaces that build context over time |
  165. A typical Dialog workflow: an agent monitors your competitors' communities every Monday morning, cross-references mentions against your CRM, and posts a formatted report with charts to your team's Slack channel before standup.
  166. [Try Dialog Free](https://app.dialog.tools)
  167. ---
  168. ## Contributing
  169. Contributions are welcome. The stack:
  170. - Python 3.11+ with type hints
  171. - [FastMCP](https://github.com/jlowin/fastmcp) for the server framework
  172. - ChromaDB for semantic search
  173. - PRAW for Reddit API interaction
  174. ### Local Development
  175. ```bash
  176. # Clone and install (uses uv)
  177. git clone https://github.com/king-of-the-grackles/reddit-research-mcp.git
  178. cd reddit-research-mcp
  179. uv sync --extra dev
  180. # Run tests
  181. uv run pytest
  182. # Run the server locally
  183. uv run reddit-mcp
  184. ```
  185. Found a bug or have a feature idea? [Open an issue](https://github.com/king-of-the-grackles/reddit-research-mcp/issues).
  186. ---
  187. <div align="center">
  188. **Stop guessing. Start knowing what your market actually thinks.**
  189. [Dialog App](https://app.dialog.tools) | [GitHub](https://github.com/king-of-the-grackles/reddit-research-mcp) | [Report Issues](https://github.com/king-of-the-grackles/reddit-research-mcp/issues)
  190. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.