get_user_replies
Fetch a user's replies across forum topics to analyze their contributions, find data points, and evaluate participation quality with paginated results.
Instructions
Fetch replies/posts made by a user in other topics.
Args:
username: The user's handle
offset: Pagination offset (0, 30, 60, ...)
Returns a list of UserAction objects with:
- topic_id: Which topic they replied to
- post_number: Their post number in that topic
- title: Topic title
- excerpt: Preview of their reply
- created_at: When they replied
Use this to:
- See a user's contributions across topics
- Find their data points and experiences
- Evaluate the quality of their participation
Paginate with offset in increments of 30.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| username | Yes | The user's handle | |
| offset | No | Pagination offset (0, 30, 60, ...) |
Implementation Reference
- The MCP tool handler for 'get_user_replies'. Decorated with @mcp.tool(), defines input schema using Pydantic Annotated and Field for username and optional offset parameters, includes detailed docstring explaining usage, and implements the tool logic by delegating to the underlying client API via get_client().@mcp.tool() def get_user_replies( username: Annotated[ str, Field(description="The user's handle"), ], offset: Annotated[ int | None, Field(default=None, description="Pagination offset (0, 30, 60, ...)"), ] = None, ) -> list[UserAction]: """ Fetch replies/posts made by a user in other topics. Args: username: The user's handle offset: Pagination offset (0, 30, 60, ...) Returns a list of UserAction objects with: - topic_id: Which topic they replied to - post_number: Their post number in that topic - title: Topic title - excerpt: Preview of their reply - created_at: When they replied Use this to: - See a user's contributions across topics - Find their data points and experiences - Evaluate the quality of their participation Paginate with offset in increments of 30. """ return get_client().get_user_replies(username, offset=offset)
- Input/output schema defined inline in the handler using Pydantic's Annotated with Field for descriptions and defaults, returning list[UserAction].@mcp.tool() def get_user_replies( username: Annotated[ str, Field(description="The user's handle"), ], offset: Annotated[ int | None, Field(default=None, description="Pagination offset (0, 30, 60, ...)"), ] = None, ) -> list[UserAction]: """ Fetch replies/posts made by a user in other topics. Args: username: The user's handle offset: Pagination offset (0, 30, 60, ...) Returns a list of UserAction objects with: - topic_id: Which topic they replied to - post_number: Their post number in that topic - title: Topic title - excerpt: Preview of their reply - created_at: When they replied Use this to: - See a user's contributions across topics - Find their data points and experiences - Evaluate the quality of their participation Paginate with offset in increments of 30. """ return get_client().get_user_replies(username, offset=offset)
- src/uscardforum/server_tools/__init__.py:37-47 (registration)Imports the get_user_replies tool from users.py, making it available for export and registration in the MCP server.from .users import ( get_user_summary, get_user_topics, get_user_replies, get_user_actions, get_user_badges, get_user_following, get_user_followers, get_user_reactions, list_users_with_badge, )
- src/uscardforum/server.py:34-34 (registration)Imports get_user_replies in the main server entrypoint, ensuring the tool is loaded and registered when the server starts.get_user_replies,
- src/uscardforum/api/users.py:112-127 (helper)Underlying API client method called by the MCP handler's get_client().get_user_replies. Fetches user replies by calling get_user_actions with filter=5 (replies).def get_user_replies( self, username: str, offset: int | None = None, ) -> list[UserAction]: """Fetch user's replies. Args: username: User handle offset: Optional pagination offset Returns: List of reply action objects """ return self.get_user_actions(username, filter=5, offset=offset)