get_comments_by_submission

Extract and analyze comments from a Reddit submission using the submission ID, optionally replacing MoreComments with detailed replies for comprehensive insights.

Instructions

Retrieve comments from a specific submission.

Args:
    submission_id: ID of the submission to get comments from
    replace_more: Whether to replace MoreComments objects with actual comments

Returns:
    List of comments with their replies

Input Schema

TableJSON Schema

Name	Required	Description	Default
`replace_more`	No
`submission_id`	Yes

Implementation Reference

src/reddit_mcp/tools/get_comments.py:48-70 (handler)

The main handler function implementing the tool logic to fetch comments from a Reddit submission, process them recursively, and return structured data.

@validate_call(validate_return=True)
def get_comments_by_submission(
    submission_id: str, replace_more: bool = True
) -> List[CommentResult]:
    """
    Retrieve comments from a specific submission.

    Args:
        submission_id: ID of the submission to get comments from
        replace_more: Whether to replace MoreComments objects with actual comments

    Returns:
        List of comments with their replies
    """
    client = RedditClient.get_instance()
    submission = client.reddit.submission(submission_id)
    if replace_more:
        submission.comments.replace_more()
    return [
        result
        for comment in submission.comments.list()
        if (result := comment_to_model(comment)) is not None
    ]

src/reddit_mcp/tools/get_comments.py:8-24 (schema)

Pydantic BaseModel defining the schema for comment data, including nested replies, used for validation and typing.

class CommentResult(BaseModel):
    """Reddit comment details"""

    id: str = Field(description="Unique identifier of the comment")
    body: str = Field(description="Text content of the comment")
    author: str | None = Field(description="Username of the author, or None if deleted")
    created_utc: str = Field(description="UTC timestamp when comment was created")
    is_submitter: bool = Field(
        description="Whether the comment author is the submission author"
    )
    score: int = Field(description="Number of upvotes minus downvotes")
    replies: List["CommentResult"] = Field(
        description="List of reply comments", default_factory=list
    )


CommentResult.model_rebuild()  # Required for self-referential models

src/reddit_mcp/tools/__init__.py:16-24 (registration)

Registry list exporting the get_comments_by_submission tool function for use by the MCP server.

# Registry of all available tools
tools = [
    get_submission,
    get_subreddit,
    get_comments_by_submission,
    get_comment_by_id,
    search_posts,
    search_subreddits,
]

src/reddit_mcp/server.py:11-13 (registration)
MCP server code that iterates over the tools list and registers each tool with the FastMCP server instance.
```
for tool in tools:
    logger.info(f"Registering tool: {tool.__name__}")
    mcp.tool()(tool)
```

src/reddit_mcp/tools/get_comments.py:27-45 (helper)

Recursive helper utility to convert PRAW Reddit comment objects into CommentResult models, handling nested replies and skipping placeholders.

def comment_to_model(comment) -> CommentResult:
    """Convert PRAW comment object to CommentResult model."""
    # Skip MoreComments objects
    if isinstance(comment, MoreComments):
        return None

    return CommentResult(
        id=comment.id,
        body=comment.body,
        author=None if comment.author is None else comment.author.name,
        created_utc=format_utc_timestamp(comment.created_utc),
        is_submitter=comment.is_submitter,
        score=comment.score,
        replies=[
            result
            for reply in comment.replies
            if (result := comment_to_model(reply)) is not None
        ],
    )

Reddit MCP