get_user_connections
Read-only
Retrieve a list of followers or followees for any AT Protocol account. Specify direction to view who follows the account or who the account follows.
Instructions
Retrieve an account's followers or follows from AT Protocol. Works without authentication; richer with auth. Use direction='followers' to get who follows the actor or direction='follows' to get who the actor follows; use get_user_profile or get_user_summary for aggregate counts instead. Subject to per-tool rate limiting.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| actor | Yes | Handle (e.g. alice.bsky.social) or DID of the account whose connections to list. | |
| direction | Yes | Which side of the follow graph to return: 'followers' = accounts that follow the actor; 'follows' = accounts the actor follows. | |
| limit | No | Max accounts per page (1–100, default 50). | |
| cursor | No | Opaque pagination cursor from the previous response cursor field; omit for the first page. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| success | Yes | Whether the request succeeded. | |
| actor | Yes | The actor whose connections were fetched. | |
| direction | Yes | The direction of the follow graph that was queried. | |
| connections | Yes | The matched accounts for this page. | |
| cursor | No | Opaque cursor for the next page; absent when there are no more results. |