Reddit MCP server for AI agents

The Reddit Research MCP Server transforms Reddit into a structured research database, allowing you to gather market insights, competitive analysis, and customer feedback with full citations to source posts and comments. This tool helps you discover what users are saying across thousands of subreddits with comprehensive reports that link back to every claim.

Quick Setup

Connect to the hosted server using your preferred AI assistant:

Claude Code

claude mcp add --scope local --transport http reddit-research-mcp https://reddit-research-mcp.fastmcp.app/mcp

Cursor

cursor://anysphere.cursor-deeplink/mcp/install?name=reddit-research-mcp&config=eyJ1cmwiOiJodHRwczovL3JlZGRpdC1yZXNlYXJjaC1tY3AuZmFzdG1jcC5hcHAvbWNwIn0%3D

OpenAI Codex CLI

codex mcp add reddit-research-mcp \
    npx -y mcp-remote \
    https://reddit-research-mcp.fastmcp.app/mcp \
    --auth-timeout 120 \
    --allow-http \

Gemini CLI

gemini mcp add reddit-research-mcp \
  npx -y mcp-remote \
  https://reddit-research-mcp.fastmcp.app/mcp \
  --auth-timeout 120 \
  --allow-http

Direct MCP Server URL

For other AI assistants: https://reddit-research-mcp.fastmcp.app/mcp

What You Can Do

Competitive Analysis

You can ask questions like:

"What are developers saying about Next.js vs Remix?"

This will generate a comprehensive report comparing sentiment, feature requests, pain points, and migration experiences with links to every mentioned discussion.

Customer Discovery

Try queries such as:

"Find the top complaints about existing CRM tools in small business communities"

This helps you discover unmet needs, feature gaps, and pricing concerns directly from your target market with citations to real user feedback.

Market Research

Example query:

"Analyze sentiment about AI coding assistants across developer communities"

Track adoption trends, concerns, success stories, and emerging use cases with temporal analysis showing how opinions have evolved.

Product Validation

You can validate your product ideas with queries like:

"What problems are SaaS founders having with subscription billing?"

This identifies pain points and validates your solution with evidence from actual discussions, not assumptions.

Core Operations

Discover Communities

execute_operation("discover_subreddits", {
    "topic": "machine learning",
    "limit": 15
})

Search Across Reddit

execute_operation("search_all", {
    "query": "ChatGPT experiences",
    "time_filter": "week",
    "limit": 25
})

Batch Fetch Posts

execute_operation("fetch_multiple", {
    "subreddit_names": ["technology", "programming"],
    "limit_per_subreddit": 10,
    "time_filter": "day"
})

Deep Dive with Comments

execute_operation("fetch_comments", {
    "submission_id": "abc123",
    "comment_limit": 200,
    "sort": "best"
})

Benefits

Evidence-based insights: Every report links back to actual Reddit posts and comments, providing reliable citations for your research.
Zero-friction setup: No need for cloning repositories, managing Python environments, or hunting for API keys.
Semantic search: Search conceptually across 20,000+ active subreddits, finding relevant communities you didn't know existed.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "reddit-mcp-poc" '{"command":"uv","args":["run","fastmcp","run","{projectPath}/src/server.py"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "reddit-mcp-poc": {
            "command": "uv",
            "args": [
                "run",
                "fastmcp",
                "run",
                "{projectPath}/src/server.py"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "reddit-mcp-poc": {
            "command": "uv",
            "args": [
                "run",
                "fastmcp",
                "run",
                "{projectPath}/src/server.py"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect