Get Bluesky Social Graph
bsky_get_followsFetch the social graph edges for a Bluesky account — who follows them, or who they follow. Returns paginated actor profiles (handle, DID, displayName, bio, account creation timestamp, moderation labels with provenance, pronouns when set, and Bluesky verification status) plus a summary of the subject account. Follower, following, and post counts and the website are not on this view, for the listed accounts or the subject — bsky_get_profile returns them for one account. Accounts with large social graphs return only the first page; use cursor pagination to walk through the full list, or sort "top" to put the accounts Bluesky ranks most prominent first.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"actor": "<actor>",
"direction": "<direction>"
},
"name": "bsky_get_follows"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Order of the list. "latest" (Bluesky's default, and what omitting this gives) puts the most recent follows first; "top" is Bluesky's own ranking, which surfaces prominent accounts but is not a follower-count order. Pass a cursor back with the same sort it came from. | |
| actor | Yes | Handle (e.g. "alice.bsky.social") or DID of the account to query. A leading "@" and the account's bsky.app page ("https://bsky.app/profile/alice.bsky.social") are accepted and read as the handle or DID they carry. A bare name without a dot is not a handle — use bsky_search_actors to resolve one. | |
| limit | No | Maximum number of actors to return per page. Default 25; values above 100 are clamped with a notice unless read-limit clamping is disabled. | |
| cursor | No | Opaque pagination cursor from a previous response. Omit for the first page. | |
| direction | Yes | "followers" returns accounts that follow this actor. "following" returns accounts this actor follows. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit applied to this page. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Number of actors returned on this page. | |
| actors | No | Actors in the requested direction of the social graph. | |
| cursor | No | Opaque cursor for the next page. Absent on the last page. | |
| notice | No | Guidance when the result set is empty or constrained. | |
| subject | No | Profile summary of the queried actor. | |
| truncated | No | True when Bluesky returned a cursor, whatever this page held. A cursor is not proof more accounts exist: the next page can come back empty when the remaining accounts are unavailable. | |
| totalReturned | No | Number of actors in this response page. |