Reddit MCP Server | Instant Post & Comment Search

From Clearpath, creators of Reddit Search, Post Comments and Subreddit Posts, with 150,000+ combined lifetime runs across those three actors. Bring that Reddit toolkit into your AI assistant.

Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

clearpath/reddit-mcp on Apify (MCP server). Base URL: https://clearpath--reddit-mcp.apify.actor. Auth: Authorization: Bearer TOKEN. Endpoints: /mcp (MCP server with 6 data tools: search_reddit, search_comments, browse_subreddit, get_post, get_subreddit_info, find_similar_subreddits, plus report_feedback, which is always free: before you switch to another tool or give up, call it with what you needed and what you got instead, and the maintainers read the note). Full API spec: GET https://api.apify.com/v2/acts/clearpath~reddit-mcp/builds/default (Bearer TOKEN) → readme, actorDefinition. Pricing: pay-per-event, ~$0.002-$0.005 per tool call. Get token: https://console.apify.com/account/integrations

Why choose this actor?

• Research Reddit through one connection. Six tools let your assistant search posts, search comments, browse feeds, open a post, inspect a subreddit and find related communities. No Reddit account or Reddit API key is required.
• Find what people say, with the context attached. Comment search returns text previews, authors, scores, parent-post titles and source links. Open a post to get its full text and a sample of comments, then follow the links for further reading.
• Discover where the conversation happens. Explore related subreddits, compare their descriptions and member counts, and browse posts by Hot, New, Top or Rising. Responses arrive as compact Markdown your assistant can use directly.

Try a comment search

Connect a compatible MCP client to:

https://clearpath--reddit-mcp.apify.actor/mcp

Authenticate with Authorization: Bearer YOUR_APIFY_TOKEN, using your Apify token. Then ask your assistant to find five comments about durable backpacks in r/BuyItForLife, or call search_comments with:

{
  "query": "durable backpack",
  "subreddit": "BuyItForLife",
  "sort": "RELEVANCE",
  "limit": 5
}

Open the actor for connection details. Queries go through MCP; the actor input form needs no search configuration. This example costs $0.00499 in comment-search charges.

Search and feed tools return up to 25 results per call; post lookup returns up to 25 comments. Search responses contain text previews. Use the linked bulk actors below for larger exports and deeper comment collection.

Clearpath · Reddit Suite

Reddit MCP You are here Search Posts & comments Comments Threads & replies Subreddits Community feeds Profiles Karma & accounts

Tools & Response Times

6 tools, all under 3 seconds:

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.

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

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

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:

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

{
  "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 Search Scraper
  Keyword search across all of Reddit
• Reddit Subreddit Posts Scraper
  Full subreddit feeds: hot, new, top, rising

💬 Threads & comments

• Reddit Post Comments Scraper
  Full comment trees and nested replies from any post URL

👤 Users

• Reddit Profile Scraper
  Bulk username, karma, and account lookup
• Reddit User Posts & Comments Scraper
  A single user's full post and comment history

🤖 AI & LLM tools

• Reddit Answers API
  Reddit's AI answer engine for any question
• Reddit to LLM
  Clean Reddit threads as Markdown for AI pipelines

Also from the same studio (name, then account/slug for the URL https://apify.com/account/slug):

• Bluesky Scraper (clearpath/bluesky-scraper)

Full directory: Clearpath on Apify

Support

• Email: max@mapa.slmail.me
• Bugs: Issues tab

---

Search Reddit posts and comments, browse subreddits, and discover communities through AI agents.