Server data from the Official MCP Registry
Search Reddit comments and submissions via PullPush.io with filtering by subreddit, author, and date
About
Search Reddit comments and submissions via PullPush.io with filtering by subreddit, author, and date
Security Report
Valid MCP server (2 strong, 5 medium validity signals). 3 known CVEs in dependencies (0 critical, 3 high severity) Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.
11 files analyzed · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-jacklenzotti-pullpush-mcp": {
"args": [
"-y",
"pullpush-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
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:
| Parameter | Type | Description |
|---|---|---|
q | string | Search query across all comment fields |
subreddit | string | Filter by subreddit (without r/ prefix) |
author | string | Filter by username |
after | string | Results after date (epoch or relative: 30d, 1y) |
before | string | Results before date (epoch or relative: 30d, 1y) |
sort | asc | desc | Sort order (default: desc) |
sort_type | created_utc | score | Sort field (default: created_utc) |
size | number | Results to return (1-100, default: 100) |
search_submissions
Search Reddit posts/submissions with the following parameters:
| Parameter | Type | Description |
|---|---|---|
q | string | Search query across all fields |
subreddit | string | Filter by subreddit (without r/ prefix) |
author | string | Filter by username |
title | string | Search in titles only |
selftext | string | Search in post body only |
after | string | Results after date (epoch or relative: 30d, 1y) |
before | string | Results before date (epoch or relative: 30d, 1y) |
sort | asc | desc | Sort order (default: desc) |
sort_type | created_utc | score | num_comments | Sort field |
size | number | Results to return (1-100, default: 25) |
score | string | Filter by score (>100, <50, or exact) |
num_comments | string | Filter by comment count (>10, <5, or exact) |
over_18 | boolean | Filter NSFW content |
is_video | boolean | Filter video posts |
locked | boolean | Filter locked posts |
stickied | boolean | Filter stickied posts |
spoiler | boolean | Filter spoiler posts |
Installation
npm (recommended)
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
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.