AT Protocol MCP Server

Appearance

get_followers ​

Get the list of users following a specific user.

Authentication ​

Optional: Public tool (works without authentication)

Parameters ​

actor (required) ​

  • Type: string
  • Description: User identifier (DID or handle)

limit (optional) ​

  • Type: number
  • Default: 50
  • Constraints: 1-100
  • Description: Maximum number of followers to return

cursor (optional) ​

  • Type: string
  • Description: Pagination cursor from previous response

Response ​

typescript
{
  success: boolean;
  followers: Array<{
    did: string;
    handle: string;
    displayName?: string;
    description?: string;
    avatar?: string;
    indexedAt?: string;
    viewer?: {
      muted?: boolean;
      blockedBy?: boolean;
      following?: string;
      followedBy?: string;
    };
  }>;
  subject: {
    did: string;
    handle: string;
    displayName?: string;
    avatar?: string;
  };
  cursor?: string;
  hasMore: boolean;
}

Examples ​

Get Followers by Handle ​

json
{
  "actor": "alice.bsky.social",
  "limit": 50
}

Get Followers with Pagination ​

json
{
  "actor": "alice.bsky.social",
  "limit": 50,
  "cursor": "cursor_from_previous_response"
}

Error Handling ​

Common Errors ​

Invalid Actor ​

json
{
  "error": "Actor (DID or handle) is required",
  "code": "VALIDATION_ERROR"
}

User Not Found ​

json
{
  "error": "User not found",
  "code": "NOT_FOUND"
}

Best Practices ​

  • Use pagination for users with many followers
  • Cache follower lists for short periods
  • Respect privacy settings

See Also ​