get_user_followers

Instructions

Fetch the list of users following a specific user.

Args:
    username: The user's handle
    page: Page number for pagination (optional)

Returns a FollowList object with:
- users: List of FollowUser objects
- total_count: Total followers

A high follower count often indicates an influential
or helpful community member.

Implementation Reference

• src/uscardforum/server_tools/users.py:223-248 (handler)

  MCP tool handler decorated with @mcp.tool(). Defines input schema using Annotated and Field for username and optional page. Docstring describes functionality and returns FollowList. Delegates to client.get_user_followers.

  @mcp.tool()
  def get_user_followers(
      username: Annotated[
          str,
          Field(description="The user's handle"),
      ],
      page: Annotated[
          int | None,
          Field(default=None, description="Page number for pagination"),
      ] = None,
  ) -> FollowList:
      """
      Fetch the list of users following a specific user.
  
      Args:
          username: The user's handle
          page: Page number for pagination (optional)
  
      Returns a FollowList object with:
      - users: List of FollowUser objects
      - total_count: Total followers
  
      A high follower count often indicates an influential
      or helpful community member.
      """
      return get_client().get_user_followers(username, page=page)

• src/uscardforum/server.py:15-45 (registration)

  Imports all MCP tools including get_user_followers from server_tools into the main server module, enabling automatic registration in the FastMCP server.

  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:248-283 (helper)

  Core client API method that performs HTTP GET request to Discourse endpoint /u/{username}/follow/followers.json, parses JSON payload into list of FollowUser objects wrapped in FollowList.

  def get_user_followers(
      self,
      username: str,
      page: int | None = None,
  ) -> FollowList:
      """Fetch users following a user.
  
      Args:
          username: User handle
          page: Optional page number
  
      Returns:
          List of follower users
      """
      params_list: list[tuple[str, Any]] = []
      if page is not None:
          params_list.append(("page", int(page)))
  
      payload = self._get(
          f"/u/{username}/follow/followers.json",
          params=params_list,
      )
  
      users = []
      for u in payload.get("users", []):
          users.append(FollowUser(
              id=u.get("id", 0),
              username=u.get("username", ""),
              name=u.get("name"),
              avatar_template=u.get("avatar_template"),
          ))
  
      return FollowList(
          users=users,
          total_count=payload.get("total_count", len(users)),
      )

• src/uscardforum/server_tools/__init__.py:37-47 (registration)

  Re-exports get_user_followers from users.py module into server_tools package __init__, making it available for 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,
      list_users_with_badge,
  )

• src/uscardforum/client.py:424-438 (helper)

  Client wrapper method that delegates get_user_followers call to the internal _users API submodule.

  def get_user_followers(
      self,
      username: str,
      page: int | None = None,
  ) -> FollowList:
      """Fetch users following a user.
  
      Args:
          username: User handle
          page: Optional page number
  
      Returns:
          List of follower users
      """
      return self._users.get_user_followers(username, page=page)