bluesky_get_follows

Retrieve a list of accounts you follow on BlueSky with pagination support to manage large following lists efficiently.

Instructions

Get a list of accounts the user follows

Input Schema

TableJSON Schema

Name	Required	Description	Default
`limit`	No	Maximum number of follows to return (default 50, max 100)
`cursor`	No	Pagination cursor for next page of results

Implementation Reference

src/bluesky_mcp/server.py:222-228 (handler)

Handler logic for executing the bluesky_get_follows tool. Calls the Bluesky graph.get_follows API to fetch the list of followed accounts for the authenticated user, using provided limit and cursor parameters.

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

src/bluesky_mcp/server.py:88-105 (registration)

Tool registration in the list_tools() function, defining the name, description, and input schema for bluesky_get_follows.

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

src/bluesky_mcp/server.py:91-104 (schema)

Input schema definition for the bluesky_get_follows tool, specifying optional limit and cursor parameters.

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

BlueSky MCP Server