MCP Reddit Server

A comprehensive Model Context Protocol (MCP) server for Reddit. Provides 8 tools for fetching Reddit content, a full REST API, and Azure deployment support. Works with Claude Desktop, Microsoft Copilot Studio, Power Automate, and any MCP-compatible client.

Features

• 8 Reddit Tools: Fetch hot, new, rising, and top posts from any subreddit
• Topic Aggregation: Fetch posts from multiple related subreddits by topic
• Comment Trees: Get post content with threaded comments
• Subreddit Info: Get subscriber counts and descriptions
• Multiple Connection Methods:
  • MCP Streamable HTTP (for Copilot Studio, Claude Desktop)
  • REST API with OpenAPI spec (for Power Automate, direct HTTP)
• Azure Deployment: Docker + Container Apps deployment out of the box

Available Tools

Tool	Description
reddit_hot	Get hot posts from a subreddit
reddit_new	Get newest posts from a subreddit
reddit_rising	Get rising/trending posts
reddit_top	Get top posts by time period
reddit_front	Get Reddit front page posts
reddit_post	Get post content with comments
reddit_topic	Get posts from topic-related subreddits
reddit_info	Get subreddit info (subscribers, description)

---

Quick Start

Prerequisites

1. Reddit API Credentials: Create an app at https://www.reddit.com/prefs/apps

   • Choose "script" type
   • Set redirect URI to http://localhost:8080
   • Note your Client ID and Client Secret

2. Generate Refresh Token:

   pip install praw
   python get_refresh_token.py
   

3. Create .env file:

   cp .env.example .env
   # Edit .env with your credentials
   

---

Local Development

Running Locally

# Install dependencies
pip install uv
uv sync

# Run the server
uv run uvicorn mcp_reddit.web_server:app --host 0.0.0.0 --port 8000

The server will be available at:

• REST API: http://localhost:8000
• API Docs: http://localhost:8000/docs
• MCP Endpoint: http://localhost:8000/mcp/ (requires MCP_API_KEY)

Using with Claude Desktop (Local)

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "reddit": {
      "command": "uv",
      "args": ["run", "uvicorn", "mcp_reddit.web_server:app", "--port", "8000"],
      "cwd": "/path/to/mcp-reddit",
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id",
        "REDDIT_CLIENT_SECRET": "your_client_secret",
        "REDDIT_REFRESH_TOKEN": "your_refresh_token",
        "MCP_API_KEY": "your_api_key"
      }
    }
  }
}

Or use mcp-remote to connect to a running server:

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8000/mcp/",
        "--header",
        "X-API-Key: your_api_key"
      ]
    }
  }
}

---

Azure Deployment

Option 1: Automated Deployment Script

chmod +x deploy-to-azure.sh
./deploy-to-azure.sh

The script will:

1. Create a resource group
2. Create Azure Container Registry
3. Build and push the Docker image
4. Create Container Apps environment
5. Deploy the container with your Reddit credentials

Option 2: Manual Deployment

1. Create Azure Resources

# Set variables
RESOURCE_GROUP="mcp-reddit-rg"
LOCATION="westeurope"  # or your preferred region
ACR_NAME="yourregistryname"

# Create resource group
az group create --name $RESOURCE_GROUP --location $LOCATION

# Create container registry
az acr create --name $ACR_NAME --resource-group $RESOURCE_GROUP --sku Basic --admin-enabled true

# Create container apps environment
az containerapp env create --name mcp-reddit-env --resource-group $RESOURCE_GROUP --location $LOCATION

2. Build and Push Image

az acr build --registry $ACR_NAME --image mcp-reddit:latest --file Dockerfile.azure .

3. Deploy Container App

# Get ACR password
ACR_PASSWORD=$(az acr credential show --name $ACR_NAME --query "passwords[0].value" -o tsv)

# Generate MCP API key
MCP_API_KEY=$(python -c "import secrets; print(secrets.token_urlsafe(32))")

# Create container app
az containerapp create \
  --name mcp-reddit-server \
  --resource-group $RESOURCE_GROUP \
  --environment mcp-reddit-env \
  --image $ACR_NAME.azurecr.io/mcp-reddit:latest \
  --registry-server $ACR_NAME.azurecr.io \
  --registry-username $ACR_NAME \
  --registry-password "$ACR_PASSWORD" \
  --target-port 8000 \
  --ingress external \
  --min-replicas 1 \
  --max-replicas 5 \
  --cpu 0.5 \
  --memory 1Gi \
  --secrets \
    reddit-client-id="YOUR_CLIENT_ID" \
    reddit-client-secret="YOUR_CLIENT_SECRET" \
    reddit-refresh-token="YOUR_REFRESH_TOKEN" \
    mcp-api-key="$MCP_API_KEY" \
  --env-vars \
    REDDIT_CLIENT_ID=secretref:reddit-client-id \
    REDDIT_CLIENT_SECRET=secretref:reddit-client-secret \
    REDDIT_REFRESH_TOKEN=secretref:reddit-refresh-token \
    MCP_API_KEY=secretref:mcp-api-key

4. Get Your Server URL

az containerapp show --name mcp-reddit-server --resource-group $RESOURCE_GROUP --query "properties.configuration.ingress.fqdn" -o tsv

5. (Optional) Add Custom Domain

# Add custom domain
az containerapp hostname add \
  --name mcp-reddit-server \
  --resource-group $RESOURCE_GROUP \
  --hostname your-domain.com

# Bind SSL certificate
az containerapp hostname bind \
  --name mcp-reddit-server \
  --resource-group $RESOURCE_GROUP \
  --hostname your-domain.com \
  --environment mcp-reddit-env \
  --validation-method CNAME

---

Connection Methods

1. MCP Streamable HTTP (Authenticated)

For Microsoft Copilot Studio and Claude Desktop:

Setting	Value
URL	https://your-server.com/mcp/
Auth	API Key
Header	X-API-Key

Important: The URL must have a trailing slash (/mcp/)

2. REST API / OpenAPI (No Auth Required)

For Power Automate and direct HTTP calls:

Setting	Value
Base URL	https://your-server.com
OpenAPI Spec	https://your-server.com/openapi-3.0.json
Docs	https://your-server.com/docs

REST Endpoints:

• POST /api/hot-threads - Get hot posts
• POST /api/post-content - Get post with comments
• POST /api/topic-latest - Get posts by topic
• POST /api/front-page - Get front page posts
• POST /api/subreddit-posts-by-time - Get top posts by time
• POST /api/subreddit-new-posts - Get new posts
• POST /api/subreddit-rising-posts - Get rising posts
• POST /api/subreddit-info - Get subreddit info
• GET /api/topics - List available topics

---

Configuration

Environment Variables

Variable	Required	Description
REDDIT_CLIENT_ID	Yes	Reddit app client ID
REDDIT_CLIENT_SECRET	Yes	Reddit app client secret
REDDIT_REFRESH_TOKEN	Yes	Reddit OAuth refresh token
MCP_API_KEY	No	API key for MCP endpoint authentication

Topic Categories

The server includes predefined topic categories in list.txt:

• Programming
• Tech News
• AI/ML
• Gaming
• Science
• And more...

Edit list.txt to customize topic-to-subreddit mappings.

---

Updating Deployment

# Rebuild image
az acr build --registry $ACR_NAME --image mcp-reddit:latest --file Dockerfile.azure .

# Force new revision
az containerapp update \
  --name mcp-reddit-server \
  --resource-group $RESOURCE_GROUP \
  --image $ACR_NAME.azurecr.io/mcp-reddit:latest \
  --set-env-vars FORCE_UPDATE="$(date +%s)"

---

Cleanup

# Delete all Azure resources
az group delete --name mcp-reddit-rg --yes --no-wait

---

Acknowledgments

This project was originally inspired by mcp-reddit by adhikasp, which taught us how to interface with the Reddit API via MCP. Over time the project grew significantly beyond the original scope — adding a full REST API, topic aggregation across subreddits, Azure deployment, and expanding from 2 tools to 8 — and became its own standalone project.

License

AGPL-3.0 License - see LICENSE for details.