get_followers
Retrieve follower lists for Bluesky accounts to analyze audience connections and manage social relationships.
Instructions
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 accountsInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| handle | No | ||
| limit | No | ||
| cursor | No |
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": [