| Tool |
Response |
Size |
| search_reddit (10 results) |
2.2s |
~7 KB |
| search_comments (10 results) |
2.5s |
~10 KB |
| browse_subreddit (10 results) |
1.9s |
~8 KB |
| get_post (10 comments) |
1.4s |
~6 KB |
| get_subreddit_info |
1.5s |
~0.4 KB |
| find_similar_subreddits |
2.9s |
~3 KB |
- `search_reddit`
- Search Reddit posts by keyword. Returns titles, scores, comment counts, flair, authors, and text previews.
- Inputs:
- `query` (string): Search query
- `subreddit` (string, optional): Subreddit to search within (without r/ prefix)
- `sort` (string, optional): "RELEVANCE", "NEW", or "TOP" (default "RELEVANCE")
- `limit` (number, optional): Number of results, 1-25 (default 10)
- **~$0.005 per call**
- `search_comments`
- Search Reddit comments by keyword. Returns comment text, authors, scores, and parent post info.
- Inputs:
- `query` (string): Search query
- `subreddit` (string, optional): Subreddit to search within (without r/ prefix)
- `sort` (string, optional): "RELEVANCE", "NEW", or "TOP" (default "RELEVANCE")
- `limit` (number, optional): Number of results, 1-25 (default 10)
- **~$0.005 per call**
- `browse_subreddit`
- Browse a subreddit's feed. Returns current posts (titles, scores, comment counts, flair) sorted by chosen order.
- Inputs:
- `subreddit` (string): Subreddit name (without r/ prefix)
- `sort` (string, optional): "HOT", "NEW", "TOP", or "RISING" (default "HOT")
- `limit` (number, optional): Number of posts, 1-25 (default 10)
- **~$0.004 per call**
- `get_post`
- Get a Reddit post with its comments by URL. Returns full post text and top comments with threading.
- Inputs:
- `url` (string): Reddit post URL (any format: reddit.com, old.reddit.com, redd.it)
- `include_comments` (boolean, optional): Whether to include comments (default true)
- `comments_limit` (number, optional): Max comments to return, 1-25 (default 10)
- **~$0.003 per call**
- `get_subreddit_info`
- Get subreddit metadata: subscribers, active users, description, type, topics, and language.
- Inputs:
- `subreddit` (string): Subreddit name (without r/ prefix)
- **~$0.002 per call**
- `find_similar_subreddits`
- Find subreddits similar to the given ones. Returns related communities with member counts and descriptions.
- Inputs:
- `subreddits` (list of strings): Subreddit names to find similar communities for (without r/ prefix)
- **~$0.002 per call**
### Quick Start
#### Search posts
```
"Search Reddit for the best mechanical keyboards under $100"
```
#### Search comments
```
"Find Reddit comments about migrating from Webpack to Vite"
```
#### Browse a subreddit
```
"Show me what's hot on r/webdev right now"
```
#### Get a specific post
```
"Get this Reddit post with comments: https://reddit.com/r/programming/comments/abc123"
```
#### Subreddit info
```
"Tell me about the r/LocalLLaMA subreddit"
```
#### Find similar communities
```
"Find subreddits similar to r/datascience and r/machinelearning"
```
### How It Works
1. **Agent connects** to the MCP server endpoint
2. **Calls tools** to search, browse, or fetch Reddit content
3. **Gets results** formatted as clean markdown for easy consumption by the AI agent
No Reddit account or API credentials needed. The server handles authentication automatically.
***
### Pricing - Pay Per Event (PPE)
| Tool | Cost | Per 1,000 calls |
|------|------|-----------------|
| Search posts | ~$0.005 | $4.99 |
| Search comments | ~$0.005 | $4.99 |
| Browse subreddit | ~$0.004 | $3.99 |
| Get post | ~$0.003 | $2.99 |
| Subreddit info | ~$0.002 | $1.99 |
| Similar subreddits | ~$0.002 | $1.99 |
***
### Configuration
No configuration required. The server works out of the box.
Replace `YOUR_APIFY_TOKEN` in all examples below with your [Apify API token](https://console.apify.com/account/integrations).
#### Usage with ChatGPT
ChatGPT supports MCP servers natively (Plus, Pro, Team, Enterprise plans).
1. Open **Settings > Connectors > Add connector**
2. Set **Name** to `Reddit`
3. Set **MCP Server URL** to:
```
https://clearpath--reddit-mcp.apify.actor/mcp
```
4. Set **Authentication** to **API Key** and set the header:
- Header name: `Authorization`
- Value: `Bearer YOUR_APIFY_TOKEN`
5. Click **Save**
6. Start a new chat, click **+** near the composer, select **More**, choose **Reddit**
#### Usage with Claude Desktop
Add to your `claude_desktop_config.json`:
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"reddit": {
"type": "http",
"url": "https://clearpath--reddit-mcp.apify.actor/mcp",
"headers": {
"Authorization": "Bearer YOUR_APIFY_TOKEN"
}
}
}
}
```
Restart Claude Desktop after saving.
#### Usage with Claude Code
```bash
claude mcp add --transport http --scope user reddit \
--header "Authorization: Bearer YOUR_APIFY_TOKEN" \
https://clearpath--reddit-mcp.apify.actor/mcp
```
Or add to your project's `.mcp.json`:
```json
{
"mcpServers": {
"reddit": {
"type": "http",
"url": "https://clearpath--reddit-mcp.apify.actor/mcp",
"headers": {
"Authorization": "Bearer ${APIFY_TOKEN}"
}
}
}
}
```
#### Usage with OpenClaw
Add to `~/.openclaw/openclaw.json`:
```json5
{
"provider": {
"mcpServers": {
"reddit": {
"url": "https://clearpath--reddit-mcp.apify.actor/mcp",
"headers": {
"Authorization": "Bearer YOUR_APIFY_TOKEN"
}
}
}
}
}
```
Then message your OpenClaw bot on Telegram, WhatsApp, or Discord:
> "Search Reddit for reviews of the Framework Laptop 16"
> "What are the top posts on r/selfhosted this week?"
> "Find subreddits similar to r/homelab"
#### Other MCP Clients
Any client supporting the Streamable HTTP transport works. Use the MCP endpoint URL with your Apify API token as a Bearer auth header.
***
### FAQ
**Do I need a Reddit account?**
No. The server handles authentication automatically. No Reddit account, API key, or OAuth setup required from your side.
**How do search results connect to get_post?**
Search and browse tools return permalinks. Pass any permalink to `get_post` to fetch the full post text and comment thread.
**Are NSFW results included?**
No. NSFW content is filtered out by default.
**Can I search within a specific subreddit?**
Yes. Pass the `subreddit` parameter (without the r/ prefix) to `search_reddit` or `search_comments` to scope results to that community.
**How many results can I get per call?**
Up to 25 results per tool call for all search and browse tools.
**Can I use this without an AI assistant?**
Yes. Any MCP client works. You can also call tools programmatically via any MCP SDK.
**What data does get_post return?**
Full post text, score, author, comment count, and threaded comments with depth indicators, scores, and timestamps.
***
### More Clearpath scrapers for Reddit
**๐ Search & discovery**
- 
Reddit MCP
Search
Comments
Subreddits
Profiles
**[Reddit User Posts & Comments Scraper](https://apify.com/clearpath/reddit-user-content-scraper)**
**[Reddit Answers API](https://apify.com/clearpath/reddit-answers-api)**
**[Reddit to LLM](https://apify.com/clearpath/reddit-to-llm-api)**