USCardForum MCP Server

Instructions

Implementation Reference

• src/uscardforum/server_tools/users.py:252-274 (handler)

  MCP tool handler for get_user_reactions. Defines input schema with Annotated Fields, calls the client API, and returns UserReactions object. Includes @mcp.tool() decorator for automatic registration.
  def get_user_reactions( username: Annotated[ str, Field(description="The user's handle"), ], offset: Annotated[ int | None, Field(default=None, description="Pagination offset"), ] = None, ) -> UserReactions: """ Fetch a user's post reactions (likes, etc.). Args: username: The user's handle offset: Pagination offset (optional) Returns a UserReactions object with reaction data. Use to see what content a user has reacted to, which can indicate their interests and values. """ return get_client().get_user_reactions(username, offset=offset)
• src/uscardforum/api/users.py:285-308 (helper)

  Core API client method that performs the HTTP GET request to fetch user reactions from the Discourse endpoint and parses the response into UserReactions.
  def get_user_reactions( self, username: str, offset: int | None = None, ) -> UserReactions: """Fetch user's post reactions. Args: username: User handle offset: Optional pagination offset Returns: User reactions data """ params_list: list[tuple[str, Any]] = [("username", username)] if offset is not None: params_list.append(("offset", int(offset))) payload = self._get( "/discourse-reactions/posts/reactions.json", params=params_list, ) return UserReactions(reactions=payload.get("reactions", []))
• src/uscardforum/client.py:440-454 (helper)

  Client proxy method that delegates to the users API subclient.
  def get_user_reactions( self, username: str, offset: int | None = None, ) -> UserReactions: """Fetch user's post reactions. Args: username: User handle offset: Optional pagination offset Returns: User reactions data """ return self._users.get_user_reactions(username, offset=offset)
• src/uscardforum/server_tools/__init__.py:37-45 (registration)

  Re-export of get_user_reactions from users.py module as part of server_tools package, enabling easy import in server.py.
  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:33-33 (registration)

  Import of get_user_reactions tool into the MCP server entrypoint, which triggers registration via the @mcp.tool() decorator.
  get_user_reactions,