Bluesky Social MCP

Instructions

Args:
    ctx: MCP context
    handle: Optional handle to get followers for. If None, gets the authenticated user
    limit: Maximum number of results to return (1-100)
    cursor: Optional pagination cursor

Returns:
    List of follower accounts

Implementation Reference

• server.py:197-235 (handler)

  The primary handler function for the 'get_followers' tool, registered via @mcp.tool(). It retrieves the list of followers for a given Bluesky handle (or the authenticated user's handle if none provided), with support for pagination via limit and cursor parameters. Uses the atproto Client's get_followers method and wraps the response in a standard success/error dictionary format.

  @mcp.tool()
  def get_followers(
      ctx: Context,
      handle: Optional[str] = None,
      limit: Union[int, str] = 50,
      cursor: Optional[str] = None,
  ) -> Dict:
      """Get users who follow an account.
  
      Args:
          ctx: MCP context
          handle: Optional handle to get followers for. If None, gets the authenticated user
          limit: Maximum number of results to return (1-100)
          cursor: Optional pagination cursor
  
      Returns:
          List of follower accounts
      """
      try:
          bluesky_client = get_authenticated_client(ctx)
  
          # If no handle provided, get authenticated user's followers
          if not handle:
              handle = bluesky_client.me.handle
  
          # Convert limit to int if it's a string
          if isinstance(limit, str):
              limit = int(limit)
          limit = max(1, min(100, limit))
  
          # Call get_followers directly with positional arguments as per the client signature
          followers_response = bluesky_client.get_followers(handle, cursor, limit)
          followers_data = followers_response.dict()
  
          return {"status": "success", "followers": followers_data}
      except Exception as e:
          error_msg = f"Failed to get followers: {str(e)}"
          return {"status": "error", "message": error_msg}

• server.py:1075-1076 (registration)

  The 'get_followers' tool is listed under the 'profiles' category in the tools information resource provided at 'info://bluesky-tools'. This serves as a form of tool discovery or registration metadata.

  "profiles": ["get_profile", "get_follows", "get_followers", "follow_user"],
  "posts": [