{
  "markdown": "# pullpush-mcp\n\nAn MCP (Model Context Protocol) server for the [PullPush.io](https://pullpush.io/) Reddit API. This allows Claude and other MCP-compatible AI assistants to search Reddit comments and submissions.\n\nPullPush.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.\n\n## Tools\n\n### `search_comments`\n\nSearch Reddit comments with the following parameters:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `q` | string | Search query across all comment fields |\n| `subreddit` | string | Filter by subreddit (without r/ prefix) |\n| `author` | string | Filter by username |\n| `after` | string | Results after date (epoch or relative: `30d`, `1y`) |\n| `before` | string | Results before date (epoch or relative: `30d`, `1y`) |\n| `sort` | `asc` \\| `desc` | Sort order (default: desc) |\n| `sort_type` | `created_utc` \\| `score` | Sort field (default: created_utc) |\n| `size` | number | Results to return (1-100, default: 100) |\n\n### `search_submissions`\n\nSearch Reddit posts/submissions with the following parameters:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `q` | string | Search query across all fields |\n| `subreddit` | string | Filter by subreddit (without r/ prefix) |\n| `author` | string | Filter by username |\n| `title` | string | Search in titles only |\n| `selftext` | string | Search in post body only |\n| `after` | string | Results after date (epoch or relative: `30d`, `1y`) |\n| `before` | string | Results before date (epoch or relative: `30d`, `1y`) |\n| `sort` | `asc` \\| `desc` | Sort order (default: desc) |\n| `sort_type` | `created_utc` \\| `score` \\| `num_comments` | Sort field |\n| `size` | number | Results to return (1-100, default: 25) |\n| `score` | string | Filter by score (`>100`, `<50`, or exact) |\n| `num_comments` | string | Filter by comment count (`>10`, `<5`, or exact) |\n| `over_18` | boolean | Filter NSFW content |\n| `is_video` | boolean | Filter video posts |\n| `locked` | boolean | Filter locked posts |\n| `stickied` | boolean | Filter stickied posts |\n| `spoiler` | boolean | Filter spoiler posts |\n\n## Installation\n\n### npm (recommended)\n\n```bash\nnpm install -g pullpush-mcp\n```\n\n### From source\n\n```bash\ngit clone https://github.com/jacklenzotti/pullpush-mcp.git\ncd pullpush-mcp\nnpm install\nnpm run build\n```\n\n## Usage with Claude Desktop\n\nAdd to your Claude Desktop config file:\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nUsing npm (recommended):\n\n```json\n{\n  \"mcpServers\": {\n    \"pullpush\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"pullpush-mcp\"]\n    }\n  }\n}\n```\n\nUsing a local build:\n\n```json\n{\n  \"mcpServers\": {\n    \"pullpush\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/pullpush-mcp/build/index.js\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop after updating the config.\n\n## Example Prompts\n\nOnce configured, you can ask Claude:\n\n- \"Find all posts by user spez from the last year\"\n- \"Search for comments mentioning 'typescript' in r/programming\"\n- \"Show me the top 20 posts in r/LocalLLaMA sorted by score\"\n- \"Find comments by user GovSchwarzenegger\"\n- \"Search r/machinelearning for posts about transformers with more than 100 upvotes\"\n\n## Development\n\n```bash\n# Build\nnpm run build\n\n# Type check\nnpm run typecheck\n\n# Test with MCP Inspector\nnpm run inspect\n```\n\n## API Reference\n\nThis server uses the [PullPush.io API](https://pullpush.io/). PullPush provides free access to Reddit's historical data without requiring authentication.\n\n## License\n\nMIT\n",
  "bytes": 3674,
  "sha": "cebedabea7fc1967652863cc11e5852e97c45587d8022448c7ac4b5f0d589238",
  "repo_slug": "jacklenzotti/pullpush-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jacklenzotti_pullpush_mcp_9ee9d561/readme"
}