get_timeline
Retrieve posts from your home timeline on Bluesky Social MCP. Customize results using algorithm, cursor, or limit parameters for tailored feed access.
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 posts
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| algorithm | No | ||
| cursor | No | ||
| limit | No |
Implementation Reference
- server.py:555-588 (handler)The main handler function decorated with @mcp.tool() that implements the get_timeline tool. It retrieves the user's home timeline using the authenticated Bluesky client.@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}