get_subreddit_top_posts

Retrieve top posts from any subreddit using time filters and customizable limits to monitor trending discussions and content.

Instructions

Get top posts from a specific subreddit

Input Schema

TableJSON Schema

Name	Required	Description
`subreddit_name`	Yes	Name of the subreddit (e.g. 'Python', 'news')
`limit`	No	Number of posts to return (default: 10)
`time`	No	Time filter for top posts (e.g. 'hour', 'day', 'week', 'month', 'year', 'all')

Implementation Reference

src/mcp_server_reddit/server.py:159-164 (handler)

The core handler function in the RedditServer class that fetches the top posts from a subreddit using the redditwarp client, builds Post objects using the _build_post helper, and returns the list.

def get_subreddit_top_posts(self, subreddit_name: str, limit: int = 10, time: str = '') -> list[Post]:
    """Get top posts from a specific subreddit"""
    posts = []
    for subm in self.client.p.subreddit.pull.top(subreddit_name, limit, time=time):
        posts.append(self._build_post(subm))
    return posts

src/mcp_server_reddit/server.py:277-299 (schema)

Input JSON schema for the get_subreddit_top_posts tool, defining parameters subreddit_name (required), limit, and time filter.

inputSchema={
    "type": "object",
    "properties": {
        "subreddit_name": {
            "type": "string",
            "description": "Name of the subreddit (e.g. 'Python', 'news')",
        },
        "limit": {
            "type": "integer",
            "description": "Number of posts to return (default: 10)",
            "default": 10,
            "minimum": 1,
            "maximum": 100
        },
        "time": {
            "type": "string",
            "description": "Time filter for top posts (e.g. 'hour', 'day', 'week', 'month', 'year', 'all')",
            "default": "",
            "enum": ["", "hour", "day", "week", "month", "year", "all"]
        }
    },
    "required": ["subreddit_name"]
}

src/mcp_server_reddit/server.py:274-300 (registration)

Registration of the get_subreddit_top_posts tool in the list_tools() handler, including name, description, and input schema.

Tool(
    name=RedditTools.GET_SUBREDDIT_TOP_POSTS.value,
    description="Get top posts from a specific subreddit",
    inputSchema={
        "type": "object",
        "properties": {
            "subreddit_name": {
                "type": "string",
                "description": "Name of the subreddit (e.g. 'Python', 'news')",
            },
            "limit": {
                "type": "integer",
                "description": "Number of posts to return (default: 10)",
                "default": 10,
                "minimum": 1,
                "maximum": 100
            },
            "time": {
                "type": "string",
                "description": "Time filter for top posts (e.g. 'hour', 'day', 'week', 'month', 'year', 'all')",
                "default": "",
                "enum": ["", "hour", "day", "week", "month", "year", "all"]
            }
        },
        "required": ["subreddit_name"]
    }
),

src/mcp_server_reddit/server.py:404-410 (handler)

Dispatch logic in the MCP server's call_tool handler that extracts arguments and calls the get_subreddit_top_posts method on the RedditServer instance.

case RedditTools.GET_SUBREDDIT_TOP_POSTS.value:
    subreddit_name = arguments.get("subreddit_name")
    if not subreddit_name:
        raise ValueError("Missing required argument: subreddit_name")
    limit = arguments.get("limit", 10)
    time = arguments.get("time", "")
    result = reddit_server.get_subreddit_top_posts(subreddit_name, limit, time)

src/mcp_server_reddit/server.py:94-107 (helper)

Helper function used by get_subreddit_top_posts to construct Post model instances from redditwarp submission objects.

def _build_post(self, submission) -> Post:
    """Helper method to build Post object from submission"""
    return Post(
        id=submission.id36,
        title=submission.title,
        author=submission.author_display_name or '[deleted]',
        score=submission.score,
        subreddit=submission.subreddit.name,
        url=submission.permalink,
        created_at=submission.created_at.astimezone().isoformat(),
        comment_count=submission.comment_count,
        post_type=self._get_post_type(submission),
        content=self._get_post_content(submission)
    )

MCP Server Reddit