Pullpush MCP

🚀 pullpush-mcp

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

PullPush.io offers access to Reddit's historical data, facilitating searches for posts and comments that might no longer be accessible via Reddit's official API.

🚀 Quick Start

This project is an MCP server for the PullPush.io Reddit API. It allows AI assistants like Claude to search Reddit content.

✨ Features

• Search Functionality: Supports searching both Reddit comments and submissions with various filtering and sorting options.
• Historical Data Access: Leverages PullPush.io to access Reddit's historical data.
• Claude Integration: Can be integrated with Claude Desktop for seamless use.

📦 Installation

git clone https://github.com/yourusername/pullpush-mcp.git
cd pullpush-mcp
npm install
npm run build

💻 Usage Examples

Usage with Claude Desktop

Add the following configuration to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "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 questions like:

• "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"

📚 Documentation

search_comments

Search Reddit comments using the following parameters:

search_submissions

Search Reddit posts/submissions with the following parameters:

🔧 Technical Details

This server utilizes the PullPush.io API. PullPush offers free access to Reddit's historical data without the need for authentication.

📄 License

This project is licensed under the MIT license.