Bluesky Social API
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).
What You Can Do
MCP Tools
actorgetpreferences
Bluesky Get private preferences attached to the current account.
actorgetprofile
Bluesky Get detailed profile view of an actor.
actorgetprofiles
Bluesky Get detailed profile views of multiple actors.
actorgetsuggestions
Bluesky Get a list of suggested actors.
actorputpreferences
Bluesky Set the private preferences attached to the account.
actorsearchactors
Bluesky Find actors (profiles) matching search criteria.
actorsearchactorstypeahead
Bluesky Find actor suggestions for a prefix search term.
feeddescribefeedgenerator
Bluesky Get information about a feed generator, including policies and offered feed URIs.
feedgetactorfeeds
Bluesky Get a list of feeds (feed generator records) created by the actor (in the actor's repo).
feedgetactorlikes
Bluesky Get a list of posts liked by an actor.
feedgetauthorfeed
Bluesky Get a view of an actor's 'author feed' (post and reposts by the author).
feedgetfeed
Bluesky Get a hydrated feed from an actor's selected feed generator.
feedgetfeedgenerator
Bluesky Get information about a feed generator.
feedgetfeedgenerators
Bluesky Get information about a list of feed generators.
feedgetfeedskeleton
Bluesky Get a skeleton of a feed provided by a feed generator.
feedgetlikes
Bluesky Get like records which reference a subject (by AT-URI and CID).
feedgetlistfeed
Bluesky Get a feed of recent posts from a list (posts and reposts from any actors on the list).
feedgetpostthread
Bluesky Get posts in a thread.
feedgetposts
Bluesky Gets post views for a specified list of posts (by AT-URI).
feedgetquotes
Bluesky Get a list of quotes for a given post.
feedgetrepostedby
Bluesky Get a list of reposts for a given post.
feedgetsuggestedfeeds
Bluesky Get a list of suggested feeds (feed generators) for the requesting account.
feedgettimeline
Bluesky Get a view of the requesting account's home timeline.
feedsearchposts
Bluesky Find posts matching search criteria, returning views of those posts.
feedsendinteractions
Bluesky Send information about interactions with feed items back to the feed generator that served them.
graphgetactorstarterpacks
Bluesky Get a list of starter packs created by the actor.
graphgetblocks
Bluesky Enumerates which accounts the requesting account is currently blocking.
graphgetfollowers
Bluesky Enumerates accounts which follow a specified account (actor).
graphgetfollows
Bluesky Enumerates accounts which a specified account (actor) follows.
graphgetknownfollowers
Bluesky Enumerates accounts which follow a specified account (actor) and are followed by the viewer.
graphgetlist
Bluesky Gets a 'view' (with additional context) of a specified list.
graphgetlistblocks
Bluesky Get mod lists that the requesting account (actor) is blocking.
graphgetlistmutes
Bluesky Enumerates mod lists that the requesting account (actor) currently has muted.
graphgetlists
Bluesky Enumerates the lists created by a specified account (actor).
graphgetmutes
Bluesky Enumerates accounts that the requesting account (actor) currently has muted.
graphgetrelationships
Bluesky Enumerates public relationships between one account, and a list of other accounts.
graphgetstarterpack
Bluesky Gets a view of a starter pack.
graphgetstarterpacks
Bluesky Get views for a list of starter packs.
graphgetsuggestedfollowsbyactor
Bluesky Enumerates follows similar to a given account (actor).
graphmuteactor
Bluesky Creates a mute relationship for the specified account.
graphmuteactorlist
Bluesky Creates a mute relationship for the specified list of accounts.
graphmutethread
Bluesky Mutes a thread preventing notifications from the thread and any of its children.
graphunmuteactor
Bluesky Unmutes the specified account.
graphunmuteactorlist
Bluesky Unmutes the specified list of accounts.
graphunmutethread
Bluesky Unmutes the specified thread.
labelergetservices
Bluesky Get information about a list of labeler services.
notificationgetunreadcount
Bluesky Count the number of unread notifications for the requesting account.
notificationlistnotifications
Bluesky Enumerate notifications for the requesting account.
notificationputpreferences
Bluesky Set notification-related preferences for an account.
notificationregisterpush
Bluesky Register to receive push notifications, via a specified service, for the requesting account.
notificationupdateseen
Bluesky Notify server that the requesting account has seen notifications.
videogetjobstatus
Bluesky Get status details for a video processing job.
videogetuploadlimits
Bluesky Get video upload limits for the authenticated user.
videouploadvideo
Bluesky Upload a video to be processed then stored on the PDS.
chatactordeleteaccount
Bluesky Operation
chatactorexportaccountdata
Bluesky Operation
chatconvodeletemessageforself
Bluesky Operation
chatconvogetconvo
Bluesky Operation
chatconvogetconvoformembers
Bluesky Operation
chatconvogetlog
Bluesky Operation