English Français العربية

PullPush Reddit

Official registry Search and web

Search Reddit comments and submissions via PullPush.io with filtering by subreddit, author, and date

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package pullpush-mcp
Claude Code 
claude mcp add pullpush-reddit -- npx -y pullpush-mcp@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pullpush-reddit": {
            "command": "npx",
            "args": [
                "-y",
                "pullpush-mcp@1.0.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. pullpush-mcp
  2. Tools
  3. Installation
  4. Usage with Claude Desktop
  5. Example Prompts
  6. Development
  7. API Reference
  8. License

pullpush-mcp

An MCP (Model Context Protocol) server for the PullPush.io Reddit API. This allows Claude and other MCP-compatible AI assistants to search Reddit comments and submissions.

PullPush.io provides access to Reddit's historical data, making it possible to search posts and comments that may no longer be available through Reddit's official API.

Tools

search_comments

Search Reddit comments with the following parameters:

ParameterTypeDescription
qstringSearch query across all comment fields
subredditstringFilter by subreddit (without r/ prefix)
authorstringFilter by username
afterstringResults after date (epoch or relative: 30d, 1y)
beforestringResults before date (epoch or relative: 30d, 1y)
sortasc \descSort order (default: desc)
sort_typecreated_utc \scoreSort field (default: created_utc)
sizenumberResults to return (1-100, default: 100)
search_submissions

Search Reddit posts/submissions with the following parameters:

ParameterTypeDescription
qstringSearch query across all fields
subredditstringFilter by subreddit (without r/ prefix)
authorstringFilter by username
titlestringSearch in titles only
selftextstringSearch in post body only
afterstringResults after date (epoch or relative: 30d, 1y)
beforestringResults before date (epoch or relative: 30d, 1y)
sortasc \descSort order (default: desc)
sort_typecreated_utc \score \num_commentsSort field
sizenumberResults to return (1-100, default: 25)
scorestringFilter by score (>100, <50, or exact)
num_commentsstringFilter by comment count (>10, <5, or exact)
over_18booleanFilter NSFW content
is_videobooleanFilter video posts
lockedbooleanFilter locked posts
stickiedbooleanFilter stickied posts
spoilerbooleanFilter spoiler posts

Installation

npm install -g pullpush-mcp
From source
git clone https://github.com/jacklenzotti/pullpush-mcp.git
cd pullpush-mcp
npm install
npm run build

Usage with 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

Using npm (recommended):

{
  "mcpServers": {
    "pullpush": {
      "command": "npx",
      "args": ["-y", "pullpush-mcp"]
    }
  }
}

Using a local build:

{
  "mcpServers": {
    "pullpush": {
      "command": "node",
      "args": ["/absolute/path/to/pullpush-mcp/build/index.js"]
    }
  }
}

Restart Claude Desktop after updating the config.

Example Prompts

Once configured, you can ask Claude:

  • "Find all posts by user spez from the last year"
  • "Search for comments mentioning 'typescript' in r/programming"
  • "Show me the top 20 posts in r/LocalLLaMA sorted by score"
  • "Find comments by user GovSchwarzenegger"
  • "Search r/machinelearning for posts about transformers with more than 100 upvotes"

Development

# Build
npm run build

# Type check
npm run typecheck

# Test with MCP Inspector
npm run inspect

API Reference

This server uses the PullPush.io API. PullPush provides free access to Reddit's historical data without requiring authentication.

License

MIT

Frequently asked questions

What is PullPush Reddit?

Search Reddit comments and submissions via PullPush.io with filtering by subreddit, author, and date

How do I install PullPush Reddit?

It runs on your machine. In Claude Code: claude mcp add pullpush-reddit -- npx -y pullpush-mcp@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does PullPush Reddit need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is PullPush Reddit open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains PullPush Reddit?

It is published by jacklenzotti. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.