MCP Server
Connect your AI assistant directly to Reddit Insights. Search millions of Reddit conversations, explore subreddits, and discover trends — all through natural language.
What is MCP?
The Model Context Protocol (MCP) is an open standard that enables AI assistants like Claude to securely connect to external data sources and tools. Instead of copying and pasting data, your AI can directly access and analyze information in real-time.
With our MCP server, Claude Desktop gains the ability to search Reddit's vast conversation database, explore communities, and surface trending topics — all through natural conversation.
Quick Setup
Open Claude Desktop Config
Find and open your Claude Desktop configuration file:
~/Library/Application Support/Claude/claude_desktop_config.json %APPDATA%\Claude\claude_desktop_config.json Add Server Configuration
Add the following configuration to your config file:
{
"mcpServers": {
"reddit-insights": {
"transport": {
"type": "http",
"url": "https://reddit-insights.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
}Restart Claude Desktop
After saving the configuration file, restart Claude Desktop. The Reddit Insights tools will now be available in your conversations.
Verification
After restarting, ask Claude: "What Reddit tools do you have access to?" Claude should list the Reddit Insights tools.
Authentication
The MCP server requires an API key to execute tools. Without a valid API key, you can connect and view available tools, but tool execution will fail.
How to Get Your API Key
Subscribe to a Pro or Enterprise plan (API access requires a paid subscription)
Go to your Account Dashboard
Find the API Key section and click "Generate API Key"
Copy the key and replace YOUR_API_KEY in your Claude Desktop config
Keep Your API Key Secret
Never share your API key publicly or commit it to version control. If you believe your key has been compromised, regenerate it immediately from your account dashboard.
Error Without Authentication
If you try to use MCP tools without a valid API key, you'll see this error:
{
"error": {
"code": -32001,
"message": "Authentication required. Please provide a valid API key..."
}
}Available Tools
Once connected, Claude will have access to these tools for searching and exploring Reddit:
reddit_search (10 requests/minute (free tier)) Basic semantic search through Reddit conversations.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | Natural language search query |
reddit_semantic_search (Requires API key) Advanced AI-powered semantic search with sentiment analysis and AI summaries.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | Natural language search query |
| limit | number | No | Maximum results (1-100, default: 20) |
reddit_list_subreddits (Unlimited) Get a paginated list of available subreddits.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| page | number | No | Page number (default: 1) |
| limit | number | No | Results per page (1-100, default: 20) |
| search | string | No | Filter by name, title, or description |
reddit_get_subreddit (Unlimited) Get detailed information about a specific subreddit including recent posts.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| subreddit | string | Yes | Subreddit name (without r/ prefix) |
reddit_get_trends (Unlimited) Get Reddit trend articles and insights.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| page | number | No | Page number (default: 1) |
| perPage | number | No | Results per page (default: 12) |
| filter | string | No | Time period - "latest", "today", "week", "month" |
| category | string | No | Filter by category |
Usage Examples
Research a Topic
You: What are developers saying about React Server Components?
Claude: Let me search Reddit for discussions about React Server Components.
[Uses reddit_search tool]
Found 45 results for "React Server Components developer opinions"
Keywords: react, server components, next.js, performance, ssr
AI Summary:
Developers generally praise RSC for performance benefits in large applications...
Some express concerns about the learning curve and tooling complexity...
Top Results:
1. React Server Components: A year in production
r/webdev | 1247 upvotes | 89 comments
Relevance: 94.3%Explore a Subreddit
You: Tell me about the r/typescript community
Claude: [Uses reddit_get_subreddit tool]
r/typescript - TypeScript
Subscribers: 285,432
Created: 2012-10-01
Description: A community for discussing TypeScript, a typed superset...
Recent Posts:
1. TypeScript 5.4 released with new features
567 upvotes | 45 comments
2. Help: How to type this complex nested object?
234 upvotes | 12 commentsFind Trending Topics
You: What's trending in tech on Reddit this week?
Claude: [Uses reddit_get_trends tool with filter "week"]
Reddit Trends (Filter: week, Category: technology)
Page 1 of 3, Total: 28 articles
1. AI Coding Assistants: Are They Replacing Junior Developers?
By Sarah Chen | technology
Published: 2024-01-15 | Views: 12,453
Tags: ai, coding, career, toolsTechnical Details
Protocol
MCP Streamable HTTP Transport (2025-11-25)
Endpoint
https://reddit-insights.com/api/mcp HTTP Methods
| Method | Purpose |
|---|---|
| POST | Handles client JSON-RPC requests |
| GET | Opens SSE stream for server messages |
| DELETE | Terminates sessions |
Troubleshooting
Tools not showing in Claude
Check that your config file has valid JSON syntax. Try copying the configuration exactly as shown above. Restart Claude Desktop completely (quit and reopen).
Connection errors
Verify the URL is exactly https://reddit-insights.com/api/mcp. Check your internet connection and firewall settings.
Rate limit exceeded
The free tier allows 10 requests per minute. Wait a moment before trying again, or upgrade to a paid plan for higher limits.
Resources
Ready to Get Started?
Connect Claude Desktop to Reddit Insights in under 2 minutes.