Get Bluesky List or Starter Pack
bsky_get_listRead a Bluesky list or starter pack with list, or discover one actor’s public lists or starter packs with actor and kind. Direct reads return metadata and one membership page. To read posts, pass a list URI or a starter pack feedUri to bsky_get_feed.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Collection to discover for actor. Required with actor. Omit with list. | |
| list | No | List or starter pack AT-URI or bsky.app page. Use for a direct membership read. | |
| actor | No | Handle, @handle, DID, or bsky.app profile URL. Use with kind to discover collections. | |
| limit | No | Maximum members or discovery results to return. Default 25. Values above 100 are clamped unless read-limit clamping is disabled. | |
| cursor | No | Nonempty opaque cursor from a previous page of the same list or the same actor and kind. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | Limit applied to this page. | |
| list | No | Requested list metadata, or the starter pack’s backing list metadata. | |
| error | No | Present when the call failed. Absent on success. | |
| lists | No | Lists visible on this discovery page. | |
| shown | No | Number of members or discovery results on this page. | |
| cursor | No | Opaque cursor as supplied by Bluesky. Reuse a nonempty value with the same list or actor and kind, even after an empty page. An empty or absent cursor ends pagination. | |
| notice | No | Limit clamp or reason starter pack membership is unavailable. | |
| members | No | Membership records on this page. Absent if membership is unavailable or this is a discovery page. | |
| truncated | No | True when Bluesky supplied a nonempty continuation cursor. | |
| starterPack | No | Requested starter pack metadata. | |
| starterPacks | No | Starter packs visible on this discovery page. |