BlueSky MCP Server

Instructions

Implementation Reference

• src/bluesky_mcp/server.py:203-210 (handler)

  The handler logic for the 'bluesky_get_posts' tool. It retrieves recent posts from the authenticated user's feed using the Bluesky API's get_author_feed method, supporting limit and cursor parameters.

  elif name == "bluesky_get_posts":
      limit = arguments.get("limit", 50)
      cursor = arguments.get("cursor")
      response = await asyncio.to_thread(
          bluesky.client.app.bsky.feed.get_author_feed,
          {'actor': IDENTIFIER, 'limit': limit, 'cursor': cursor}
      )

• src/bluesky_mcp/server.py:47-64 (registration)

  Registration of the 'bluesky_get_posts' tool in the list_tools handler, including its description and input schema definition.

  types.Tool(
      name="bluesky_get_posts",
      description="Get recent posts from a user",
      inputSchema={
          "type": "object",
          "properties": {
              "limit": {
                  "type": "integer",
                  "description": "Maximum number of posts to return (default 50, max 100)",
                  "default": 50,
              },
              "cursor": {
                  "type": "string",
                  "description": "Pagination cursor for next page of results",
              },
          },
      },
  ),

• src/bluesky_mcp/server.py:50-63 (schema)

  Input schema for the 'bluesky_get_posts' tool, defining optional limit (default 50) and cursor parameters.

  inputSchema={
      "type": "object",
      "properties": {
          "limit": {
              "type": "integer",
              "description": "Maximum number of posts to return (default 50, max 100)",
              "default": 50,
          },
          "cursor": {
              "type": "string",
              "description": "Pagination cursor for next page of results",
          },
      },
  },