home / mcp / reddit mcp server

Reddit MCP Server

Provides Reddit data access and lead monitoring via MCP endpoints by delegating tasks to Apify cloud actors.

Installation

Add the following to your MCP client configuration file.

Configuration

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

You can run a Reddit MCP Server that lets AI agents search Reddit or find high-intent leads by delegating scraping tasks to high-performance Apify cloud actors. This server enables fast information gathering and lead monitoring by exposing MCP-compatible endpoints you can call from your agents or clients.

How to use

Connect your MCP client to the Reddit MCP Server and invoke the available capabilities to search Reddit content or monitor for brand mentions and leads. Use the server to integrate Reddit data into your agent workflows, filtering noise and focusing on high-value signals.

How to install

Choose your platform and follow the platform-specific setup steps. The server is run via an MCP client command, often using npx to execute the package and pass configuration through environment variables.

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

If you are using Claude Desktop (macOS/Windows), add the above JSON to your claude_desktop_config.json under the mcpServers section.

If you are using Cursor & Windsurf, open Settings → MCP Servers, add a new server with:
- Name: Reddit MCP
- Type: stdio
- Command: `npx -y @practicaltools/reddit-mcp-server`
- Env: `APIFY_API_TOKEN=YOUR_TOKEN

If you are using Claude Code (CLI), run:

```
claude-code --mcp @practicaltools/reddit-mcp-server="npx -y @practicaltools/reddit-mcp-server" --env APIFY_API_TOKEN=YOUR_TOKEN

If you are using VS Code (Copilot Agent), add the following to `.vscode/mcp.json`:

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

Additional sections

Getting your Apify API token To use this server you need an Apify API token.

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

Local development If you want to contribute or run from source, install dependencies, build, then run locally.

# Install dependencies
npm install

# Build the project
npm run build

# Run locally
node dist/index.js

Available tools

reddit_fast_search

Quickly search Reddit posts, comments, or users for general information gathering.

reddit_lead_monitor

Find high-intent leads or brand mentions while filtering out noise.