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
| 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 |
Input Schema (JSON Schema)
{
"properties": {
"cursor": {
"description": "Pagination cursor for next page of results",
"type": "string"
},
"limit": {
"default": 25,
"description": "Maximum number of results to return (default 25, max 100)",
"type": "integer"
},
"query": {
"description": "Search query string",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
}
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"], },