Search Bluesky Actors
bsky_search_actorsFind Bluesky accounts by name or handle fragment. Returns ranked profiles with handle, DID, displayName, bio, account creation timestamp, moderation labels with provenance, pronouns when the account set them, and Bluesky verification status — which tells a verified account from a look-alike handle. Follower, following, and post counts and the website are not on this view — bsky_get_profile returns them for one account. Use before bsky_get_profile or bsky_get_author_feed when you have a name but not a confirmed handle. Supports cursor-based pagination for browsing beyond the first page of results.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "bsky_search_actors"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of actors to return. Default 25; values above 100 are clamped with a notice unless read-limit clamping is disabled. | |
| query | Yes | Name or handle fragment to search for, e.g. "alice" or "nytimes.com". Must not be blank. | |
| cursor | No | Opaque pagination cursor from a previous response to the same query. Omit for the first page. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit applied to this page. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Number of actors returned on this page. | |
| actors | No | Matching actor profiles, ranked by relevance. | |
| cursor | No | Opaque cursor for the next page — pass it back with the same query. Absent on the last page. | |
| notice | No | Guidance when the result set is empty or constrained. | |
| truncated | No | True when Bluesky returned a cursor for another page, whatever this page held — pages often hold fewer actors than limit and still continue. | |
| totalReturned | No | Number of actors in this response page. |