reddapi.dev MCP Server

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

| Variable | Required | Description | |----------|----------|-------------| | REDDAPI_API_KEY | No | API 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

• Website
• GitHub
• npm
• MCP Registry

License

MIT