get_followers
Retrieve a list of users who follow a specified handle on Bluesky Social MCP. Supports pagination and customizable result limits for efficient account analysis.
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 accounts
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | ||
| handle | No | ||
| limit | No |
Implementation Reference
- server.py:197-235 (handler)MCP tool handler for get_followers: fetches followers for a given handle (or authenticated user) using the Bluesky client, with pagination support via limit and cursor, and standard error handling.@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}