get_post_comments

Retrieve comments from Reddit posts by providing a post ID, with configurable limits for comment quantity.

Instructions

Get comments from a post

Input Schema

TableJSON Schema

Name	Required	Description	Default
`post_id`	Yes	ID of the post
`limit`	No	Number of comments to return (default: 10)

Implementation Reference

src/mcp_server_reddit/server.py:183-191 (handler)

The core handler function that fetches the comment tree from Reddit using redditwarp.Client and constructs a flat list of top-level Comment objects using the _build_comment_tree helper.

def get_post_comments(self, post_id: str, limit: int = 10) -> list[Comment]:
    """Get comments from a post"""
    comments = []
    tree_node = self.client.p.comment_tree.fetch(post_id, sort='top', limit=limit)
    for node in tree_node.children:
        comment = self._build_comment_tree(node)
        if comment:
            comments.append(comment)
    return comments

src/mcp_server_reddit/server.py:350-370 (schema)

The input schema definition for the get_post_comments tool, registered in the list_tools handler.

Tool(
    name=RedditTools.GET_POST_COMMENTS.value,
    description="Get comments from a post",
    inputSchema={
        "type": "object",
        "properties": {
            "post_id": {
                "type": "string",
                "description": "ID of the post",
            },
            "limit": {
                "type": "integer",
                "description": "Number of comments to return (default: 10)",
                "default": 10,
                "minimum": 1,
                "maximum": 100
            }
        },
        "required": ["post_id"]
    }
),

src/mcp_server_reddit/server.py:427-432 (registration)

The dispatch case in the call_tool handler that validates arguments and invokes the get_post_comments method.

case RedditTools.GET_POST_COMMENTS.value:
    post_id = arguments.get("post_id")
    if not post_id:
        raise ValueError("Missing required argument: post_id")
    limit = arguments.get("limit", 10)
    result = reddit_server.get_post_comments(post_id, limit)

src/mcp_server_reddit/server.py:125-144 (helper)

Recursive helper function to build nested Comment objects from the redditwarp comment tree node, limiting depth to prevent excessive recursion.

def _build_comment_tree(self, node, depth: int = 3) -> Comment | None:
    """Helper method to recursively build comment tree"""
    if depth <= 0 or not node:
        return None

    comment = node.value
    replies = []
    for child in node.children:
        child_comment = self._build_comment_tree(child, depth - 1)
        if child_comment:
            replies.append(child_comment)

    return Comment(
        id=comment.id36,
        author=comment.author_display_name or '[deleted]',
        body=comment.body,
        score=comment.score,
        replies=replies
    )

src/mcp_server_reddit/server.py:49-54 (schema)
Pydantic model defining the structure of a Comment, used as return type for get_post_comments.
```
class Comment(BaseModel):
    id: str
    author: str
    body: str
    score: int
    replies: list['Comment'] = []
```

MCP Server Reddit