get_user_badges
Retrieve user badges to evaluate participation, community recognition, and special achievements for assessing experience and trustworthiness.
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
- The core MCP tool handler for 'get_user_badges'. Decorated with @mcp.tool(), includes input schema via Pydantic Annotated Fields with descriptions, docstring explaining usage, and delegates execution to the DiscourseClient's get_user_badges method.@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.py:15-45 (registration)Imports the get_user_badges tool (line 30) along with all other MCP tools from server_tools. These imports enable automatic registration via the @mcp.tool() decorators when main() is executed.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/server_tools/__init__.py:37-47 (registration)Re-exports get_user_badges (line 42) from users.py, making it available for import in server.py to register the tool.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/client.py:376-390 (helper)Wrapper method in DiscourseClient that delegates to UsersAPI.get_user_badges. Called by the MCP tool handler via get_client().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 """ return self._users.get_user_badges(username, grouped=grouped)
- src/uscardforum/api/users.py:156-186 (helper)Core API implementation in UsersAPI that makes the HTTP GET request to /user-badges/{username}.json, parses the JSON response into Badge objects, and returns UserBadges.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)