Dialog MCP Server

1mcp-name: io.github.king-of-the-grackles/reddit-research-mcp
2 
3# Dialog MCP Server
4 
5**AI-Powered Reddit Intelligence for Market Research & Competitive Analysis**
6 
7[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
8[![FastMCP](https://img.shields.io/badge/Built%20with-FastMCP-orange.svg)](https://github.com/jlowin/fastmcp)
9[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
10 
11**Version**: 1.0.0
12 
13---
14 
15Turn Reddit's chaos into actionable insights. Dialog is your all-in-one Reddit intelligence platform for competitive analysis, market research, and customer discovery across 20,000+ active subreddits.
16 
17This is the official MCP server powering [Dialog](https://app.dialog.tools) - the AI-powered Reddit research platform built for indie hackers, SaaS founders, product managers, and market researchers.
18 
19---
20 
21## Why Dialog?
22 
23**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.
24 
25**Zero-friction setup.** No Reddit API credentials needed. No terminal commands. No credential management. Just connect and start researching.
26 
27**Semantic search at scale.** Reddit's API caps at 250 search results. Dialog searches conceptually across 20,000+ indexed subreddits using vector embeddings, finding relevant communities you didn't know existed.
28 
29**Persistent research management.** Save subreddit collections into feeds for ongoing monitoring. Perfect for long-term competitive analysis and market research campaigns.
30 
31---
32 
33## Quick Setup (60 Seconds)
34 
35### Claude Code
36```bash
37claude mcp add --scope local --transport http dialog-mcp https://reddit-research-mcp.fastmcp.app/mcp
38```
39 
40### Cursor
41```
42cursor://anysphere.cursor-deeplink/mcp/install?name=dialog-mcp&config=eyJ1cmwiOiJodHRwczovL3JlZGRpdC1yZXNlYXJjaC1tY3AuZmFzdG1jcC5hcHAvbWNwIn0%3D
43```
44 
45### OpenAI Codex CLI
46```bash
47codex mcp add dialog-mcp \
48    npx -y mcp-remote \
49    https://reddit-research-mcp.fastmcp.app/mcp \
50    --auth-timeout 120 \
51    --allow-http \
52```
53 
54### Gemini CLI
55```bash
56gemini mcp add dialog-mcp \
57  npx -y mcp-remote \
58  https://reddit-research-mcp.fastmcp.app/mcp \
59  --auth-timeout 120 \
60  --allow-http
61```
62 
63### Direct MCP Server URL
64For other AI assistants: `https://reddit-research-mcp.fastmcp.app/mcp`
65 
66---
67 
68## What You Can Do
69 
70### Competitive Analysis
71```
72"What are developers saying about Next.js vs Remix?"
73```
74Get a comprehensive report comparing sentiment, feature requests, pain points, and migration experiences with links to every mentioned discussion.
75 
76### Customer Discovery
77```
78"Find the top complaints about existing CRM tools in small business communities"
79```
80Discover unmet needs, feature gaps, and pricing concerns directly from your target market with citations to real user feedback.
81 
82### Market Research
83```
84"Analyze sentiment about AI coding assistants across developer communities"
85```
86Track adoption trends, concerns, success stories, and emerging use cases with temporal analysis showing how opinions evolved.
87 
88### Product Validation
89```
90"What problems are SaaS founders having with subscription billing?"
91```
92Identify pain points and validate your solution with evidence from actual Reddit discussions, not assumptions.
93 
94---
95 
96## Server Capabilities
97 
98| Category | Count | Description |
99|----------|-------|-------------|
100| **MCP Tools** | 3 | discover_operations, get_operation_schema, execute_operation |
101| **Reddit Operations** | 5 | discover, search, fetch_posts, fetch_multiple, fetch_comments |
102| **Feed Operations** | 5 | create, list, get, update, delete |
103| **Indexed Subreddits** | 20,000+ | Active communities (2k+ members, updated weekly) |
104| **MCP Prompts** | 1 | reddit_research for automated workflows |
105| **Resources** | 1 | reddit://server-info for documentation |
106 
107---
108 
109## Use Cases by Role
110 
111### For Indie Hackers & SaaS Founders
112- Validate product ideas before building
113- Find communities where your target customers hang out
114- Monitor competitor mentions and sentiment
115- Discover unmet needs in your niche
116 
117### For Product Managers
118- Gather customer feedback at scale
119- Track feature requests across communities
120- Understand competitive landscape
121- Identify emerging trends before they peak
122 
123### For Market Researchers
124- Conduct sentiment analysis with full citations
125- Build audience personas from real discussions
126- Track how opinions evolve over time
127- Generate evidence-based reports
128 
129---
130 
131## Technical Details
132 
133<details>
134<summary><strong>Three-Layer MCP Architecture</strong></summary>
135 
136Dialog follows the **layered abstraction pattern** for scalability and self-documentation:
137 
138### Layer 1: Discovery
139```python
140discover_operations()
141```
142See what operations are available and get workflow recommendations.
143 
144### Layer 2: Schema Inspection
145```python
146get_operation_schema("discover_subreddits", include_examples=True)
147```
148Understand parameter requirements, validation rules, and see examples before executing.
149 
150### Layer 3: Execution
151```python
152execute_operation("discover_subreddits", {
153    "query": "machine learning",
154    "limit": 15,
155    "min_confidence": 0.6
156})
157```
158Perform the actual operation with validated parameters.
159 
160</details>
161 
162<details>
163<summary><strong>Reddit Research Operations</strong></summary>
164 
165### discover_subreddits
166Find relevant communities using semantic vector search across 20,000+ indexed subreddits.
167 
168### search_subreddit
169Search for posts within a specific subreddit with filters for time range and sort order.
170 
171### fetch_posts
172Get posts from a single subreddit by listing type (hot, new, top, rising).
173 
174### fetch_multiple
175**70% more efficient** - Batch fetch posts from multiple subreddits concurrently.
176 
177### fetch_comments
178Get complete comment trees for deep analysis of discussions.
179 
180</details>
181 
182<details>
183<summary><strong>Feed Management Operations</strong></summary>
184 
185Feeds let you save research configurations for ongoing monitoring:
186 
187- **create_feed** - Save discovered subreddits with analysis and metadata
188- **list_feeds** - View all your saved feeds with pagination
189- **get_feed** - Retrieve a specific feed by ID
190- **update_feed** - Modify feed name, subreddits, or analysis
191- **delete_feed** - Remove a feed permanently
192 
193</details>
194 
195<details>
196<summary><strong>Authentication</strong></summary>
197 
198Dialog uses **Descope OAuth2** for secure authentication:
199 
200- **Setup**: No Reddit credentials needed - server handles authentication
201- **Token**: Automatically managed by your MCP client
202- **Privacy**: Only accesses public Reddit data
203- **First use**: Authentication takes ~30 seconds, then you're set
204 
205</details>
206 
207---
208 
209## The Dialog Platform
210 
211This MCP server is the backend for [Dialog](https://app.dialog.tools), a complete Reddit intelligence platform featuring:
212 
213- **Chat Interface** - Natural language research powered by Claude AI
214- **Feed Management** - Create and manage curated subreddit collections
215- **Consolidated Views** - See hot posts from all your tracked subreddits in one place
216- **Cross-Device Sync** - Chat history and feeds sync across devices
217- **Visual Analytics** - Sentiment gauges, trend charts, and engagement metrics
218 
219[Try Dialog Free](https://app.dialog.tools)
220 
221---
222 
223## Contributing
224 
225This project uses:
226- Python 3.11+ with type hints
227- FastMCP for the server framework
228- ChromaDB for semantic search
229- PRAW for Reddit API interaction
230 
231---
232 
233<div align="center">
234 
235**Stop guessing. Start knowing what your market actually thinks.**
236 
237[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)
238 
239</div>
240