get_timeline
Retrieve posts from your Bluesky home timeline using optional algorithms, pagination, and result limits to view social content.
Instructions
Get posts from your home timeline.
Args:
ctx: MCP context
algorithm: Optional algorithm to use for timeline
cursor: Optional pagination cursor
limit: Maximum number of results to return
Returns:
Timeline feed with postsInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| algorithm | No | ||
| cursor | No | ||
| limit | No |
Implementation Reference
- server.py:555-588 (handler)The handler function for the 'get_timeline' tool. It uses the authenticated Bluesky client to fetch the home timeline with optional algorithm, cursor, and limit parameters, returning the timeline data or an error.
@mcp.tool() def get_timeline( ctx: Context, algorithm: Optional[str] = None, cursor: Optional[str] = None, limit: Optional[int] = None, ) -> Dict: """Get posts from your home timeline. Args: ctx: MCP context algorithm: Optional algorithm to use for timeline cursor: Optional pagination cursor limit: Maximum number of results to return Returns: Timeline feed with posts """ try: bluesky_client = get_authenticated_client(ctx) timeline_response = bluesky_client.get_timeline(algorithm, cursor, limit) # Convert the response to a dictionary if hasattr(timeline_response, "model_dump"): timeline_data = timeline_response.model_dump() else: timeline_data = timeline_response return {"status": "success", "timeline": timeline_data} except Exception as e: error_msg = f"Failed to get timeline: {str(e)}" return {"status": "error", "message": error_msg}