get_timeline
Read-only
Retrieve your home timeline from AT Protocol, showing posts from followed accounts and algorithmically recommended content.
Instructions
Retrieve the user's home timeline from AT Protocol, returning posts from followed accounts and algorithmically recommended content. Requires authentication (app password). Use get_author_feed to retrieve posts from a specific user instead of the authenticated user's own feed. Subject to per-tool rate limiting.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| algorithm | No | Feed algorithm or generator AT-URI to use (e.g. "reverse-chronological" or at://did/.../app.bsky.feed.generator/rkey). Omit for the default home timeline algorithm. | |
| limit | No | Maximum number of posts to return (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 timeline was retrieved successfully. | |
| posts | Yes | List of posts in the timeline. | |
| cursor | No | Opaque pagination cursor to pass in a subsequent request to retrieve the next page; absent when there are no more results. | |
| hasMore | Yes | Whether additional pages of results are available. | |
| algorithm | No | The algorithm or feed generator AT-URI used for this request, if provided. |