Reddit MCP

Reddit data as a REST API and MCP server. No API key needed.

Live Cloudflare Workers MCP Compatible v1.0.0

REST API

GET /api/search?q={query} Try it → Search Reddit for posts, comments, subreddits, or users

GET /api/r/{subreddit} Try it → Get subreddit info — subscribers, description, rules

GET /api/r/{subreddit}/posts Try it → Get posts from a subreddit with sort & time filters

GET /api/post/{id} Get a post by ID, optionally with comments

GET /api/user/{username} Try it → Get a user profile — karma, account age, etc.

GET /api/user/{username}/activity Get a user's recent posts and comments

POST /api/feed Combined feed from multiple subreddits, merged by date

Quick Start

# Search Reddit
curl "https://reddit-mcp.chaturchacharost.workers.dev/api/search?q=rust+programming&limit=5"

# Get top posts from r/webdev
curl "https://reddit-mcp.chaturchacharost.workers.dev/api/r/webdev/posts?sort=top&time=week&limit=10"

# Multi-subreddit feed
curl -X POST "https://reddit-mcp.chaturchacharost.workers.dev/api/feed" \
  -H "Content-Type: application/json" \
  -d '{"subreddits":["typescript","rust","golang"],"limit":15}'

MCP Server

This server speaks the Model Context Protocol over Streamable HTTP. Connect any MCP client — no API key needed.

https://reddit-mcp.chaturchacharost.workers.dev/mcp

Available tools:

search_reddit

get_post

get_subreddit

get_subreddit_posts

get_user

get_user_activity

get_multi_feed

Install

Claude Desktop

Claude Desktop only supports stdio servers natively, so bridge through mcp-remote. Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["mcp-remote", "https://reddit-mcp.chaturchacharost.workers.dev/mcp"]
    }
  }
}

Claude Code (CLI)

Run this in your terminal:

claude mcp add reddit --transport http https://reddit-mcp.chaturchacharost.workers.dev/mcp

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "reddit": {
      "url": "https://reddit-mcp.chaturchacharost.workers.dev/mcp"
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "reddit": {
      "serverUrl": "https://reddit-mcp.chaturchacharost.workers.dev/mcp"
    }
  }
}

Cline (VS Code)

Open Cline settings → MCP Servers → add:

{
  "mcpServers": {
    "reddit": {
      "type": "streamableHttp",
      "url": "https://reddit-mcp.chaturchacharost.workers.dev/mcp"
    }
  }
}

Local (stdio via npx)

Run the MCP server locally with Bun:

# Clone and run
git clone https://github.com/your-org/reddit-mcp.git
cd reddit-mcp && bun install
bun run start

Then add to your MCP client config:

{
  "mcpServers": {
    "reddit": {
      "command": "bun",
      "args": ["run", "start"],
      "cwd": "/path/to/reddit-mcp"
    }
  }
}

Tool Reference

search_reddit

Search Reddit for posts, comments, subreddits, or users.

query (required), type, sort, time, subreddit, limit, after

get_post

Get a Reddit post by ID, optionally with comments.

postId (required), includeComments, commentSort, commentLimit, commentDepth

get_subreddit

Get information about a subreddit.

name (required)

get_subreddit_posts

Get posts from a subreddit with sort and time filters.

subreddit (required), sort, time, limit, after

get_user

Get a Reddit user profile.

username (required)

get_user_activity

Get a user's recent posts and comments.

username (required), type, sort, time, limit, after

get_multi_feed

Combined feed from multiple subreddits, merged and sorted.

subreddits (required), sort, time, limit, perSubreddit