Bluesky MCP server for your AI

Add an account to one of this account's lists.

Block an account: neither side sees the other's posts or can interact.

Create a list.

Follow an account.

Enumerates accounts which follow a specified account (actor).

Enumerates accounts which a specified account (actor) follows.

Gets a 'view' (with additional context) of a specified list.

Enumerates the lists created by a specified account (actor).

Creates a mute relationship for the specified account.

Remove an account from one of this account's lists.

Remove a block on an account.

Stop following an account.

Unmutes the specified account.

Returns a page of messages from a conversation.

Returns a page of conversations (direct or group) for the user.

Send a direct message to one person, starting the conversation if there is none.

Publish a post on Bluesky, publicly and at once: confirm with the user first unless they clearly asked for it.

Publish a thread: several posts, each replying to the one before.

Delete one of this account's own posts.

Get a view of an actor's 'author feed' (post and reposts by the author).

Get a hydrated feed from an actor's selected feed generator.

Get like records which reference a subject (by AT-URI and CID).

Get posts in a thread.

Gets post views for a specified list of posts (by AT-URI).

Get a list of quotes for a given post.

Get a list of reposts for a given post.

Get a list of suggested feeds (feed generators) for the requesting account.

Get a view of the requesting account's home timeline.

Like a post.

Repost a post to this account's followers.

Save a custom feed or list to this account, optionally pinned to its home tabs.

Find posts matching search criteria, returning views of those posts.

Change who may reply to one of this account's own posts: everyone, nobody, mentioned, following or followers.

Remove this account's like from a post.

Undo this account's repost of a post.

Remove a saved custom feed or list from this account.

Get a list of trending topics Returns: topics, suggested.

This account at a glance: profile and follower counts, unread notifications, and how its recent posts did (totals and the top 5 by engagement).

Get detailed profile view of an actor.

Count the number of unread notifications for the requesting account.

Enumerate notifications for the requesting account.

List a range of records in a repository, matching a specific collection.

Find actors (profiles) matching search criteria.

Change this account's profile: display name, bio, avatar, banner, website or pinned post.

Upload an image and get the blob reference a record needs.

Get a direct link to a file (image or video) stored on an account, from the cid of its blob reference.

Creates a private bookmark for the specified record.

Gets views of records bookmarked by the authenticated user.

Get status details for a video processing job.

Upload an MP4 video from a public link for Bluesky to process, as the first step of a video post.

Get a list of starter packs created by the actor.

Enumerates which accounts the requesting account is currently blocking.

Enumerates accounts which follow a specified account (actor) and are followed by the viewer.

Get mod lists that the requesting account (actor) is blocking.

Enumerates mod lists that the requesting account (actor) currently has muted.

Enumerates the lists created by the session user, and includes membership information about `actor` in those lists.

Enumerates accounts that the requesting account (actor) currently has fully muted.

Enumerates public relationships between one account, and a list of other accounts.

Gets a view of a starter pack.

Get views for a list of starter packs.

Enumerates the starter packs created by the session user, and includes membership information about `actor` in those starter packs.

Enumerates follows similar to a given account (actor).

Creates a mute relationship for the specified list of accounts.

Mutes a thread preventing notifications from the thread and any of its children.

Find starter packs matching search criteria.

Find starter packs matching search criteria.

Unmutes the specified list of accounts.

Unmutes the specified thread.

Marks a conversation as accepted, so it is shown in the list of accepted convos instead on the request convos.

Adds an emoji reaction to a message.

Delete this account's direct messages data.

Marks a message as deleted for the viewer, so they won't see that message in future enumerations.

Export this account's direct messages as JSON lines.

Get the requesting account's chat notification preferences.

Get the authenticated viewer's chat status: whether their account is chat-disabled and whether their group-membership additions are restricted to accounts they follow.

Gets an existing conversation by its ID.

Check whether the requester and the other members can start a 1-1 chat.

Get or create a 1-1 conversation for the given members.

Get recent changes across this account's conversations (new messages, reads, joins), for catching up since a cursor.

Returns a paginated list of members from a conversation.

Returns unread conversation counts for conversations that are unlocked, not muted, split by convo status.

Leaves a conversation (direct or group).

Returns a page of incoming conversation requests for the user.

Locks a group convo so no more content (messages, reactions) can be added to it.

Sets conversations from an user as read to the latest message, with filters.

Updates the read state of a conversation from, optionally specifying the last read message.

Mutes a conversation, preventing notifications related to it.

Set the requesting account's chat notification preferences.

Removes an emoji reaction from a message.

Sends a message to a conversation.

Sends a batch of messages to a conversation.

Unlocks a group convo so it is able to receive new content.

Unmutes a conversation, allowing notifications related to it.

Get a list of feeds (feed generator records) created by the actor (in the actor's repo).

Get a list of posts liked by an actor.

Get information about a feed generator.

Get information about a list of feed generators.

Get a feed of recent posts from a list (posts and reposts from any actors on the list).

Find posts matching a search query, using Bluesky's newer search.

Send information about interactions with feed items back to the feed generator that served them.

Returns the current state of the age assurance process for an account.

Get app configuration Bluesky publishes for its clients, such as which features are switched on.

Get Atmosphere Explore content.

Get the authenticated viewer's Atmosphere activity timeline.

Get a list of suggested starterpacks for onboarding Returns: starterPacks, recIdStr.

An unspecced view of globally popular feed generators.

(NOTE: this endpoint is under development and WILL change without notice.

(NOTE: this endpoint is under development and WILL change without notice.

Get a list of suggested feeds Returns: feeds, recIdStr.

Get a list of suggested users for onboarding Returns: actors, recId, recIdStr.

Get a list of suggested starterpacks Returns: starterPacks, recIdStr.

Get a list of suggested users Returns: actors, recId, recIdStr.

Get a list of suggested users for the Discover page Returns: actors, recIdStr.

Get a list of suggested users for the Explore page Returns: actors, recIdStr.

Get a list of suggested users for the See More page Returns: actors, recIdStr.

Get suggested feeds and accounts Bluesky tags by topic.

Get the current trends on the network Returns: trends, recIdStr.

Initiate age assurance for an account.

Adds members to a group.

Approves a request to join a group (via join link) the user owns.

Creates a group convo, specifying the members to be added to it.

Creates a join link for the group convo.

Disables the active join link for the group convo.

Edits group settings.

Edits the existing join link settings for the group convo.

Re-enables a previously disabled join link for the group convo.

Get public information about groups from join links.

Lists a page of request to join a group (via join link) the user owns.

Returns a page of group conversations that both the requester and the specified actor are members of.

Marks all join requests as read for the group owner.

Rejects a request to join a group (via join link) the user owns.

Removes members from a group.

Sends a request to join a group (via join link) to the group owner.

Withdraws a pending request to join a group.

Apply a batch transaction of repository creates, updates, and deletes.

Create a single new repository record.

Delete a repository record, or ensure it doesn't exist.

Get information about an account and repository, including the list of collections.

Get private preferences attached to the current account.

[UNSTABLE - DO NOT USE THIS ENDPOINT WHILE THIS NOTE IS HERE] Enumerate notifications for the requesting account, pre-grouped for rendering.

Get notification-related preferences for an account.

Get detailed profile views of multiple actors.

Get a single record from a repository.

Get a list of suggested actors.

Enumerate all accounts to which the requesting account is subscribed to receive notifications for.

Returns a list of missing blobs for the requesting account.

Set the private preferences attached to the account.

Puts an activity subscription entry.

Set notification-related preferences for an account.

Set notification-related preferences for an account.

Write a repository record, creating or updating it as needed.

Find actor suggestions for a prefix search term.

Notify server that the requesting account has seen notifications.

Removes a match that was found via contact import.

Returns the matched contacts (contacts that were mutually imported).

Gets the user's current contact import status.

Returns information about a specified upstream host, as consumed by the server.

Get the current commit CID & revision of the specified repo.

Get the hosting status for a repository, on this server.

Import contacts for securely matching with other users.

List blob CIDs for an account, since some repo revision.

Enumerates upstream hosts (eg, PDS or relay instances) that this service consumes from.

Enumerates all the DID, rev, and commit CID for all repos hosted by this service.

Enumerates all the DIDs which have records with the given collection NSID.

Removes all stored hashes used for contact matching, existing matches, and sync status.

System endpoint to send notifications related to contact imports.

Starts a phone verification flow.

Verifies control over a phone number with a code received via SMS and starts a contact import session.

Returns the status of an account, especially as pertaining to import or recovery.

Checks whether the provided handle is available.

Allows finding the oauth permission scope from a reference Returns: scope.

Describes the server's account creation requirements and capabilities.

Get information about the current auth session.

Inserts a draft using private storage (stash).

Deletes a draft by ID.

Gets views of user drafts.

Request that the server re-resolve an identity (DID and handle).

Resolves DID to DID document.

Resolves an atproto handle (hostname) to a DID.

Resolves an identity (DID or Handle) to a full identity (DID document and verified handle).

Updates a draft using private storage (stash).

Initiate Age Assurance for an account.

Deletes a private bookmark for the specified record.

Returns Age Assurance configuration for use on the client.

Returns server-computed Age Assurance state, if available, and any additional metadata needed to compute Age Assurance state client-side.

Get video upload limits for the authenticated user.

Submit a moderation report regarding an atproto account or record.

Resolve one AT-URI record into the data needed to render an enhanced external embed.

Get information about a list of labeler services.

Find labels relevant to the provided AT-URI patterns.

Resolves an atproto lexicon (NSID) to a schema.