mcpField
R
Reddit Search Mcp

Reddit Search Mcp

Local
github.com/lignertysSearch1Updated 38w ago
Repository

About Reddit Search Mcp

Reddit Search Mcp is a reddapi.dev-powered MCP server for Reddit search and discovery. It supports people researching conversations, exploring communities, and checking trending topics through semantic search and subreddit tools.

Key features

  1. 01Search posts with natural-language semantics
  2. 02List and filter subreddits
  3. 03Get details about a subreddit
  4. 04Retrieve trending topics by popularity

Use cases

  1. 01Research Reddit discussions about a topic
  2. 02Find subreddits by name or description
  3. 03Check trending topics for a date range

MCP support

This MCP server exposes Reddit search, subreddit, and trend tools to compatible clients, powered by reddapi.dev.

#reddit

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "reddit-search": {
      "command": "npx",
      "args": [
        "-y",
        "reddit-search-mcp"
      ],
      "env": {
        "REDDAPI_API_KEY": "<REDDAPI_API_KEY>"
      }
    }
  }
}
Run commandnpx -y reddit-search-mcp
Environment variables to set
REDDAPI_API_KEYSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmreddit-search-mcp

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

reddapi.dev MCP Server

npm version MCP Registry License: MIT

A Model Context Protocol (MCP) server that provides AI-powered Reddit search and discovery capabilities. Search millions of Reddit posts with semantic AI, explore subreddits, and discover trending topics.

Powered by reddapi.dev - Reddit Search API.

Installation

npm install -g reddit-search-mcp

Or run directly with npx:

npx reddit-search-mcp

Configuration

Claude Desktop

Add to your Claude Desktop config file:

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

{
  "mcpServers": {
    "reddit-search-mcp": {
      "command": "npx",
      "args": ["reddit-search-mcp"],
      "env": {
        "REDDAPI_API_KEY": "your_api_key_here"
      }
    }
  }
}
Cursor

Add to Cursor settings (~/.cursor/mcp.json):

{
  "mcpServers": {
    "reddit-search-mcp": {
      "command": "npx",
      "args": ["reddit-search-mcp"],
      "env": {
        "REDDAPI_API_KEY": "your_api_key_here"
      }
    }
  }
}
Windsurf

Add to Windsurf MCP config (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "reddit-search-mcp": {
      "command": "npx",
      "args": ["reddit-search-mcp"],
      "env": {
        "REDDAPI_API_KEY": "your_api_key_here"
      }
    }
  }
}
VS Code (Claude Code / Cline)

Add to your VS Code settings or .mcp.json in your project:

{
  "mcpServers": {
    "reddit-search-mcp": {
      "command": "npx",
      "args": ["reddit-search-mcp"],
      "env": {
        "REDDAPI_API_KEY": "your_api_key_here"
      }
    }
  }
}
OpenClaw

Add to OpenClaw MCP config:

{
  "mcpServers": {
    "reddit-search-mcp": {
      "command": "npx",
      "args": ["reddit-search-mcp"],
      "env": {
        "REDDAPI_API_KEY": "your_api_key_here"
      }
    }
  }
}
Environment Variables
VariableRequiredDescription
REDDAPI_API_KEYNoAPI key for premium features (get at reddapi.dev)

Get your API key at reddapi.dev

Available Tools

reddit_search

Search Reddit conversations using semantic AI search.

Parameters:

  • query (string, required): Natural language search query
  • limit (number, optional): Maximum results (1-100, default: 20)

Example:

Search for discussions about mechanical keyboards for programming
reddit_list_subreddits

Get a paginated list of available subreddits.

Parameters:

  • page (number, optional): Page number (default: 1)
  • limit (number, optional): Results per page (1-100, default: 20)
  • search (string, optional): Filter by name, title, or description
reddit_get_subreddit

Get detailed information about a specific subreddit.

Parameters:

  • subreddit (string, required): Subreddit name without r/ prefix
reddit_get_trends

Get Reddit trending topics and insights sorted by popularity.

Parameters:

  • start_date (string, optional): Start date filter (ISO 8601 or YYYY-MM-DD, default: today)
  • end_date (string, optional): End date filter (ISO 8601 or YYYY-MM-DD, default: today)
  • limit (number, optional): Number of trending topics (1-100, default: 20)

Usage Examples

Research a topic:

You: What are developers saying about React Server Components?
Claude: [Uses reddit_search] Found 45 results...

Explore a community:

You: Tell me about r/typescript
Claude: [Uses reddit_get_subreddit] r/typescript has 285,432 subscribers...

Find trends:

You: What's trending in tech this week?
Claude: [Uses reddit_get_trends] Top trending topics...

Links

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.