mcpField
R
Reddit MCP Server

Reddit MCP Server

Local
github.com/mypracticaltoolsBrowser Automation7Updated 41w ago
Repository

About Reddit MCP Server

Reddit MCP Server lets AI agents search Reddit and identify potential leads using Apify cloud actors. It offers separate tools for general searches and filtered lead or brand-mention monitoring.

Key features

  1. 01Search Reddit posts, comments, and users
  2. 02Find high-intent leads
  3. 03Monitor brand mentions while filtering noise
  4. 04Delegate scraping to Apify cloud actors

Use cases

  1. 01Gather information from Reddit discussions
  2. 02Identify potential leads in Reddit content
  3. 03Track brand mentions while reducing irrelevant results

MCP support

Exposes Reddit search and lead-monitoring capabilities as MCP tools, delegating scraping to Apify cloud actors.

#reddit#leads

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-MCP-Server": {
      "command": "npx",
      "args": [
        "-y",
        "@practicaltools/reddit-mcp-server"
      ],
      "env": {
        "APIFY_API_TOKEN": "<APIFY_API_TOKEN>"
      }
    }
  }
}
Run commandnpx -y @practicaltools/reddit-mcp-server
Environment variables to set
APIFY_API_TOKENSecretYour Apify API Token

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
npm@practicaltools/reddit-mcp-server1.0.5

Tools

2

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
querystringYesThe search keyword.
subredditsarrayNoLimit search to specific subreddits (e.g., ["marketing", "SaaS"]).
limitnumberNoMax number of results.
sortenumNoSort order.relevance | hot | top | new

Details

From the project README

Reddit MCP Server 🤖

NPM Version License: MIT Build Status

An MCP server that allows AI agents to search Reddit or find specific leads by delegating the scraping task to high-performance Apify cloud actors.

🌟 Key Features

  • reddit_fast_search: Quickly search for Reddit posts, comments, or users. Best for general information gathering.
  • reddit_lead_monitor: Find high-intent leads or brand mentions while filtering out noise.

⚡️ Quick Install

Choose your platform to install Reddit MCP in seconds:

Claude Desktop (macOS/Windows)

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "reddit-mcp": {
      "command": "npx",
      "args": ["-y", "@practicaltools/reddit-mcp-server"],
      "env": {
        "APIFY_API_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}
Cursor & Windsurf
  1. Open Settings -> MCP Servers.
  2. Add a new server:
    • Name: Reddit MCP
    • Type: stdio
    • Command: npx -y @practicaltools/reddit-mcp-server
    • Env: APIFY_API_TOKEN=YOUR_TOKEN
Claude Code (CLI) 
claude-code --mcp @practicaltools/reddit-mcp-server="npx -y @practicaltools/reddit-mcp-server" --env APIFY_API_TOKEN=YOUR_TOKEN
VS Code (Copilot Agent)

Add to .vscode/mcp.json:

{
  "mcpServers": {
    "reddit-mcp": {
      "command": "npx",
      "args": ["-y", "@practicaltools/reddit-mcp-server"],
      "env": { "APIFY_API_TOKEN": "YOUR_TOKEN" }
    }
  }
}

🔑 Getting Your Apify API Token

To use this server, you need an Apify API token.

  1. Sign up/Log in: Apify Console.
  2. Settings: Click the Settings icon in the bottom-left sidebar.
  3. Integrations: Select the Integrations tab at the top.
  4. Copy Token: Copy the string at the top of the page.

🛠 Local Development

If you want to contribute or run from source:

# Install dependencies
npm install

# Build the project
npm run build

# Run locally
node dist/index.js

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

📄 License

MIT License - see LICENSE for details.

Built with ❤️ by Practical Tools

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.