naftiko: 1.0.0-alpha2 info: label: Bluesky Social API description: 'The Bluesky Social API provides programmatic access to the Bluesky social network built on the AT Protocol. This API enables developers to: - Manage user profiles and preferences - Create, read, and interact with posts and feeds - Handle social graph operations (follows, blocks, mutes) - Process notifications and conversations - Moderate content and manage labels - Synchronize repository data Authentication is handled via Bearer tokens. Public endpoints can be accessed directly at https://public.api.bsky.app, while authenticated requests should be made to the user''s Personal Data Server (PDS).' tags: - Bluesky - API created: '2026-05-06' modified: '2026-05-06' capability: consumes: - type: http namespace: bluesky baseUri: https://bsky.social/xrpc description: Bluesky Social API HTTP API. authentication: type: bearer token: '{{BLUESKY_TOKEN}}' resources: - name: xrpc-app-bsky-actor-getpreferences path: /xrpc/app.bsky.actor.getPreferences operations: - name: actorgetpreferences method: GET description: Bluesky Get private preferences attached to the current account. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-actor-getprofile path: /xrpc/app.bsky.actor.getProfile operations: - name: actorgetprofile method: GET description: Bluesky Get detailed profile view of an actor. inputParameters: - name: actor in: query type: string required: true description: Handle or DID of account to fetch profile of. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-actor-getprofiles path: /xrpc/app.bsky.actor.getProfiles operations: - name: actorgetprofiles method: GET description: Bluesky Get detailed profile views of multiple actors. inputParameters: - name: actors in: query type: array required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-actor-getsuggestions path: /xrpc/app.bsky.actor.getSuggestions operations: - name: actorgetsuggestions method: GET description: Bluesky Get a list of suggested actors. inputParameters: - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-actor-putpreferences path: /xrpc/app.bsky.actor.putPreferences operations: - name: actorputpreferences method: POST description: Bluesky Set the private preferences attached to the account. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-actor-searchactors path: /xrpc/app.bsky.actor.searchActors operations: - name: actorsearchactors method: GET description: Bluesky Find actors (profiles) matching search criteria. inputParameters: - name: q in: query type: string description: Search query string. Syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended. - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-actor-searchactorstypeahead path: /xrpc/app.bsky.actor.searchActorsTypeahead operations: - name: actorsearchactorstypeahead method: GET description: Bluesky Find actor suggestions for a prefix search term. inputParameters: - name: q in: query type: string description: Search query prefix; not a full query string. - name: limit in: query type: integer outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-describefeedgenerator path: /xrpc/app.bsky.feed.describeFeedGenerator operations: - name: feeddescribefeedgenerator method: GET description: Bluesky Get information about a feed generator, including policies and offered feed URIs. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-getactorfeeds path: /xrpc/app.bsky.feed.getActorFeeds operations: - name: feedgetactorfeeds method: GET description: Bluesky Get a list of feeds (feed generator records) created by the actor (in the actor's repo). inputParameters: - name: actor in: query type: string required: true - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-getactorlikes path: /xrpc/app.bsky.feed.getActorLikes operations: - name: feedgetactorlikes method: GET description: Bluesky Get a list of posts liked by an actor. inputParameters: - name: actor in: query type: string required: true - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-getauthorfeed path: /xrpc/app.bsky.feed.getAuthorFeed operations: - name: feedgetauthorfeed method: GET description: Bluesky Get a view of an actor's 'author feed' (post and reposts by the author). inputParameters: - name: actor in: query type: string required: true - name: limit in: query type: integer - name: cursor in: query type: string - name: filter in: query type: string description: Combinations of post/repost types to include in response. - name: includePins in: query type: boolean outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-getfeed path: /xrpc/app.bsky.feed.getFeed operations: - name: feedgetfeed method: GET description: Bluesky Get a hydrated feed from an actor's selected feed generator. inputParameters: - name: feed in: query type: string required: true - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-getfeedgenerator path: /xrpc/app.bsky.feed.getFeedGenerator operations: - name: feedgetfeedgenerator method: GET description: Bluesky Get information about a feed generator. inputParameters: - name: feed in: query type: string required: true description: AT-URI of the feed generator record. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-getfeedgenerators path: /xrpc/app.bsky.feed.getFeedGenerators operations: - name: feedgetfeedgenerators method: GET description: Bluesky Get information about a list of feed generators. inputParameters: - name: feeds in: query type: array required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-getfeedskeleton path: /xrpc/app.bsky.feed.getFeedSkeleton operations: - name: feedgetfeedskeleton method: GET description: Bluesky Get a skeleton of a feed provided by a feed generator. inputParameters: - name: feed in: query type: string required: true description: Reference to feed generator record describing the specific feed being requested. - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-getlikes path: /xrpc/app.bsky.feed.getLikes operations: - name: feedgetlikes method: GET description: Bluesky Get like records which reference a subject (by AT-URI and CID). inputParameters: - name: uri in: query type: string required: true description: AT-URI of the subject (eg, a post record). - name: cid in: query type: string description: CID of the subject record (aka, specific version of record), to filter likes. - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-getlistfeed path: /xrpc/app.bsky.feed.getListFeed operations: - name: feedgetlistfeed method: GET description: Bluesky Get a feed of recent posts from a list (posts and reposts from any actors on the list). inputParameters: - name: list in: query type: string required: true description: Reference (AT-URI) to the list record. - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-getpostthread path: /xrpc/app.bsky.feed.getPostThread operations: - name: feedgetpostthread method: GET description: Bluesky Get posts in a thread. inputParameters: - name: uri in: query type: string required: true description: Reference (AT-URI) to post record. - name: depth in: query type: integer description: How many levels of reply depth should be included in response. - name: parentHeight in: query type: integer description: How many levels of parent (and grandparent, etc) post to include. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-getposts path: /xrpc/app.bsky.feed.getPosts operations: - name: feedgetposts method: GET description: Bluesky Gets post views for a specified list of posts (by AT-URI). inputParameters: - name: uris in: query type: array required: true description: List of post AT-URIs to return hydrated views for. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-getquotes path: /xrpc/app.bsky.feed.getQuotes operations: - name: feedgetquotes method: GET description: Bluesky Get a list of quotes for a given post. inputParameters: - name: uri in: query type: string required: true description: Reference (AT-URI) of post record - name: cid in: query type: string description: If supplied, filters to quotes of specific version (by CID) of the post record. - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-getrepostedby path: /xrpc/app.bsky.feed.getRepostedBy operations: - name: feedgetrepostedby method: GET description: Bluesky Get a list of reposts for a given post. inputParameters: - name: uri in: query type: string required: true description: Reference (AT-URI) of post record - name: cid in: query type: string description: If supplied, filters to reposts of specific version (by CID) of the post record. - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-getsuggestedfeeds path: /xrpc/app.bsky.feed.getSuggestedFeeds operations: - name: feedgetsuggestedfeeds method: GET description: Bluesky Get a list of suggested feeds (feed generators) for the requesting account. inputParameters: - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-gettimeline path: /xrpc/app.bsky.feed.getTimeline operations: - name: feedgettimeline method: GET description: Bluesky Get a view of the requesting account's home timeline. inputParameters: - name: algorithm in: query type: string description: 'Variant ''algorithm'' for timeline. Implementation-specific. NOTE: most feed flexibility has been moved to feed generator mechanism.' - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-searchposts path: /xrpc/app.bsky.feed.searchPosts operations: - name: feedsearchposts method: GET description: Bluesky Find posts matching search criteria, returning views of those posts. inputParameters: - name: q in: query type: string required: true description: Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended. - name: sort in: query type: string description: Specifies the ranking order of results. - name: since in: query type: string description: Filter results for posts after the indicated datetime (inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'. Can be a datetime, or ju - name: until in: query type: string description: 'Filter results for posts before the indicated datetime (not inclusive). Expected to use ''sortAt'' timestamp, which may not match ''createdAt''. Can be a datetime, ' - name: mentions in: query type: string description: Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only matches rich-text facet mentions. - name: author in: query type: string description: Filter to posts by the given account. Handles are resolved to DID before query-time. - name: lang in: query type: string description: Filter to posts in the given language. Expected to be based on post language field, though server may override language detection. - name: domain in: query type: string description: Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization. - name: url in: query type: string description: Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching. - name: tag in: query type: array description: Filter to posts with the given tag (hashtag), based on rich-text facet or tag field. Do not include the hash (#) prefix. Multiple tags can be specified, with 'A - name: limit in: query type: integer - name: cursor in: query type: string description: Optional pagination mechanism; may not necessarily allow scrolling through entire result set. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-feed-sendinteractions path: /xrpc/app.bsky.feed.sendInteractions operations: - name: feedsendinteractions method: POST description: Bluesky Send information about interactions with feed items back to the feed generator that served them. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-getactorstarterpacks path: /xrpc/app.bsky.graph.getActorStarterPacks operations: - name: graphgetactorstarterpacks method: GET description: Bluesky Get a list of starter packs created by the actor. inputParameters: - name: actor in: query type: string required: true - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-getblocks path: /xrpc/app.bsky.graph.getBlocks operations: - name: graphgetblocks method: GET description: Bluesky Enumerates which accounts the requesting account is currently blocking. inputParameters: - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-getfollowers path: /xrpc/app.bsky.graph.getFollowers operations: - name: graphgetfollowers method: GET description: Bluesky Enumerates accounts which follow a specified account (actor). inputParameters: - name: actor in: query type: string required: true - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-getfollows path: /xrpc/app.bsky.graph.getFollows operations: - name: graphgetfollows method: GET description: Bluesky Enumerates accounts which a specified account (actor) follows. inputParameters: - name: actor in: query type: string required: true - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-getknownfollowers path: /xrpc/app.bsky.graph.getKnownFollowers operations: - name: graphgetknownfollowers method: GET description: Bluesky Enumerates accounts which follow a specified account (actor) and are followed by the viewer. inputParameters: - name: actor in: query type: string required: true - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-getlist path: /xrpc/app.bsky.graph.getList operations: - name: graphgetlist method: GET description: Bluesky Gets a 'view' (with additional context) of a specified list. inputParameters: - name: list in: query type: string required: true description: Reference (AT-URI) of the list record to hydrate. - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-getlistblocks path: /xrpc/app.bsky.graph.getListBlocks operations: - name: graphgetlistblocks method: GET description: Bluesky Get mod lists that the requesting account (actor) is blocking. inputParameters: - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-getlistmutes path: /xrpc/app.bsky.graph.getListMutes operations: - name: graphgetlistmutes method: GET description: Bluesky Enumerates mod lists that the requesting account (actor) currently has muted. inputParameters: - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-getlists path: /xrpc/app.bsky.graph.getLists operations: - name: graphgetlists method: GET description: Bluesky Enumerates the lists created by a specified account (actor). inputParameters: - name: actor in: query type: string required: true description: The account (actor) to enumerate lists from. - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-getmutes path: /xrpc/app.bsky.graph.getMutes operations: - name: graphgetmutes method: GET description: Bluesky Enumerates accounts that the requesting account (actor) currently has muted. inputParameters: - name: limit in: query type: integer - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-getrelationships path: /xrpc/app.bsky.graph.getRelationships operations: - name: graphgetrelationships method: GET description: Bluesky Enumerates public relationships between one account, and a list of other accounts. inputParameters: - name: actor in: query type: string required: true description: Primary account requesting relationships for. - name: others in: query type: array description: List of 'other' accounts to be related back to the primary. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-getstarterpack path: /xrpc/app.bsky.graph.getStarterPack operations: - name: graphgetstarterpack method: GET description: Bluesky Gets a view of a starter pack. inputParameters: - name: starterPack in: query type: string required: true description: Reference (AT-URI) of the starter pack record. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-getstarterpacks path: /xrpc/app.bsky.graph.getStarterPacks operations: - name: graphgetstarterpacks method: GET description: Bluesky Get views for a list of starter packs. inputParameters: - name: uris in: query type: array required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-getsuggestedfollowsbyactor path: /xrpc/app.bsky.graph.getSuggestedFollowsByActor operations: - name: graphgetsuggestedfollowsbyactor method: GET description: Bluesky Enumerates follows similar to a given account (actor). inputParameters: - name: actor in: query type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-muteactor path: /xrpc/app.bsky.graph.muteActor operations: - name: graphmuteactor method: POST description: Bluesky Creates a mute relationship for the specified account. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-muteactorlist path: /xrpc/app.bsky.graph.muteActorList operations: - name: graphmuteactorlist method: POST description: Bluesky Creates a mute relationship for the specified list of accounts. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-mutethread path: /xrpc/app.bsky.graph.muteThread operations: - name: graphmutethread method: POST description: Bluesky Mutes a thread preventing notifications from the thread and any of its children. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-unmuteactor path: /xrpc/app.bsky.graph.unmuteActor operations: - name: graphunmuteactor method: POST description: Bluesky Unmutes the specified account. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-unmuteactorlist path: /xrpc/app.bsky.graph.unmuteActorList operations: - name: graphunmuteactorlist method: POST description: Bluesky Unmutes the specified list of accounts. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-graph-unmutethread path: /xrpc/app.bsky.graph.unmuteThread operations: - name: graphunmutethread method: POST description: Bluesky Unmutes the specified thread. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-labeler-getservices path: /xrpc/app.bsky.labeler.getServices operations: - name: labelergetservices method: GET description: Bluesky Get information about a list of labeler services. inputParameters: - name: dids in: query type: array required: true - name: detailed in: query type: boolean outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-notification-getunreadcount path: /xrpc/app.bsky.notification.getUnreadCount operations: - name: notificationgetunreadcount method: GET description: Bluesky Count the number of unread notifications for the requesting account. inputParameters: - name: priority in: query type: boolean - name: seenAt in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-notification-listnotifications path: /xrpc/app.bsky.notification.listNotifications operations: - name: notificationlistnotifications method: GET description: Bluesky Enumerate notifications for the requesting account. inputParameters: - name: limit in: query type: integer - name: priority in: query type: boolean - name: cursor in: query type: string - name: seenAt in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-notification-putpreferences path: /xrpc/app.bsky.notification.putPreferences operations: - name: notificationputpreferences method: POST description: Bluesky Set notification-related preferences for an account. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-notification-registerpush path: /xrpc/app.bsky.notification.registerPush operations: - name: notificationregisterpush method: POST description: Bluesky Register to receive push notifications, via a specified service, for the requesting account. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-notification-updateseen path: /xrpc/app.bsky.notification.updateSeen operations: - name: notificationupdateseen method: POST description: Bluesky Notify server that the requesting account has seen notifications. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-video-getjobstatus path: /xrpc/app.bsky.video.getJobStatus operations: - name: videogetjobstatus method: GET description: Bluesky Get status details for a video processing job. inputParameters: - name: jobId in: query type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-video-getuploadlimits path: /xrpc/app.bsky.video.getUploadLimits operations: - name: videogetuploadlimits method: GET description: Bluesky Get video upload limits for the authenticated user. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-app-bsky-video-uploadvideo path: /xrpc/app.bsky.video.uploadVideo operations: - name: videouploadvideo method: POST description: Bluesky Upload a video to be processed then stored on the PDS. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-chat-bsky-actor-deleteaccount path: /xrpc/chat.bsky.actor.deleteAccount operations: - name: chatactordeleteaccount method: POST description: Bluesky Operation outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-chat-bsky-actor-exportaccountdata path: /xrpc/chat.bsky.actor.exportAccountData operations: - name: chatactorexportaccountdata method: GET description: Bluesky Operation outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-chat-bsky-convo-deletemessageforself path: /xrpc/chat.bsky.convo.deleteMessageForSelf operations: - name: chatconvodeletemessageforself method: POST description: Bluesky Operation outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-chat-bsky-convo-getconvo path: /xrpc/chat.bsky.convo.getConvo operations: - name: chatconvogetconvo method: GET description: Bluesky Operation inputParameters: - name: convoId in: query type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-chat-bsky-convo-getconvoformembers path: /xrpc/chat.bsky.convo.getConvoForMembers operations: - name: chatconvogetconvoformembers method: GET description: Bluesky Operation inputParameters: - name: members in: query type: array required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: xrpc-chat-bsky-convo-getlog path: /xrpc/chat.bsky.convo.getLog operations: - name: chatconvogetlog method: GET description: Bluesky Operation inputParameters: - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. exposes: - type: rest port: 8080 namespace: bluesky-rest description: REST adapter for Bluesky Social API. resources: - path: /xrpc/app.bsky.actor.getPreferences name: actorgetpreferences operations: - method: GET name: actorgetpreferences description: Bluesky Get private preferences attached to the current account. call: bluesky.actorgetpreferences outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.actor.getProfile name: actorgetprofile operations: - method: GET name: actorgetprofile description: Bluesky Get detailed profile view of an actor. call: bluesky.actorgetprofile outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.actor.getProfiles name: actorgetprofiles operations: - method: GET name: actorgetprofiles description: Bluesky Get detailed profile views of multiple actors. call: bluesky.actorgetprofiles outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.actor.getSuggestions name: actorgetsuggestions operations: - method: GET name: actorgetsuggestions description: Bluesky Get a list of suggested actors. call: bluesky.actorgetsuggestions outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.actor.putPreferences name: actorputpreferences operations: - method: POST name: actorputpreferences description: Bluesky Set the private preferences attached to the account. call: bluesky.actorputpreferences outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.actor.searchActors name: actorsearchactors operations: - method: GET name: actorsearchactors description: Bluesky Find actors (profiles) matching search criteria. call: bluesky.actorsearchactors outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.actor.searchActorsTypeahead name: actorsearchactorstypeahead operations: - method: GET name: actorsearchactorstypeahead description: Bluesky Find actor suggestions for a prefix search term. call: bluesky.actorsearchactorstypeahead outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.describeFeedGenerator name: feeddescribefeedgenerator operations: - method: GET name: feeddescribefeedgenerator description: Bluesky Get information about a feed generator, including policies and offered feed URIs. call: bluesky.feeddescribefeedgenerator outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.getActorFeeds name: feedgetactorfeeds operations: - method: GET name: feedgetactorfeeds description: Bluesky Get a list of feeds (feed generator records) created by the actor (in the actor's repo). call: bluesky.feedgetactorfeeds outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.getActorLikes name: feedgetactorlikes operations: - method: GET name: feedgetactorlikes description: Bluesky Get a list of posts liked by an actor. call: bluesky.feedgetactorlikes outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.getAuthorFeed name: feedgetauthorfeed operations: - method: GET name: feedgetauthorfeed description: Bluesky Get a view of an actor's 'author feed' (post and reposts by the author). call: bluesky.feedgetauthorfeed outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.getFeed name: feedgetfeed operations: - method: GET name: feedgetfeed description: Bluesky Get a hydrated feed from an actor's selected feed generator. call: bluesky.feedgetfeed outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.getFeedGenerator name: feedgetfeedgenerator operations: - method: GET name: feedgetfeedgenerator description: Bluesky Get information about a feed generator. call: bluesky.feedgetfeedgenerator outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.getFeedGenerators name: feedgetfeedgenerators operations: - method: GET name: feedgetfeedgenerators description: Bluesky Get information about a list of feed generators. call: bluesky.feedgetfeedgenerators outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.getFeedSkeleton name: feedgetfeedskeleton operations: - method: GET name: feedgetfeedskeleton description: Bluesky Get a skeleton of a feed provided by a feed generator. call: bluesky.feedgetfeedskeleton outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.getLikes name: feedgetlikes operations: - method: GET name: feedgetlikes description: Bluesky Get like records which reference a subject (by AT-URI and CID). call: bluesky.feedgetlikes outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.getListFeed name: feedgetlistfeed operations: - method: GET name: feedgetlistfeed description: Bluesky Get a feed of recent posts from a list (posts and reposts from any actors on the list). call: bluesky.feedgetlistfeed outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.getPostThread name: feedgetpostthread operations: - method: GET name: feedgetpostthread description: Bluesky Get posts in a thread. call: bluesky.feedgetpostthread outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.getPosts name: feedgetposts operations: - method: GET name: feedgetposts description: Bluesky Gets post views for a specified list of posts (by AT-URI). call: bluesky.feedgetposts outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.getQuotes name: feedgetquotes operations: - method: GET name: feedgetquotes description: Bluesky Get a list of quotes for a given post. call: bluesky.feedgetquotes outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.getRepostedBy name: feedgetrepostedby operations: - method: GET name: feedgetrepostedby description: Bluesky Get a list of reposts for a given post. call: bluesky.feedgetrepostedby outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.getSuggestedFeeds name: feedgetsuggestedfeeds operations: - method: GET name: feedgetsuggestedfeeds description: Bluesky Get a list of suggested feeds (feed generators) for the requesting account. call: bluesky.feedgetsuggestedfeeds outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.getTimeline name: feedgettimeline operations: - method: GET name: feedgettimeline description: Bluesky Get a view of the requesting account's home timeline. call: bluesky.feedgettimeline outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.searchPosts name: feedsearchposts operations: - method: GET name: feedsearchposts description: Bluesky Find posts matching search criteria, returning views of those posts. call: bluesky.feedsearchposts outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.feed.sendInteractions name: feedsendinteractions operations: - method: POST name: feedsendinteractions description: Bluesky Send information about interactions with feed items back to the feed generator that served them. call: bluesky.feedsendinteractions outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.getActorStarterPacks name: graphgetactorstarterpacks operations: - method: GET name: graphgetactorstarterpacks description: Bluesky Get a list of starter packs created by the actor. call: bluesky.graphgetactorstarterpacks outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.getBlocks name: graphgetblocks operations: - method: GET name: graphgetblocks description: Bluesky Enumerates which accounts the requesting account is currently blocking. call: bluesky.graphgetblocks outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.getFollowers name: graphgetfollowers operations: - method: GET name: graphgetfollowers description: Bluesky Enumerates accounts which follow a specified account (actor). call: bluesky.graphgetfollowers outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.getFollows name: graphgetfollows operations: - method: GET name: graphgetfollows description: Bluesky Enumerates accounts which a specified account (actor) follows. call: bluesky.graphgetfollows outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.getKnownFollowers name: graphgetknownfollowers operations: - method: GET name: graphgetknownfollowers description: Bluesky Enumerates accounts which follow a specified account (actor) and are followed by the viewer. call: bluesky.graphgetknownfollowers outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.getList name: graphgetlist operations: - method: GET name: graphgetlist description: Bluesky Gets a 'view' (with additional context) of a specified list. call: bluesky.graphgetlist outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.getListBlocks name: graphgetlistblocks operations: - method: GET name: graphgetlistblocks description: Bluesky Get mod lists that the requesting account (actor) is blocking. call: bluesky.graphgetlistblocks outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.getListMutes name: graphgetlistmutes operations: - method: GET name: graphgetlistmutes description: Bluesky Enumerates mod lists that the requesting account (actor) currently has muted. call: bluesky.graphgetlistmutes outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.getLists name: graphgetlists operations: - method: GET name: graphgetlists description: Bluesky Enumerates the lists created by a specified account (actor). call: bluesky.graphgetlists outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.getMutes name: graphgetmutes operations: - method: GET name: graphgetmutes description: Bluesky Enumerates accounts that the requesting account (actor) currently has muted. call: bluesky.graphgetmutes outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.getRelationships name: graphgetrelationships operations: - method: GET name: graphgetrelationships description: Bluesky Enumerates public relationships between one account, and a list of other accounts. call: bluesky.graphgetrelationships outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.getStarterPack name: graphgetstarterpack operations: - method: GET name: graphgetstarterpack description: Bluesky Gets a view of a starter pack. call: bluesky.graphgetstarterpack outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.getStarterPacks name: graphgetstarterpacks operations: - method: GET name: graphgetstarterpacks description: Bluesky Get views for a list of starter packs. call: bluesky.graphgetstarterpacks outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.getSuggestedFollowsByActor name: graphgetsuggestedfollowsbyactor operations: - method: GET name: graphgetsuggestedfollowsbyactor description: Bluesky Enumerates follows similar to a given account (actor). call: bluesky.graphgetsuggestedfollowsbyactor outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.muteActor name: graphmuteactor operations: - method: POST name: graphmuteactor description: Bluesky Creates a mute relationship for the specified account. call: bluesky.graphmuteactor outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.muteActorList name: graphmuteactorlist operations: - method: POST name: graphmuteactorlist description: Bluesky Creates a mute relationship for the specified list of accounts. call: bluesky.graphmuteactorlist outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.muteThread name: graphmutethread operations: - method: POST name: graphmutethread description: Bluesky Mutes a thread preventing notifications from the thread and any of its children. call: bluesky.graphmutethread outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.unmuteActor name: graphunmuteactor operations: - method: POST name: graphunmuteactor description: Bluesky Unmutes the specified account. call: bluesky.graphunmuteactor outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.unmuteActorList name: graphunmuteactorlist operations: - method: POST name: graphunmuteactorlist description: Bluesky Unmutes the specified list of accounts. call: bluesky.graphunmuteactorlist outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.graph.unmuteThread name: graphunmutethread operations: - method: POST name: graphunmutethread description: Bluesky Unmutes the specified thread. call: bluesky.graphunmutethread outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.labeler.getServices name: labelergetservices operations: - method: GET name: labelergetservices description: Bluesky Get information about a list of labeler services. call: bluesky.labelergetservices outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.notification.getUnreadCount name: notificationgetunreadcount operations: - method: GET name: notificationgetunreadcount description: Bluesky Count the number of unread notifications for the requesting account. call: bluesky.notificationgetunreadcount outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.notification.listNotifications name: notificationlistnotifications operations: - method: GET name: notificationlistnotifications description: Bluesky Enumerate notifications for the requesting account. call: bluesky.notificationlistnotifications outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.notification.putPreferences name: notificationputpreferences operations: - method: POST name: notificationputpreferences description: Bluesky Set notification-related preferences for an account. call: bluesky.notificationputpreferences outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.notification.registerPush name: notificationregisterpush operations: - method: POST name: notificationregisterpush description: Bluesky Register to receive push notifications, via a specified service, for the requesting account. call: bluesky.notificationregisterpush outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.notification.updateSeen name: notificationupdateseen operations: - method: POST name: notificationupdateseen description: Bluesky Notify server that the requesting account has seen notifications. call: bluesky.notificationupdateseen outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.video.getJobStatus name: videogetjobstatus operations: - method: GET name: videogetjobstatus description: Bluesky Get status details for a video processing job. call: bluesky.videogetjobstatus outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.video.getUploadLimits name: videogetuploadlimits operations: - method: GET name: videogetuploadlimits description: Bluesky Get video upload limits for the authenticated user. call: bluesky.videogetuploadlimits outputParameters: - type: object mapping: $. - path: /xrpc/app.bsky.video.uploadVideo name: videouploadvideo operations: - method: POST name: videouploadvideo description: Bluesky Upload a video to be processed then stored on the PDS. call: bluesky.videouploadvideo outputParameters: - type: object mapping: $. - path: /xrpc/chat.bsky.actor.deleteAccount name: chatactordeleteaccount operations: - method: POST name: chatactordeleteaccount description: Bluesky Operation call: bluesky.chatactordeleteaccount outputParameters: - type: object mapping: $. - path: /xrpc/chat.bsky.actor.exportAccountData name: chatactorexportaccountdata operations: - method: GET name: chatactorexportaccountdata description: Bluesky Operation call: bluesky.chatactorexportaccountdata outputParameters: - type: object mapping: $. - path: /xrpc/chat.bsky.convo.deleteMessageForSelf name: chatconvodeletemessageforself operations: - method: POST name: chatconvodeletemessageforself description: Bluesky Operation call: bluesky.chatconvodeletemessageforself outputParameters: - type: object mapping: $. - path: /xrpc/chat.bsky.convo.getConvo name: chatconvogetconvo operations: - method: GET name: chatconvogetconvo description: Bluesky Operation call: bluesky.chatconvogetconvo outputParameters: - type: object mapping: $. - path: /xrpc/chat.bsky.convo.getConvoForMembers name: chatconvogetconvoformembers operations: - method: GET name: chatconvogetconvoformembers description: Bluesky Operation call: bluesky.chatconvogetconvoformembers outputParameters: - type: object mapping: $. - path: /xrpc/chat.bsky.convo.getLog name: chatconvogetlog operations: - method: GET name: chatconvogetlog description: Bluesky Operation call: bluesky.chatconvogetlog outputParameters: - type: object mapping: $. - type: mcp port: 9090 namespace: bluesky-mcp transport: http description: MCP adapter for Bluesky Social API for AI agent use. tools: - name: actorgetpreferences description: Bluesky Get private preferences attached to the current account. hints: readOnly: true destructive: false idempotent: true call: bluesky.actorgetpreferences outputParameters: - type: object mapping: $. - name: actorgetprofile description: Bluesky Get detailed profile view of an actor. hints: readOnly: true destructive: false idempotent: true call: bluesky.actorgetprofile with: actor: tools.actor inputParameters: - name: actor type: string description: Handle or DID of account to fetch profile of. required: true outputParameters: - type: object mapping: $. - name: actorgetprofiles description: Bluesky Get detailed profile views of multiple actors. hints: readOnly: true destructive: false idempotent: true call: bluesky.actorgetprofiles with: actors: tools.actors inputParameters: - name: actors type: array description: actors required: true outputParameters: - type: object mapping: $. - name: actorgetsuggestions description: Bluesky Get a list of suggested actors. hints: readOnly: true destructive: false idempotent: true call: bluesky.actorgetsuggestions with: limit: tools.limit cursor: tools.cursor inputParameters: - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: actorputpreferences description: Bluesky Set the private preferences attached to the account. hints: readOnly: false destructive: false idempotent: false call: bluesky.actorputpreferences outputParameters: - type: object mapping: $. - name: actorsearchactors description: Bluesky Find actors (profiles) matching search criteria. hints: readOnly: true destructive: false idempotent: true call: bluesky.actorsearchactors with: q: tools.q limit: tools.limit cursor: tools.cursor inputParameters: - name: q type: string description: Search query string. Syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended. - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: actorsearchactorstypeahead description: Bluesky Find actor suggestions for a prefix search term. hints: readOnly: true destructive: false idempotent: true call: bluesky.actorsearchactorstypeahead with: q: tools.q limit: tools.limit inputParameters: - name: q type: string description: Search query prefix; not a full query string. - name: limit type: integer description: limit outputParameters: - type: object mapping: $. - name: feeddescribefeedgenerator description: Bluesky Get information about a feed generator, including policies and offered feed URIs. hints: readOnly: true destructive: false idempotent: true call: bluesky.feeddescribefeedgenerator outputParameters: - type: object mapping: $. - name: feedgetactorfeeds description: Bluesky Get a list of feeds (feed generator records) created by the actor (in the actor's repo). hints: readOnly: true destructive: false idempotent: true call: bluesky.feedgetactorfeeds with: actor: tools.actor limit: tools.limit cursor: tools.cursor inputParameters: - name: actor type: string description: actor required: true - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: feedgetactorlikes description: Bluesky Get a list of posts liked by an actor. hints: readOnly: true destructive: false idempotent: true call: bluesky.feedgetactorlikes with: actor: tools.actor limit: tools.limit cursor: tools.cursor inputParameters: - name: actor type: string description: actor required: true - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: feedgetauthorfeed description: Bluesky Get a view of an actor's 'author feed' (post and reposts by the author). hints: readOnly: true destructive: false idempotent: true call: bluesky.feedgetauthorfeed with: actor: tools.actor limit: tools.limit cursor: tools.cursor filter: tools.filter includePins: tools.includePins inputParameters: - name: actor type: string description: actor required: true - name: limit type: integer description: limit - name: cursor type: string description: cursor - name: filter type: string description: Combinations of post/repost types to include in response. - name: includePins type: boolean description: includePins outputParameters: - type: object mapping: $. - name: feedgetfeed description: Bluesky Get a hydrated feed from an actor's selected feed generator. hints: readOnly: true destructive: false idempotent: true call: bluesky.feedgetfeed with: feed: tools.feed limit: tools.limit cursor: tools.cursor inputParameters: - name: feed type: string description: feed required: true - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: feedgetfeedgenerator description: Bluesky Get information about a feed generator. hints: readOnly: true destructive: false idempotent: true call: bluesky.feedgetfeedgenerator with: feed: tools.feed inputParameters: - name: feed type: string description: AT-URI of the feed generator record. required: true outputParameters: - type: object mapping: $. - name: feedgetfeedgenerators description: Bluesky Get information about a list of feed generators. hints: readOnly: true destructive: false idempotent: true call: bluesky.feedgetfeedgenerators with: feeds: tools.feeds inputParameters: - name: feeds type: array description: feeds required: true outputParameters: - type: object mapping: $. - name: feedgetfeedskeleton description: Bluesky Get a skeleton of a feed provided by a feed generator. hints: readOnly: true destructive: false idempotent: true call: bluesky.feedgetfeedskeleton with: feed: tools.feed limit: tools.limit cursor: tools.cursor inputParameters: - name: feed type: string description: Reference to feed generator record describing the specific feed being requested. required: true - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: feedgetlikes description: Bluesky Get like records which reference a subject (by AT-URI and CID). hints: readOnly: true destructive: false idempotent: true call: bluesky.feedgetlikes with: uri: tools.uri cid: tools.cid limit: tools.limit cursor: tools.cursor inputParameters: - name: uri type: string description: AT-URI of the subject (eg, a post record). required: true - name: cid type: string description: CID of the subject record (aka, specific version of record), to filter likes. - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: feedgetlistfeed description: Bluesky Get a feed of recent posts from a list (posts and reposts from any actors on the list). hints: readOnly: true destructive: false idempotent: true call: bluesky.feedgetlistfeed with: list: tools.list limit: tools.limit cursor: tools.cursor inputParameters: - name: list type: string description: Reference (AT-URI) to the list record. required: true - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: feedgetpostthread description: Bluesky Get posts in a thread. hints: readOnly: true destructive: false idempotent: true call: bluesky.feedgetpostthread with: uri: tools.uri depth: tools.depth parentHeight: tools.parentHeight inputParameters: - name: uri type: string description: Reference (AT-URI) to post record. required: true - name: depth type: integer description: How many levels of reply depth should be included in response. - name: parentHeight type: integer description: How many levels of parent (and grandparent, etc) post to include. outputParameters: - type: object mapping: $. - name: feedgetposts description: Bluesky Gets post views for a specified list of posts (by AT-URI). hints: readOnly: true destructive: false idempotent: true call: bluesky.feedgetposts with: uris: tools.uris inputParameters: - name: uris type: array description: List of post AT-URIs to return hydrated views for. required: true outputParameters: - type: object mapping: $. - name: feedgetquotes description: Bluesky Get a list of quotes for a given post. hints: readOnly: true destructive: false idempotent: true call: bluesky.feedgetquotes with: uri: tools.uri cid: tools.cid limit: tools.limit cursor: tools.cursor inputParameters: - name: uri type: string description: Reference (AT-URI) of post record required: true - name: cid type: string description: If supplied, filters to quotes of specific version (by CID) of the post record. - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: feedgetrepostedby description: Bluesky Get a list of reposts for a given post. hints: readOnly: true destructive: false idempotent: true call: bluesky.feedgetrepostedby with: uri: tools.uri cid: tools.cid limit: tools.limit cursor: tools.cursor inputParameters: - name: uri type: string description: Reference (AT-URI) of post record required: true - name: cid type: string description: If supplied, filters to reposts of specific version (by CID) of the post record. - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: feedgetsuggestedfeeds description: Bluesky Get a list of suggested feeds (feed generators) for the requesting account. hints: readOnly: true destructive: false idempotent: true call: bluesky.feedgetsuggestedfeeds with: limit: tools.limit cursor: tools.cursor inputParameters: - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: feedgettimeline description: Bluesky Get a view of the requesting account's home timeline. hints: readOnly: true destructive: false idempotent: true call: bluesky.feedgettimeline with: algorithm: tools.algorithm limit: tools.limit cursor: tools.cursor inputParameters: - name: algorithm type: string description: 'Variant ''algorithm'' for timeline. Implementation-specific. NOTE: most feed flexibility has been moved to feed generator mechanism.' - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: feedsearchposts description: Bluesky Find posts matching search criteria, returning views of those posts. hints: readOnly: true destructive: false idempotent: true call: bluesky.feedsearchposts with: q: tools.q sort: tools.sort since: tools.since until: tools.until mentions: tools.mentions author: tools.author lang: tools.lang domain: tools.domain url: tools.url tag: tools.tag limit: tools.limit cursor: tools.cursor inputParameters: - name: q type: string description: Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended. required: true - name: sort type: string description: Specifies the ranking order of results. - name: since type: string description: Filter results for posts after the indicated datetime (inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'. Can be a datetime, or ju - name: until type: string description: 'Filter results for posts before the indicated datetime (not inclusive). Expected to use ''sortAt'' timestamp, which may not match ''createdAt''. Can be a datetime, ' - name: mentions type: string description: Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only matches rich-text facet mentions. - name: author type: string description: Filter to posts by the given account. Handles are resolved to DID before query-time. - name: lang type: string description: Filter to posts in the given language. Expected to be based on post language field, though server may override language detection. - name: domain type: string description: Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization. - name: url type: string description: Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching. - name: tag type: array description: Filter to posts with the given tag (hashtag), based on rich-text facet or tag field. Do not include the hash (#) prefix. Multiple tags can be specified, with 'A - name: limit type: integer description: limit - name: cursor type: string description: Optional pagination mechanism; may not necessarily allow scrolling through entire result set. outputParameters: - type: object mapping: $. - name: feedsendinteractions description: Bluesky Send information about interactions with feed items back to the feed generator that served them. hints: readOnly: false destructive: false idempotent: false call: bluesky.feedsendinteractions outputParameters: - type: object mapping: $. - name: graphgetactorstarterpacks description: Bluesky Get a list of starter packs created by the actor. hints: readOnly: true destructive: false idempotent: true call: bluesky.graphgetactorstarterpacks with: actor: tools.actor limit: tools.limit cursor: tools.cursor inputParameters: - name: actor type: string description: actor required: true - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: graphgetblocks description: Bluesky Enumerates which accounts the requesting account is currently blocking. hints: readOnly: true destructive: false idempotent: true call: bluesky.graphgetblocks with: limit: tools.limit cursor: tools.cursor inputParameters: - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: graphgetfollowers description: Bluesky Enumerates accounts which follow a specified account (actor). hints: readOnly: true destructive: false idempotent: true call: bluesky.graphgetfollowers with: actor: tools.actor limit: tools.limit cursor: tools.cursor inputParameters: - name: actor type: string description: actor required: true - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: graphgetfollows description: Bluesky Enumerates accounts which a specified account (actor) follows. hints: readOnly: true destructive: false idempotent: true call: bluesky.graphgetfollows with: actor: tools.actor limit: tools.limit cursor: tools.cursor inputParameters: - name: actor type: string description: actor required: true - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: graphgetknownfollowers description: Bluesky Enumerates accounts which follow a specified account (actor) and are followed by the viewer. hints: readOnly: true destructive: false idempotent: true call: bluesky.graphgetknownfollowers with: actor: tools.actor limit: tools.limit cursor: tools.cursor inputParameters: - name: actor type: string description: actor required: true - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: graphgetlist description: Bluesky Gets a 'view' (with additional context) of a specified list. hints: readOnly: true destructive: false idempotent: true call: bluesky.graphgetlist with: list: tools.list limit: tools.limit cursor: tools.cursor inputParameters: - name: list type: string description: Reference (AT-URI) of the list record to hydrate. required: true - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: graphgetlistblocks description: Bluesky Get mod lists that the requesting account (actor) is blocking. hints: readOnly: true destructive: false idempotent: true call: bluesky.graphgetlistblocks with: limit: tools.limit cursor: tools.cursor inputParameters: - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: graphgetlistmutes description: Bluesky Enumerates mod lists that the requesting account (actor) currently has muted. hints: readOnly: true destructive: false idempotent: true call: bluesky.graphgetlistmutes with: limit: tools.limit cursor: tools.cursor inputParameters: - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: graphgetlists description: Bluesky Enumerates the lists created by a specified account (actor). hints: readOnly: true destructive: false idempotent: true call: bluesky.graphgetlists with: actor: tools.actor limit: tools.limit cursor: tools.cursor inputParameters: - name: actor type: string description: The account (actor) to enumerate lists from. required: true - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: graphgetmutes description: Bluesky Enumerates accounts that the requesting account (actor) currently has muted. hints: readOnly: true destructive: false idempotent: true call: bluesky.graphgetmutes with: limit: tools.limit cursor: tools.cursor inputParameters: - name: limit type: integer description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: graphgetrelationships description: Bluesky Enumerates public relationships between one account, and a list of other accounts. hints: readOnly: true destructive: false idempotent: true call: bluesky.graphgetrelationships with: actor: tools.actor others: tools.others inputParameters: - name: actor type: string description: Primary account requesting relationships for. required: true - name: others type: array description: List of 'other' accounts to be related back to the primary. outputParameters: - type: object mapping: $. - name: graphgetstarterpack description: Bluesky Gets a view of a starter pack. hints: readOnly: true destructive: false idempotent: true call: bluesky.graphgetstarterpack with: starterPack: tools.starterPack inputParameters: - name: starterPack type: string description: Reference (AT-URI) of the starter pack record. required: true outputParameters: - type: object mapping: $. - name: graphgetstarterpacks description: Bluesky Get views for a list of starter packs. hints: readOnly: true destructive: false idempotent: true call: bluesky.graphgetstarterpacks with: uris: tools.uris inputParameters: - name: uris type: array description: uris required: true outputParameters: - type: object mapping: $. - name: graphgetsuggestedfollowsbyactor description: Bluesky Enumerates follows similar to a given account (actor). hints: readOnly: true destructive: false idempotent: true call: bluesky.graphgetsuggestedfollowsbyactor with: actor: tools.actor inputParameters: - name: actor type: string description: actor required: true outputParameters: - type: object mapping: $. - name: graphmuteactor description: Bluesky Creates a mute relationship for the specified account. hints: readOnly: false destructive: false idempotent: false call: bluesky.graphmuteactor outputParameters: - type: object mapping: $. - name: graphmuteactorlist description: Bluesky Creates a mute relationship for the specified list of accounts. hints: readOnly: false destructive: false idempotent: false call: bluesky.graphmuteactorlist outputParameters: - type: object mapping: $. - name: graphmutethread description: Bluesky Mutes a thread preventing notifications from the thread and any of its children. hints: readOnly: false destructive: false idempotent: false call: bluesky.graphmutethread outputParameters: - type: object mapping: $. - name: graphunmuteactor description: Bluesky Unmutes the specified account. hints: readOnly: false destructive: false idempotent: false call: bluesky.graphunmuteactor outputParameters: - type: object mapping: $. - name: graphunmuteactorlist description: Bluesky Unmutes the specified list of accounts. hints: readOnly: false destructive: false idempotent: false call: bluesky.graphunmuteactorlist outputParameters: - type: object mapping: $. - name: graphunmutethread description: Bluesky Unmutes the specified thread. hints: readOnly: false destructive: false idempotent: false call: bluesky.graphunmutethread outputParameters: - type: object mapping: $. - name: labelergetservices description: Bluesky Get information about a list of labeler services. hints: readOnly: true destructive: false idempotent: true call: bluesky.labelergetservices with: dids: tools.dids detailed: tools.detailed inputParameters: - name: dids type: array description: dids required: true - name: detailed type: boolean description: detailed outputParameters: - type: object mapping: $. - name: notificationgetunreadcount description: Bluesky Count the number of unread notifications for the requesting account. hints: readOnly: true destructive: false idempotent: true call: bluesky.notificationgetunreadcount with: priority: tools.priority seenAt: tools.seenAt inputParameters: - name: priority type: boolean description: priority - name: seenAt type: string description: seenAt outputParameters: - type: object mapping: $. - name: notificationlistnotifications description: Bluesky Enumerate notifications for the requesting account. hints: readOnly: true destructive: false idempotent: true call: bluesky.notificationlistnotifications with: limit: tools.limit priority: tools.priority cursor: tools.cursor seenAt: tools.seenAt inputParameters: - name: limit type: integer description: limit - name: priority type: boolean description: priority - name: cursor type: string description: cursor - name: seenAt type: string description: seenAt outputParameters: - type: object mapping: $. - name: notificationputpreferences description: Bluesky Set notification-related preferences for an account. hints: readOnly: false destructive: false idempotent: false call: bluesky.notificationputpreferences outputParameters: - type: object mapping: $. - name: notificationregisterpush description: Bluesky Register to receive push notifications, via a specified service, for the requesting account. hints: readOnly: false destructive: false idempotent: false call: bluesky.notificationregisterpush outputParameters: - type: object mapping: $. - name: notificationupdateseen description: Bluesky Notify server that the requesting account has seen notifications. hints: readOnly: false destructive: false idempotent: false call: bluesky.notificationupdateseen outputParameters: - type: object mapping: $. - name: videogetjobstatus description: Bluesky Get status details for a video processing job. hints: readOnly: true destructive: false idempotent: true call: bluesky.videogetjobstatus with: jobId: tools.jobId inputParameters: - name: jobId type: string description: jobId required: true outputParameters: - type: object mapping: $. - name: videogetuploadlimits description: Bluesky Get video upload limits for the authenticated user. hints: readOnly: true destructive: false idempotent: true call: bluesky.videogetuploadlimits outputParameters: - type: object mapping: $. - name: videouploadvideo description: Bluesky Upload a video to be processed then stored on the PDS. hints: readOnly: false destructive: false idempotent: false call: bluesky.videouploadvideo outputParameters: - type: object mapping: $. - name: chatactordeleteaccount description: Bluesky Operation hints: readOnly: false destructive: false idempotent: false call: bluesky.chatactordeleteaccount outputParameters: - type: object mapping: $. - name: chatactorexportaccountdata description: Bluesky Operation hints: readOnly: true destructive: false idempotent: true call: bluesky.chatactorexportaccountdata outputParameters: - type: object mapping: $. - name: chatconvodeletemessageforself description: Bluesky Operation hints: readOnly: false destructive: false idempotent: false call: bluesky.chatconvodeletemessageforself outputParameters: - type: object mapping: $. - name: chatconvogetconvo description: Bluesky Operation hints: readOnly: true destructive: false idempotent: true call: bluesky.chatconvogetconvo with: convoId: tools.convoId inputParameters: - name: convoId type: string description: convoId required: true outputParameters: - type: object mapping: $. - name: chatconvogetconvoformembers description: Bluesky Operation hints: readOnly: true destructive: false idempotent: true call: bluesky.chatconvogetconvoformembers with: members: tools.members inputParameters: - name: members type: array description: members required: true outputParameters: - type: object mapping: $. - name: chatconvogetlog description: Bluesky Operation hints: readOnly: true destructive: false idempotent: true call: bluesky.chatconvogetlog with: cursor: tools.cursor inputParameters: - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. binds: - namespace: env keys: BLUESKY_TOKEN: BLUESKY_TOKEN