Reddit

This Reddit MCP Server exposes two primary capabilities: reddit_fast_search and reddit_lead_monitor. reddit_fast_search lets AI agents perform quick searches across Reddit posts, comments, and users to surface relevant information. reddit_lead_monitor is geared toward identifying high-intent leads or brand mentions while filtering out noise. When running the MCP server with the provided command, you can invoke these tools through your MCP client by specifying the tool name and the corresponding search parameters. For example, you might request a fast search for a topic like 'privacy policy' or monitor for brand mentions of a company across Reddit discussions. The server handles the scraping by delegating the heavy lifting to Apify cloud actors, returning structured results suitable for downstream agents or pipelines.

Prerequisites:

• Node.js (LTS) and npm installed on your machine
• An Apify API token (required for API access)

Installation steps:

1. Install dependencies and build from source (optional if using the published package):

npm install
npm run build

2. Run the MCP server locally (via npx as suggested in the README):

APIFY_API_TOKEN=YOUR_TOKEN npx -y @practicaltools/reddit-mcp-server

3. Alternatively, use the token in a configuration file for your MCP client (see mcp_config example) and start the server accordingly.
4. If you’re integrating with Claude/Copilot/VS Code setups, ensure your environment variables (like APIFY_API_TOKEN) are correctly provided in the respective config snippets.

Notes:

• Replace YOUR_TOKEN with a valid Apify API token.
• You can also embed the same command in your editor-specific MCP settings (as shown in the README) to streamline usage.

Tips and notes:

• APIFY_API_TOKEN is required for accessing Apify cloud actors used by the server. Keep it secure and do not commit to public repos.
• The server name in the MCP config is reddit-mcp; you can adapt the name if you run multiple MCPs.
• If you encounter connectivity or token issues, verify that the token is active and that network access to Apify endpoints is allowed in your environment.
• This MCP exposes two tools: reddit_fast_search and reddit_lead_monitor. Refer to your MCP client’s tool invocation format to call them with the appropriate parameters (e.g., search terms, filters, limits).
• For local development, you can run node dist/index.js after building to start the server directly from source.