Labsco
Hawstein logo

Reddit

★ 180

from Hawstein

Access Reddit's public API to browse frontpage posts, subreddit information, and read post comments.

🔥🔥🔥✓ VerifiedFreeQuick setup
#automation#git#news

MCP Server Reddit

A Model Context Protocol server providing access to Reddit public API for LLMs. This server enables LLMs to interact with Reddit's content, including browsing frontpage posts, accessing subreddit information, and reading post comments.

This server uses redditwarp to interact with Reddit's public API and exposes the functionality through MCP protocol.

Video Demo (Click to Watch)

A demo in Clinde 👇

Available Tools

get_frontpage_posts - Get hot posts from Reddit frontpage

  • Optional arguments:

  • limit (integer): Number of posts to return (default: 10, range: 1-100)

get_subreddit_info - Get information about a subreddit

  • Required arguments:

  • subreddit_name (string): Name of the subreddit (e.g. 'Python', 'news')

get_subreddit_hot_posts - Get hot posts from a specific subreddit

  • Required arguments:

  • subreddit_name (string): Name of the subreddit (e.g. 'Python', 'news')

  • Optional arguments:

  • limit (integer): Number of posts to return (default: 10, range: 1-100)

get_subreddit_new_posts - Get new posts from a specific subreddit

  • Required arguments:

  • subreddit_name (string): Name of the subreddit (e.g. 'Python', 'news')

  • Optional arguments:

  • limit (integer): Number of posts to return (default: 10, range: 1-100)

get_subreddit_top_posts - Get top posts from a specific subreddit

  • Required arguments:

  • subreddit_name (string): Name of the subreddit (e.g. 'Python', 'news')

  • Optional arguments:

  • limit (integer): Number of posts to return (default: 10, range: 1-100)

  • time (string): Time filter for top posts (default: '', options: 'hour', 'day', 'week', 'month', 'year', 'all')

get_subreddit_rising_posts - Get rising posts from a specific subreddit

  • Required arguments:

  • subreddit_name (string): Name of the subreddit (e.g. 'Python', 'news')

  • Optional arguments:

  • limit (integer): Number of posts to return (default: 10, range: 1-100)

get_post_content - Get detailed content of a specific post

  • Required arguments:

  • post_id (string): ID of the post

  • Optional arguments:

  • comment_limit (integer): Number of top-level comments to return (default: 10, range: 1-100)

  • comment_depth (integer): Maximum depth of comment tree (default: 3, range: 1-10)

get_post_comments - Get comments from a post

  • Required arguments:

  • post_id (string): ID of the post

  • Optional arguments:

  • limit (integer): Number of comments to return (default: 10, range: 1-100)

Examples of Questions

  • "What are the current hot posts on Reddit's frontpage?" (get_frontpage_posts)

  • "Tell me about the r/ClaudeAI subreddit" (get_subreddit_info)

  • "What are the hot posts in the r/ClaudeAI subreddit?" (get_subreddit_hot_posts)

  • "Show me the newest posts from r/ClaudeAI" (get_subreddit_new_posts)

  • "What are the top posts of all time in r/ClaudeAI?" (get_subreddit_top_posts)

  • "What posts are trending in r/ClaudeAI right now?" (get_subreddit_rising_posts)

  • "Get the full content and comments of this Reddit post: [post_url]" (get_post_content)

  • "Summarize the comments on this Reddit post: [post_url]" (get_post_comments)

Debugging

You can use the MCP inspector to debug the server. For uvx installations:

Copy & paste — that's it
npx @modelcontextprotocol/inspector uvx mcp-server-reddit

Or if you've installed the package in a specific directory or are developing on it:

Copy & paste — that's it
cd path/to/mcp_server_reddit
npx @modelcontextprotocol/inspector uv run mcp-server-reddit

License

mcp-server-reddit is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.