Read Bluesky
bluesky_readRead Bluesky profiles, posts, threads, feeds, followers and engagement, plus connected-account notifications and settings, by calling public and account XRPC methods.
Instructions
Read-only Bluesky lookups. Fields go in params with the API's names; lists page with limit (1-100) and cursor. profiles (actor: handles or DIDs, comma-separated, up to 25; without it the connected account); search_posts (q, sort latest|top, since, until, author, mentions, lang, domain, url, tag; needs user); search_accounts (q, typeahead); followers / follows (actor, or the connected account with user); post_thread (uri, depth, parentHeight), author_feed (actor, filter), feed (feed: at:// URI of a feed generator): Bluesky's own answer, with Bluesky's camelCase parameter names; post_engagement (post_id, type likes|reposts|quotes): who liked, reposted or quoted a post; xrpc (nsid plus its parameters): other public read methods such as app.bsky.feed.getPosts, app.bsky.feed.getQuotes, app.bsky.graph.getLists, app.bsky.actor.searchActorsTypeahead. Of the connected account (need user): notifications (reasons: reply, mention, quote, like, repost, follow…), unread_count, notification_preferences, activity_subscriptions, labels (post_ids: up to 25 at:// URIs), own_profile, status, settings, preferences, drafts, chat_status, chat_preferences.
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": {
"action": "<action>"
},
"name": "bluesky_read"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user | No | Upload-Post profile name with Bluesky connected. Required for account reads and search_posts; optional for public reads. | |
| action | Yes | ||
| params | No | Other API fields for this action, with the REST API's own names (snake_case) and shapes. See the description for each action's fields. Leave out what you do not want to change. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No |