Reddit MCP server for reading and searching Reddit content
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"reddit-mcp-tool","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Reddit MCP Tool A Model Context Protocol (MCP) server that provides read-only tools for browsing and searching Reddit content through Reddit's official API. Built with **FastMCP** for seamless integration and automatic serialization. This server allows you to search for posts, read post details, and get subreddit information through MCP-compatible clients. ## Features - 🔍 **Search Posts**: Search for posts in specific subreddits with various sorting and filtering options - 🌐 **Site-wide Search**: Search across all of Reddit with keyword queries - 📊 **Get Subreddit Info**: Retrieve detailed information about subreddits - 🔥 **Get Hot Posts**: Fetch hot posts from subreddits - 📋 **Get Post Details**: Get comprehensive details about specific posts - ⚡ **FastMCP Integration**: Built with FastMCP for automatic serialization and seamless MCP compatibility ## Prerequisites 1. **Python 3.10+** installed on your system 2. **uv** package manager installed ([installation guide](https://docs.astral.sh/uv/getting-started/installation/)) 3. **Reddit API credentials** (see setup section below) ## Reddit API Setup 1. **Create a Reddit App**: - Go to [Reddit App Preferences](https://old.reddit.com/prefs/apps/) - Click "Create App" or "Create Another App" - Choose "script" for the app type - Fill in the required fields: - Name: Your app name (e.g., "Reddit MCP Tool") - Description: Brief description - About URL: Can be blank - Redirect URI: http://localhost:8080 (required but not used) 2. **Get Your Credentials**: - **Client ID**: Found under your app name (short string) - **Client Secret**: Found in the app details (longer string) ## Installation 1. **Clone or download this repository**: ```bash git clone <repository-url> cd reddit-mcp-tool ``` 2. **Install dependencies using uv**: ```bash uv sync ``` 3. **Quick setup (recommended)**: ```bash uv run python scripts/setup.py ``` This will cr…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.