get_user_badges
Retrieve user badges to assess participation, community recognition, and special achievements for trustworthiness evaluation.
Instructions
Fetch badges earned by a user.
Args:
username: The user's handle
grouped: Group badges by type (default: True)
Returns a UserBadges object with:
- badges: List of Badge objects with name, description, granted_at
- badge_types: Badge type information
Badges indicate:
- Participation milestones (first post, anniversaries)
- Community recognition (editor, leader)
- Special achievements
Use to assess user experience and trustworthiness.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| username | Yes | The user's handle | |
| grouped | No | Group badges by type (default: True) |
Implementation Reference
- MCP tool handler for get_user_badges. Defines input schema via Annotated Fields (username: str, grouped: bool=True). Includes detailed docstring for usage. Delegates execution to DiscourseClient.get_user_badges.@mcp.tool() def get_user_badges( username: Annotated[ str, Field(description="The user's handle"), ], grouped: Annotated[ bool, Field(default=True, description="Group badges by type (default: True)"), ] = True, ) -> UserBadges: """ Fetch badges earned by a user. Args: username: The user's handle grouped: Group badges by type (default: True) Returns a UserBadges object with: - badges: List of Badge objects with name, description, granted_at - badge_types: Badge type information Badges indicate: - Participation milestones (first post, anniversaries) - Community recognition (editor, leader) - Special achievements Use to assess user experience and trustworthiness. """ return get_client().get_user_badges(username, grouped=grouped)
- Input schema defined by Pydantic Annotated parameters with Field descriptions and defaults. Output typed as UserBadges model.@mcp.tool() def get_user_badges( username: Annotated[ str, Field(description="The user's handle"), ], grouped: Annotated[ bool, Field(default=True, description="Group badges by type (default: True)"), ] = True, ) -> UserBadges: """ Fetch badges earned by a user. Args: username: The user's handle grouped: Group badges by type (default: True) Returns a UserBadges object with: - badges: List of Badge objects with name, description, granted_at - badge_types: Badge type information Badges indicate: - Participation milestones (first post, anniversaries) - Community recognition (editor, leader) - Special achievements Use to assess user experience and trustworthiness. """ return get_client().get_user_badges(username, grouped=grouped)
- src/uscardforum/server_tools/__init__.py:37-45 (registration)Re-exports get_user_badges tool from users.py module, making it available at package level for server import.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,
- src/uscardforum/server.py:15-45 (registration)Imports get_user_badges into main server entrypoint module, registering it for the MCP server via FastMCP.from uscardforum.server_tools import ( analyze_user, bookmark_post, compare_cards, find_data_points, get_all_topic_posts, get_categories, get_current_session, get_hot_topics, get_new_topics, get_notifications, get_top_topics, get_topic_info, get_topic_posts, 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, login, research_topic, resource_categories, resource_hot_topics, resource_new_topics, search_forum, subscribe_topic, )
- src/uscardforum/api/users.py:156-186 (helper)Underlying API helper that performs HTTP request to Discourse /user-badges/{username}.json endpoint, parses badges from JSON response into UserBadges model.def get_user_badges( self, username: str, grouped: bool = True, ) -> UserBadges: """Fetch user's badges. Args: username: User handle grouped: Group badges (default: True) Returns: User badges data """ params_list: list[tuple[str, Any]] = [ ("grouped", str(bool(grouped)).lower()) ] payload = self._get(f"/user-badges/{username}.json", params=params_list) badges = [] for b in payload.get("user_badges", []): badges.append(Badge( id=b.get("id", 0), badge_id=b.get("badge_id", 0), name=b.get("name", ""), description=b.get("description"), granted_at=b.get("granted_at"), )) return UserBadges(badges=badges)