get_user_badges
Retrieve user badges from USCardForum to assess participation milestones, 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
- The MCP tool handler for 'get_user_badges'. Decorated with @mcp.tool(), which registers the tool and defines input schema using Annotated[ ] with pydantic Field for username and grouped parameters. Executes by calling get_client().get_user_badges(username, grouped=grouped) and returns UserBadges.@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:68-78 (registration)Imports get_user_badges from .users module, making it available for use and registration in the server tools package.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, )
- src/uscardforum/server.py:29-85 (registration)Re-exports get_user_badges from server_tools, ensuring the tool is imported and registered when server.py is run.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, ) __all__ = [ "MCP_HOST", "MCP_PORT", "MCP_TRANSPORT", "NITAN_TOKEN", "SERVER_INSTRUCTIONS", "get_client", "main", "mcp", "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", "resource_categories", "resource_hot_topics", "resource_new_topics", "search_forum", "subscribe_topic", "research_topic", ]