Which integrations are available for this server?

Provides tools for fetching Reddit content, including hot, new, rising, top posts, comment trees, subreddit info, and topic aggregation across multiple subreddits.

How do I use MCP Reddit Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Reddit Server show me hot posts from r/programming" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

MCP Reddit Server

by Aanerud

Overview Schema Related Servers Score Discussions

Python

Hybrid

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

Related MCP server: reddit-mcp

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

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

Generate Refresh Token:

pip install praw
python get_refresh_token.py

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:

Create a resource group
Create Azure Container Registry
Build and push the Docker image
Create Container Apps environment
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.

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Aanerud/Reddit-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server