Reddit MCP Server
MCP server for Reddit API - Access Reddit data through a unified API interface with TOON format for 90%+ token savings.
Features
- Fetch hot/new/top posts from any subreddit
- Get detailed post content including comment trees
- Search Reddit posts by query
- Get user profile information and activity
- Get subreddit information
- Returns data in TOON format for token efficiency
- Proxy support for enterprise environments
Installation
npm install @yilin-jing/reddit-mcp
Or run directly:
npx @yilin-jing/reddit-mcp
Configuration
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"reddit": {
"command": "npx",
"args": ["-y", "@yilin-jing/reddit-mcp"],
"env": {}
}
}
}
Environment Variables (Optional)
PROXY_URL- HTTP/HTTPS proxy URLHTTP_PROXY- Alternative proxy settingHTTPS_PROXY- Alternative proxy setting
Available Tools
| Tool | Description |
|---|---|
get_subreddit_hot | Get hot posts from a subreddit |
get_subreddit_new | Get new posts from a subreddit |
get_subreddit_top | Get top posts from a subreddit (with time filter) |
get_post_content | Get post details with comments tree |
search_posts | Search Reddit posts by query |
get_user_info | Get Reddit user profile information |
get_user_posts | Get posts submitted by a user |
get_user_comments | Get comments made by a user |
get_subreddit_info | Get subreddit information |
Usage Examples
Get Hot Posts from a Subreddit
Tool: get_subreddit_hot
Args: { "subreddit": "programming", "limit": 10 }
Get Top Posts of the Week
Tool: get_subreddit_top
Args: { "subreddit": "askreddit", "time": "week", "limit": 20 }
Get Post Content with Comments
Tool: get_post_content
Args: { "post_id": "abc123", "comment_limit": 30, "comment_depth": 5 }
Search Posts
Tool: search_posts
Args: { "query": "typescript tutorial", "subreddit": "programming", "sort": "top", "time": "month" }
Get User Information
Tool: get_user_info
Args: { "username": "spez" }
Output Format
All responses are returned in TOON format for maximum token efficiency. Example cleaned post data:
id:"abc123"
title:"Example Post Title"
subreddit:"programming"
author:"username"
score:1234
upvoteRatio:0.95
comments:56
created:"2024-01-15T10:30:00.000Z"
url:"https://example.com"
permalink:"https://reddit.com/r/programming/comments/abc123/example_post/"
Development
# Install dependencies
npm install
# Build
npm run build
# Run in development
npm run dev
# Run tests
npm test
License
MIT