get_author_feed
Retrieve posts from a specific user on Bluesky Social MCP, with options to filter post types, paginate results, and include pinned posts for tailored content delivery.
Instructions
Get posts from a specific user.
Args:
ctx: MCP context
actor: Handle or DID of the user
cursor: Optional pagination cursor
filter: Optional filter for post types
limit: Maximum number of results to return
include_pins: Whether to include pinned posts
Returns:
Feed with posts from the specified user
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| actor | Yes | ||
| cursor | No | ||
| filter | No | ||
| include_pins | No | ||
| limit | No |
Implementation Reference
- server.py:590-629 (handler)The handler function for 'get_author_feed' tool. It uses the authenticated Bluesky client to fetch the author's feed generator, converts it to dict, and returns it wrapped in a success dict. The @mcp.tool() decorator also registers the tool with MCP using type hints for schema.@mcp.tool() def get_author_feed( ctx: Context, actor: str, cursor: Optional[str] = None, filter: Optional[str] = None, limit: Optional[int] = None, include_pins: bool = False, ) -> Dict: """Get posts from a specific user. Args: ctx: MCP context actor: Handle or DID of the user cursor: Optional pagination cursor filter: Optional filter for post types limit: Maximum number of results to return include_pins: Whether to include pinned posts Returns: Feed with posts from the specified user """ try: bluesky_client = get_authenticated_client(ctx) feed_response = bluesky_client.get_author_feed( actor, cursor, filter, limit, include_pins ) # Convert the response to a dictionary if hasattr(feed_response, "model_dump"): feed_data = feed_response.model_dump() else: feed_data = feed_response return {"status": "success", "feed": feed_data} except Exception as e: error_msg = f"Failed to get author feed: {str(e)}" return {"status": "error", "message": error_msg}
- server.py:590-590 (registration)The @mcp.tool() decorator registers the get_author_feed function as an MCP tool.@mcp.tool()