{
  "markdown": "# Reddit MCP Server 🤖\n[![NPM Version](https://img.shields.io/npm/v/@practicaltools/reddit-mcp-server?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@practicaltools/reddit-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)\n[![Build Status](https://img.shields.io/github/actions/workflow/status/mypracticaltools/Reddit-MCP-Server/build.yml?style=flat-square)](https://github.com/mypracticaltools/Reddit-MCP-Server/actions)\n\nAn MCP server that allows AI agents to search Reddit or find specific leads by delegating the scraping task to high-performance Apify cloud actors.\n\n## 🌟 Key Features\n\n- **`reddit_fast_search`**: Quickly search for Reddit posts, comments, or users. Best for general information gathering.\n- **`reddit_lead_monitor`**: Find high-intent leads or brand mentions while filtering out noise.\n\n---\n\n## ⚡️ Quick Install\n\nChoose your platform to install **Reddit MCP** in seconds:\n\n<details>\n<summary><b>Claude Desktop (macOS/Windows)</b></summary>\n\nAdd this to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"reddit-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@practicaltools/reddit-mcp-server\"],\n      \"env\": {\n        \"APIFY_API_TOKEN\": \"YOUR_APIFY_TOKEN\"\n      }\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><b>Cursor & Windsurf</b></summary>\n\n1. Open **Settings** -> **MCP Servers**.\n2. Add a new server:\n   - **Name**: `Reddit MCP`\n   - **Type**: `stdio`\n   - **Command**: `npx -y @practicaltools/reddit-mcp-server`\n   - **Env**: `APIFY_API_TOKEN=YOUR_TOKEN`\n</details>\n\n<details>\n<summary><b>Claude Code (CLI)</b></summary>\n\n```bash\nclaude-code --mcp @practicaltools/reddit-mcp-server=\"npx -y @practicaltools/reddit-mcp-server\" --env APIFY_API_TOKEN=YOUR_TOKEN\n```\n</details>\n\n<details>\n<summary><b>VS Code (Copilot Agent)</b></summary>\n\nAdd to `.vscode/mcp.json`:\n```json\n{\n  \"mcpServers\": {\n    \"reddit-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@practicaltools/reddit-mcp-server\"],\n      \"env\": { \"APIFY_API_TOKEN\": \"YOUR_TOKEN\" }\n    }\n  }\n}\n```\n</details>\n\n---\n\n## 🔑 Getting Your Apify API Token\n\nTo use this server, you need an Apify API token.\n\n1.  **Sign up/Log in**: [Apify Console](https://console.apify.com/).\n2.  **Settings**: Click the **Settings** icon in the bottom-left sidebar.\n3.  **Integrations**: Select the **Integrations** tab at the top.\n4.  **Copy Token**: Copy the string at the top of the page.\n\n---\n\n## 🛠 Local Development\n\nIf you want to contribute or run from source:\n\n```bash\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n\n# Run locally\nnode dist/index.js\n```\n\n## 🤝 Contributing\nContributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## 📄 License\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n<p align=\"center\">\n  Built with ❤️ by <a href=\"https://github.com/mypracticaltools\">Practical Tools</a>\n</p>\n",
  "bytes": 2973,
  "sha": "82cf1e6ef70836a8fda456980e3f56766d414cd7362b3369bae5bb145cbb6e99",
  "repo_slug": "mypracticaltools/reddit-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mypracticaltools_reddit_mcp_se_0a69207e/readme"
}