Reddit MCP Server

A Model Context Protocol (MCP) server that provides access to Reddit's public API for searching subreddits and fetching hot/top posts from the last 24 hours.

Features

• Search Subreddits - Find subreddits by keyword
• Get Hot Posts - Fetch hot posts from the last 24 hours
• Get Top Posts - Fetch top posts from the last 24 hours

All tools use Reddit's public JSON API (no authentication required).

Installation

NPM (Recommended)

npm install -g mcp-reddit-server

From Source

git clone <repository-url>
cd mcp-reddit-server
npm install
npm run build

Usage with Claude Code

Add the server to Claude Code:

claude mcp add mcp-reddit npx -s user mcp-reddit-server

Then restart Claude Code:

# Press Ctrl+C twice to exit
claude --continue

Available Tools

1. search_subreddits

Search for subreddits by keyword or topic.

Parameters:

• query (string, required) - Search term
• limit (number, optional) - Max results (default: 10)

Example:

Search for subreddits about "programming"

2. get_hot_posts

Get hot posts from a subreddit from the last 24 hours.

Parameters:

• subreddit (string, required) - Subreddit name (without r/)
• limit (number, optional) - Max posts (default: 25)

Example:

Get hot posts from r/programming

3. get_top_posts

Get top posts from a subreddit from the last 24 hours.

Parameters:

• subreddit (string, required) - Subreddit name (without r/)
• limit (number, optional) - Max posts (default: 25)

Example:

Get top posts from r/technology

Post Information Included

Each post includes:

• Title
• Score (upvotes)
• Number of comments
• Author username
• Post URL
• Post content/body (if available)

Testing

Test with MCP Inspector:

npm run build
npm run inspector

Requirements

• Node.js 18.0.0 or higher

License

MIT