get_user_summary
Fetch a user's profile summary to evaluate credibility, identify valuable contributions, and understand participation level on USCardForum.
Instructions
Fetch a comprehensive summary of a user's profile.
Args:
username: The user's handle (case-insensitive)
Returns a UserSummary object with:
- user_id: User ID
- username: Username
- stats: UserStats with posts, topics, likes given/received, etc.
- badges: List of recent Badge objects
- top_topics: Most successful topics
- top_replies: Most successful replies
Use this to:
- Evaluate a user's credibility and experience
- Find their most valuable contributions
- Understand their participation level
The summary provides a quick overview without fetching
individual post histories.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| username | Yes | The user's handle (case-insensitive) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Display name | |
| stats | No | User statistics | |
| badges | No | Recent badges | |
| user_id | No | User ID | |
| username | No | Username | |
| created_at | No | Account creation date | |
| top_topics | No | Top topics | |
| top_replies | No | Top replies | |
| last_seen_at | No | Last seen online |
Implementation Reference
- The MCP tool handler for 'get_user_summary'. Decorated with @mcp.tool(), it defines the input schema (username parameter with description), output type UserSummary, includes comprehensive docstring, and delegates execution to the API client via get_client().
@mcp.tool() def get_user_summary( username: Annotated[ str, Field(description="The user's handle (case-insensitive)"), ], ) -> UserSummary: """ Fetch a comprehensive summary of a user's profile. Args: username: The user's handle (case-insensitive) Returns a UserSummary object with: - user_id: User ID - username: Username - stats: UserStats with posts, topics, likes given/received, etc. - badges: List of recent Badge objects - top_topics: Most successful topics - top_replies: Most successful replies Use this to: - Evaluate a user's credibility and experience - Find their most valuable contributions - Understand their participation level The summary provides a quick overview without fetching individual post histories. """ return get_client().get_user_summary(username) - Pydantic BaseModel defining the output schema/structure for the get_user_summary tool response, including fields for user profile, stats, badges, and top content.
class UserSummary(BaseModel): """Comprehensive user profile summary.""" user_id: int | None = Field(None, description="User ID") username: str | None = Field(None, description="Username") name: str | None = Field(None, description="Display name") created_at: datetime | None = Field(None, description="Account creation date") last_seen_at: datetime | None = Field(None, description="Last seen online") stats: UserStats | None = Field(None, description="User statistics") badges: list[Badge] = Field(default_factory=list, description="Recent badges") top_topics: list[Any] = Field(default_factory=list, description="Top topics") top_replies: list[Any] = Field(default_factory=list, description="Top replies") class Config: extra = "ignore" - src/uscardforum/server_tools/__init__.py:68-78 (registration)Package-level import of the get_user_summary tool from users.py submodule, exposing it for use and MCP registration when the package is imported.
from .users import ( get_user_actions, get_user_badges, get_user_followers, get_user_following, get_user_reactions, get_user_replies, get_user_summary, get_user_topics, list_users_with_badge, )