Reddit MCP Server | Instant Post & Comment Search

Search Reddit posts and comments, browse subreddits, get post details, and discover communities through AI assistants like Claude, ChatGPT, and OpenClaw.

Fast. Results in 1-3 seconds per tool call. No queue, no waiting.

Stateful MCP server running in Apify Standby mode. Persistent session with no cold starts.

MCP endpoint:

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

 

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, 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 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.

---

Support

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

---

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