bluesky_search_profiles
Search for user profiles on BlueSky by entering a query string, with options to set result limits and pagination for efficient profile discovery.
Instructions
Search for Bluesky profiles
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | Pagination cursor for next page of results | |
| limit | No | Maximum number of results to return (default 25, max 100) | |
| query | Yes | Search query string |
Implementation Reference
- src/bluesky_mcp/server.py:254-263 (handler)Executes the bluesky_search_profiles tool: validates query argument, calls the Bluesky actor search API via atproto client, and prepares the response object for JSON serialization.elif name == "bluesky_search_profiles": query = arguments.get("query") if not query: return [types.TextContent(type="text", text="Missing required argument: query")] limit = arguments.get("limit", 25) cursor = arguments.get("cursor") response = await asyncio.to_thread( bluesky.client.app.bsky.actor.search_actors, {'term': query, 'limit': limit, 'cursor': cursor} )
- src/bluesky_mcp/server.py:160-182 (registration)Registers the bluesky_search_profiles tool in the list_tools handler, including name, description, and input schema definition.types.Tool( name="bluesky_search_profiles", description="Search for Bluesky profiles", inputSchema={ "type": "object", "properties": { "query": { "type": "string", "description": "Search query string", }, "limit": { "type": "integer", "description": "Maximum number of results to return (default 25, max 100)", "default": 25, }, "cursor": { "type": "string", "description": "Pagination cursor for next page of results", }, }, "required": ["query"], }, ),
- src/bluesky_mcp/server.py:163-181 (schema)Defines the input schema for the bluesky_search_profiles tool, specifying required query and optional limit/cursor parameters.inputSchema={ "type": "object", "properties": { "query": { "type": "string", "description": "Search query string", }, "limit": { "type": "integer", "description": "Maximum number of results to return (default 25, max 100)", "default": 25, }, "cursor": { "type": "string", "description": "Pagination cursor for next page of results", }, }, "required": ["query"], },