Focus · Bluesky
Typed Focus mode operations for Bluesky accounts, generated from the Bluesky focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
focus_bluesky- Profile5
- Account status2
- Discoverability2
- Activity subscription policy2
- Posting defaults2
- Posts18
- Replies10
- Drafts5
- Timeline4
- Notifications4
- Conversations9
- Messages5
- Notification preferences2
- Activity subscriptions4
- Chat settings2
- Likes3
- Reposts3
- Bookmarks3
- Post engagement1
- Followers8
- Following5
- Blocks3
- Mutes3
- Suggested follows3
- Lists9
- List members3
- Starter packs7
- List subscriptions2
- Saved feeds5
- Feed generators6
- Feed posts1
- My feeds4
- Reports1
- Muted words4
- Content filters2
- Labelers3
- Hidden posts3
- Search posts3
- Search accounts3
- Search starter packs1
- Analytics overview1
- Post analytics1
- Video limits1
Profile
Bluesky: Get Profile
/accounts/{accountId}/bluesky/profileCurrent profile record and counters. Display name, bio, pronouns, website, avatar, banner, pinned post and account self-labels (bot, adult content, hide from logged-out viewers). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/profiles Generic route: /v1/accounts/{accountId}/focus/profile.
Try it with MCPAsk your agent to call bluesky-profile-get (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
idstringDID
didstringhandlestringdisplay_namestring | null≤ 64 graphemes
≤ 640 characters
descriptionstring | null≤ 256 graphemes
pronounsstring | null≤ 20 graphemes
websitestring (uri) | nullavatar_urlstring (uri) | nullbanner_urlstring (uri) | nullfollowers_countintegerfollowing_countintegerposts_countintegerpinned_poststring | nullAT-URI
self_labelsarray of stringverifiedbooleancreated_atstring (date-time) | nullurlstring (uri)Responses
Bluesky: Update Profile
/accounts/{accountId}/bluesky/profileEdit the profile (read-modify-write; unknown fields are preserved). Display name, bio, pronouns, website, avatar, banner, pinned post and account self-labels (bot, adult content, hide from logged-out viewers). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/profiles Generic route: /v1/accounts/{accountId}/focus/profile.
Try it with MCPAsk your agent to call bluesky-profile-update (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
display_namestring | nulldescriptionstring | nullpronounsstring | nullwebsitestring (uri) | nullavatarstringpng/jpeg ≤ 1 MB (media id or URL)
bannerstringpng/jpeg ≤ 1 MB, 3:1
remove_avatarbooleanremove_bannerbooleanpinned_poststring | nullAT-URI or bsky.app URL; null unpins
self_labelsarray of stringReturns object
idstringDID
didstringhandlestringdisplay_namestring | null≤ 64 graphemes
≤ 640 characters
descriptionstring | null≤ 256 graphemes
pronounsstring | null≤ 20 graphemes
websitestring (uri) | nullavatar_urlstring (uri) | nullbanner_urlstring (uri) | nullfollowers_countintegerfollowing_countintegerposts_countintegerpinned_poststring | nullAT-URI
self_labelsarray of stringverifiedbooleancreated_atstring (date-time) | nullurlstring (uri)Responses
Bluesky: Pin post (Profile)
/accounts/{accountId}/bluesky/profile/pin-postPin post. Display name, bio, pronouns, website, avatar, banner, pinned post and account self-labels (bot, adult content, hide from logged-out viewers). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/profiles Generic route: /v1/accounts/{accountId}/focus/profile.
Try it with MCPAsk your agent to call bluesky-profile-pin-post (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
uristringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Unpin post (Profile)
/accounts/{accountId}/bluesky/profile/unpin-postUnpin post. Display name, bio, pronouns, website, avatar, banner, pinned post and account self-labels (bot, adult content, hide from logged-out viewers). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/profiles Generic route: /v1/accounts/{accountId}/focus/profile.
Try it with MCPAsk your agent to call bluesky-profile-unpin-post (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Mark as automated (bot) (Profile)
/accounts/{accountId}/bluesky/profile/set-bot-labelBluesky asks automated accounts to carry the bot self-label. Display name, bio, pronouns, website, avatar, banner, pinned post and account self-labels (bot, adult content, hide from logged-out viewers). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/profiles Generic route: /v1/accounts/{accountId}/focus/profile.
Try it with MCPAsk your agent to call bluesky-profile-set-bot-label (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
enabledbooleanrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Account status
Bluesky: Get Account & handle
/accounts/{accountId}/bluesky/account-statusDID, PDS, auth mode, account status, email verification (required for video) and custom-domain handle. Requires one of: atproto. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/account-status.
Try it with MCPAsk your agent to call bluesky-account-status-get (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
didstringhandlestringactivebooleanstatusstring | nullemailstring | nullemail_confirmedboolean | nullpds_urlstring (uri)auth_modestringoauthapp_password
granted_scopesarray of stringResponses
Bluesky: Change handle (Account & handle)
/accounts/{accountId}/bluesky/account-status/update-handlecom.atproto.identity.updateHandle (10 per 5 min, 50 per day). DID, PDS, auth mode, account status, email verification (required for video) and custom-domain handle. Requires scopes: identity:handle. Requires one of: atproto. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/account-status.
Try it with MCPAsk your agent to call bluesky-account-status-update-handle (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
handlestringrequiredDomain with _atproto TXT or /.well-known/atproto-did already set up
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Discoverability
Bluesky: Get Discoverability
/accounts/{accountId}/bluesky/discoverabilityHide the account’s posts from algorithmic recommendations (app.bsky.actor.contentVisibilityDeclaration). Requires one of: repo:app.bsky.actor.contentVisibilityDeclaration | transition:generic. Network docs: https://bsky.network/docs/about-bluesky-content/visibility-preferences Generic route: /v1/accounts/{accountId}/focus/discoverability.
Try it with MCPAsk your agent to call bluesky-discoverability-get (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
hide_from_algorithmic_recommendationsbooleanResponses
Bluesky: Update Discoverability
/accounts/{accountId}/bluesky/discoverabilityHide the account’s posts from algorithmic recommendations (app.bsky.actor.contentVisibilityDeclaration). Requires one of: repo:app.bsky.actor.contentVisibilityDeclaration | transition:generic. Network docs: https://bsky.network/docs/about-bluesky-content/visibility-preferences Generic route: /v1/accounts/{accountId}/focus/discoverability.
Try it with MCPAsk your agent to call bluesky-discoverability-update (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
hide_from_algorithmic_recommendationsbooleanrequiredReturns object
hide_from_algorithmic_recommendationsbooleanResponses
Activity subscription policy
Bluesky: Get Who can subscribe
/accounts/{accountId}/bluesky/activity-subscription-policyWho may get notified when the account posts (app.bsky.notification.declaration). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/activity-subscription-policy.
Try it with MCPAsk your agent to call bluesky-activity-subscription-policy-get (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
allow_subscriptionsstringfollowersmutualsnone
Responses
Bluesky: Update Who can subscribe
/accounts/{accountId}/bluesky/activity-subscription-policyWho may get notified when the account posts (app.bsky.notification.declaration). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/activity-subscription-policy.
Try it with MCPAsk your agent to call bluesky-activity-subscription-policy-update (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
allow_subscriptionsstringrequiredfollowersmutualsnone
Returns object
allow_subscriptionsstringfollowersmutualsnone
Responses
Posting defaults
Bluesky: Get Posting defaults
/accounts/{accountId}/bluesky/posting-defaultsSocialit defaults for new posts: languages, reply/quote controls, content warnings, hidden tags, link cards and facet detection. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/posting-defaults.
Try it with MCPAsk your agent to call bluesky-posting-defaults-get (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
defaultLangsarray of string | nullLanguages written to every new post (langs). null = unset (Bluesky guesses).
1–3 items
defaultThreadgatearray of string | nullDefault reply controls. null = everyone can reply; [] = nobody; otherwise any of mentioned, followers, following, list:
≤ 5 items
defaultPostgateobject | nullDefault quote controls. null = quotes allowed.
Show 1 child attributes
disableQuotesbooleandefaultLabelsarray of stringSelf-labels (content warnings) applied to every new post.
≤ 10 items
defaultTagsarray of stringExtra hidden hashtags (tags) added to every new post.
≤ 8 items
autoFacetsbooleanDetect links, @mentions and #hashtags (default true).
autoLinkCardsbooleanBuild a link card from the first link when the post has no media (default true).
Responses
Bluesky: Update Posting defaults
/accounts/{accountId}/bluesky/posting-defaultsSocialit defaults for new posts: languages, reply/quote controls, content warnings, hidden tags, link cards and facet detection. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/posting-defaults.
Try it with MCPAsk your agent to call bluesky-posting-defaults-update (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
defaultLangsarray of string | nullLanguages written to every new post (langs). null = unset (Bluesky guesses).
1–3 items
defaultThreadgatearray of string | nullDefault reply controls. null = everyone can reply; [] = nobody; otherwise any of mentioned, followers, following, list:
≤ 5 items
defaultPostgateobject | nullDefault quote controls. null = quotes allowed.
Show 1 child attributes
disableQuotesbooleandefaultLabelsarray of stringSelf-labels (content warnings) applied to every new post.
≤ 10 items
defaultTagsarray of stringExtra hidden hashtags (tags) added to every new post.
≤ 8 items
autoFacetsbooleanDetect links, @mentions and #hashtags (default true).
autoLinkCardsbooleanBuild a link card from the first link when the post has no media (default true).
Returns object
defaultLangsarray of string | nullLanguages written to every new post (langs). null = unset (Bluesky guesses).
1–3 items
defaultThreadgatearray of string | nullDefault reply controls. null = everyone can reply; [] = nobody; otherwise any of mentioned, followers, following, list:
≤ 5 items
defaultPostgateobject | nullDefault quote controls. null = quotes allowed.
Show 1 child attributes
disableQuotesbooleandefaultLabelsarray of stringSelf-labels (content warnings) applied to every new post.
≤ 10 items
defaultTagsarray of stringExtra hidden hashtags (tags) added to every new post.
≤ 8 items
autoFacetsbooleanDetect links, @mentions and #hashtags (default true).
autoLinkCardsbooleanBuild a link card from the first link when the post has no media (default true).
Responses
Posts
Bluesky: List Posts
/accounts/{accountId}/bluesky/postsAuthor feed (app.bsky.feed.getAuthorFeed). The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Cursor pagination: pass next_cursor back as cursor. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringfilterstringdefault: "posts_and_author_threads"posts_with_repliesposts_no_repliesposts_with_mediaposts_and_author_threadsposts_with_video
actorstringdefaults to the account
include_pinsbooleandefault: trueReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 35 item attributes
idstringrequiredAT-URI
uristringrequiredcidstringrequiredrkeystringurlstring (uri)textstringrequired≤ 3000 characters
created_atstring (date-time)indexed_atstring (date-time) | nulllangsarray of stringtagsarray of stringlabelsarray of stringauthor_idstringauthor_handlestringauthor_namestring | nullauthor_avatarstring (uri) | nullis_ownbooleanis_replybooleanparent_idstring | nullroot_idstring | nulllike_countintegerrepost_countintegerreply_countintegerquote_countintegerbookmark_countintegerembedobject | nullShow 7 child attributes
typestringimagesvideoexternalrecordrecord_with_media
imagesarray of objectShow 3 item attributes
urlstring (uri)thumbstring (uri)altstringplayliststring (uri) | nullthumbnailstring (uri) | nulluristring (uri) | nulltitlestring | nullrecord_uristring | nullviewer_likestring | nullviewer_repoststring | nullviewer_bookmarkedbooleanviewer_thread_mutedbooleanreply_disabledbooleanembedding_disabledbooleanpinnedbooleanreposted_bystring | nullthreadgate_rulesarray of string | nullhidden_repliesarray of stringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Posts item
/accounts/{accountId}/bluesky/postsPublish a post or thread now. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstring≤ 300 graphemes / 3000 bytes; links, @mentions and #tags become facets
mediaarray of object≤ 4 items
Show 3 item attributes
mediastringSocialit media id or public URL
alt_textstring≤ 2000 characters
captionsarray of objectShow 2 item attributes
mediastringlangstringthreadarray of objectAdditional posts of a thread (after the root)
Show 2 item attributes
textstringmediaarray of object≤ 4 items
Show 3 item attributes
mediastringSocialit media id or public URL
alt_textstring≤ 2000 characters
captionsarray of objectShow 2 item attributes
mediastringlangstringlangsarray of string≤ 3 items
labelsarray of stringtagsarray of string≤ 8 items
threadgatearray of string | null[] = nobody; null = everyone
≤ 5 items
disable_quotesbooleanquotestringAT-URI / URL of a post, list, feed or starter pack
reply_tostringAT-URI / URL of the post to reply to
link_cardobject | nullShow 3 child attributes
urlstring (uri)titlestringdescriptionstringfirst_commentstringvideo_presentationstringdefaultgif
Returns object
idstringrequiredAT-URI
uristringrequiredcidstringrequiredrkeystringurlstring (uri)textstringrequired≤ 3000 characters
created_atstring (date-time)indexed_atstring (date-time) | nulllangsarray of stringtagsarray of stringlabelsarray of stringauthor_idstringauthor_handlestringauthor_namestring | nullauthor_avatarstring (uri) | nullis_ownbooleanis_replybooleanparent_idstring | nullroot_idstring | nulllike_countintegerrepost_countintegerreply_countintegerquote_countintegerbookmark_countintegerembedobject | nullShow 7 child attributes
typestringimagesvideoexternalrecordrecord_with_media
imagesarray of objectShow 3 item attributes
urlstring (uri)thumbstring (uri)altstringplayliststring (uri) | nullthumbnailstring (uri) | nulluristring (uri) | nulltitlestring | nullrecord_uristring | nullviewer_likestring | nullviewer_repoststring | nullviewer_bookmarkedbooleanviewer_thread_mutedbooleanreply_disabledbooleanembedding_disabledbooleanpinnedbooleanreposted_bystring | nullthreadgate_rulesarray of string | nullhidden_repliesarray of stringResponses
Bluesky: Get a Posts item
/accounts/{accountId}/bluesky/posts/{itemId}The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-get (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredAT-URI
uristringrequiredcidstringrequiredrkeystringurlstring (uri)textstringrequired≤ 3000 characters
created_atstring (date-time)indexed_atstring (date-time) | nulllangsarray of stringtagsarray of stringlabelsarray of stringauthor_idstringauthor_handlestringauthor_namestring | nullauthor_avatarstring (uri) | nullis_ownbooleanis_replybooleanparent_idstring | nullroot_idstring | nulllike_countintegerrepost_countintegerreply_countintegerquote_countintegerbookmark_countintegerembedobject | nullShow 7 child attributes
typestringimagesvideoexternalrecordrecord_with_media
imagesarray of objectShow 3 item attributes
urlstring (uri)thumbstring (uri)altstringplayliststring (uri) | nullthumbnailstring (uri) | nulluristring (uri) | nulltitlestring | nullrecord_uristring | nullviewer_likestring | nullviewer_repoststring | nullviewer_bookmarkedbooleanviewer_thread_mutedbooleanreply_disabledbooleanembedding_disabledbooleanpinnedbooleanreposted_bystring | nullthreadgate_rulesarray of string | nullhidden_repliesarray of stringResponses
Bluesky: Delete a Posts item
/accounts/{accountId}/bluesky/posts/{itemId}Delete the post with its threadgate/postgate. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Bluesky: Like (Posts)
/accounts/{accountId}/bluesky/posts/{itemId}/likeLike. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-like (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Unlike (Posts)
/accounts/{accountId}/bluesky/posts/{itemId}/unlikeUnlike. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-unlike (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Repost (Posts)
/accounts/{accountId}/bluesky/posts/{itemId}/repostRepost. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-repost (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Undo repost (Posts)
/accounts/{accountId}/bluesky/posts/{itemId}/unrepostUndo repost. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-unrepost (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Bookmark (Posts)
/accounts/{accountId}/bluesky/posts/{itemId}/bookmarkBookmark. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-bookmark (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Remove bookmark (Posts)
/accounts/{accountId}/bluesky/posts/{itemId}/unbookmarkRemove bookmark. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-unbookmark (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Pin to profile (Posts)
/accounts/{accountId}/bluesky/posts/{itemId}/pinPin to profile. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-pin (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Mute thread (Posts)
/accounts/{accountId}/bluesky/posts/{itemId}/mute-threadMute thread. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-mute-thread (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Unmute thread (Posts)
/accounts/{accountId}/bluesky/posts/{itemId}/unmute-threadUnmute thread. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-unmute-thread (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Reply controls (Posts)
/accounts/{accountId}/bluesky/posts/{itemId}/set-reply-controlsThreadgate on a root post: null = everyone, [] = nobody (hidden replies are kept). The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-set-reply-controls (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
allowarray of string | null≤ 5 items
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Quote controls (Posts)
/accounts/{accountId}/bluesky/posts/{itemId}/set-quote-controlsQuote controls. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-set-quote-controls (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
disable_quotesbooleanrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Detach quote (Posts)
/accounts/{accountId}/bluesky/posts/{itemId}/detach-quoteRemove this post from a specific quote post (postgate detachedEmbeddingUris, ≤ 50). The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-detach-quote (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
quote_uristringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Reattach quote (Posts)
/accounts/{accountId}/bluesky/posts/{itemId}/reattach-quoteReattach quote. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-reattach-quote (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
quote_uristringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Report (Posts)
/accounts/{accountId}/bluesky/posts/{itemId}/reportReport. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call bluesky-posts-report (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reason_typestringspamviolationmisleadingsexualrudeother
reasonstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Replies
Bluesky: List Replies
/accounts/{accountId}/bluesky/repliesThread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Cursor pagination: pass next_cursor back as cursor. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call bluesky-replies-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
poststringrequiredAT-URI or URL of the thread root/post
depthintegerdefault: 61–10
limitintegerdefault: 100Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 19 item attributes
idstringAT-URI
textstringauthorstringhandle
author_idstringauthor_namestring | nullauthor_avatarstring (uri) | nullcreated_atstring (date-time)like_countintegerreply_countintegerrepost_countintegerquote_countintegerparent_idstring | nullroot_idstring | nulldepthintegerlikedbooleanlike_uristring | nullhiddenbooleanis_ownbooleanurlstring (uri)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Replies item
/accounts/{accountId}/bluesky/repliesThread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call bluesky-replies-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
parentstringrequiredAT-URI of the post/reply to answer
textstringrequiredReturns object
idstringAT-URI
textstringauthorstringhandle
author_idstringauthor_namestring | nullauthor_avatarstring (uri) | nullcreated_atstring (date-time)like_countintegerreply_countintegerrepost_countintegerquote_countintegerparent_idstring | nullroot_idstring | nulldepthintegerlikedbooleanlike_uristring | nullhiddenbooleanis_ownbooleanurlstring (uri)Responses
Bluesky: Delete a Replies item
/accounts/{accountId}/bluesky/replies/{itemId}Delete one of the account’s own replies. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call bluesky-replies-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Bluesky: Hide reply (Replies)
/accounts/{accountId}/bluesky/replies/{itemId}/hideHide reply. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call bluesky-replies-hide (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Unhide reply (Replies)
/accounts/{accountId}/bluesky/replies/{itemId}/unhideUnhide reply. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call bluesky-replies-unhide (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Like (Replies)
/accounts/{accountId}/bluesky/replies/{itemId}/likeLike. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call bluesky-replies-like (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Unlike (Replies)
/accounts/{accountId}/bluesky/replies/{itemId}/unlikeUnlike. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call bluesky-replies-unlike (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Block author (Replies)
/accounts/{accountId}/bluesky/replies/{itemId}/block-authorBlock author. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Destructive. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call bluesky-replies-block-author (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Mute author (Replies)
/accounts/{accountId}/bluesky/replies/{itemId}/mute-authorMute author. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call bluesky-replies-mute-author (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Report (Replies)
/accounts/{accountId}/bluesky/replies/{itemId}/reportReport. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call bluesky-replies-report (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reason_typestringspamviolationmisleadingsexualrudeother
reasonstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Drafts
Bluesky: List Bluesky drafts
/accounts/{accountId}/bluesky/draftsServer-side drafts synced with the Bluesky app (app.bsky.draft.*, 2026 lexicon; text-only here). Cursor pagination: pass next_cursor back as cursor. Requires one of: rpc?lxm=app.bsky.draft.createDraft&lxm=app.bsky.draft.deleteDraft&lxm=app.bsky.draft.getDrafts&lxm=app.bsky.draft.updateDraft&aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/drafts.
Try it with MCPAsk your agent to call bluesky-drafts-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringpostsarray of objectShow 1 item attributes
textstring≤ 1000 graphemes
langsarray of stringthreadgatearray of string | nulldisable_quotesbooleancreated_atstring (date-time) | nullupdated_atstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Bluesky drafts item
/accounts/{accountId}/bluesky/draftsServer-side drafts synced with the Bluesky app (app.bsky.draft.*, 2026 lexicon; text-only here). Requires one of: rpc?lxm=app.bsky.draft.createDraft&lxm=app.bsky.draft.deleteDraft&lxm=app.bsky.draft.getDrafts&lxm=app.bsky.draft.updateDraft&aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/drafts.
Try it with MCPAsk your agent to call bluesky-drafts-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
postsarray of objectShow 1 item attributes
textstringlangsarray of stringthreadgatearray of string | nulldisable_quotesbooleanReturns object
idstringpostsarray of objectShow 1 item attributes
textstring≤ 1000 graphemes
langsarray of stringthreadgatearray of string | nulldisable_quotesbooleancreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Bluesky: Update a Bluesky drafts item
/accounts/{accountId}/bluesky/drafts/{itemId}Server-side drafts synced with the Bluesky app (app.bsky.draft.*, 2026 lexicon; text-only here). Requires one of: rpc?lxm=app.bsky.draft.createDraft&lxm=app.bsky.draft.deleteDraft&lxm=app.bsky.draft.getDrafts&lxm=app.bsky.draft.updateDraft&aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/drafts.
Try it with MCPAsk your agent to call bluesky-drafts-update (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
postsarray of objectShow 1 item attributes
textstringlangsarray of stringthreadgatearray of string | nulldisable_quotesbooleanReturns object
idstringpostsarray of objectShow 1 item attributes
textstring≤ 1000 graphemes
langsarray of stringthreadgatearray of string | nulldisable_quotesbooleancreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Bluesky: Delete a Bluesky drafts item
/accounts/{accountId}/bluesky/drafts/{itemId}Server-side drafts synced with the Bluesky app (app.bsky.draft.*, 2026 lexicon; text-only here). Requires one of: rpc?lxm=app.bsky.draft.createDraft&lxm=app.bsky.draft.deleteDraft&lxm=app.bsky.draft.getDrafts&lxm=app.bsky.draft.updateDraft&aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/drafts.
Try it with MCPAsk your agent to call bluesky-drafts-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Bluesky: Publish draft (Bluesky drafts)
/accounts/{accountId}/bluesky/drafts/{itemId}/publishPublish the draft content (send the draft body as shown) and delete the draft. Server-side drafts synced with the Bluesky app (app.bsky.draft.*, 2026 lexicon; text-only here). Requires one of: rpc?lxm=app.bsky.draft.createDraft&lxm=app.bsky.draft.deleteDraft&lxm=app.bsky.draft.getDrafts&lxm=app.bsky.draft.updateDraft&aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/drafts.
Try it with MCPAsk your agent to call bluesky-drafts-publish (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
postsarray of objectrequiredShow 1 item attributes
textstringlangsarray of stringthreadgatearray of string | nulldisable_quotesbooleankeep_draftbooleanReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Timeline
Bluesky: List Following timeline
/accounts/{accountId}/bluesky/timelineThe account’s home timeline (app.bsky.feed.getTimeline). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/timeline.
Try it with MCPAsk your agent to call bluesky-timeline-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 35 item attributes
idstringrequiredAT-URI
uristringrequiredcidstringrequiredrkeystringurlstring (uri)textstringrequired≤ 3000 characters
created_atstring (date-time)indexed_atstring (date-time) | nulllangsarray of stringtagsarray of stringlabelsarray of stringauthor_idstringauthor_handlestringauthor_namestring | nullauthor_avatarstring (uri) | nullis_ownbooleanis_replybooleanparent_idstring | nullroot_idstring | nulllike_countintegerrepost_countintegerreply_countintegerquote_countintegerbookmark_countintegerembedobject | nullShow 7 child attributes
typestringimagesvideoexternalrecordrecord_with_media
imagesarray of objectShow 3 item attributes
urlstring (uri)thumbstring (uri)altstringplayliststring (uri) | nullthumbnailstring (uri) | nulluristring (uri) | nulltitlestring | nullrecord_uristring | nullviewer_likestring | nullviewer_repoststring | nullviewer_bookmarkedbooleanviewer_thread_mutedbooleanreply_disabledbooleanembedding_disabledbooleanpinnedbooleanreposted_bystring | nullthreadgate_rulesarray of string | nullhidden_repliesarray of stringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Like (Following timeline)
/accounts/{accountId}/bluesky/timeline/{itemId}/likeLike. The account’s home timeline (app.bsky.feed.getTimeline). Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/timeline.
Try it with MCPAsk your agent to call bluesky-timeline-like (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Repost (Following timeline)
/accounts/{accountId}/bluesky/timeline/{itemId}/repostRepost. The account’s home timeline (app.bsky.feed.getTimeline). Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/timeline.
Try it with MCPAsk your agent to call bluesky-timeline-repost (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Bookmark (Following timeline)
/accounts/{accountId}/bluesky/timeline/{itemId}/bookmarkBookmark. The account’s home timeline (app.bsky.feed.getTimeline). Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/timeline.
Try it with MCPAsk your agent to call bluesky-timeline-bookmark (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Notifications
Bluesky: List Notifications
/accounts/{accountId}/bluesky/notificationsMentions, replies, quotes, likes, reposts, follows and starter-pack joins. Marking as seen also clears the badge in the Bluesky app. Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/notifications.
Try it with MCPAsk your agent to call bluesky-notifications-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringreasonsarray of stringprioritybooleanReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 13 item attributes
idstringAT-URI of the notifying record
typestringlikerepostfollowmentionreplyquotestarterpack-joinedverifiedunverifiedlike-via-repostrepost-via-repostsubscribed-postcontact-match
reason_subjectstring | nullthe account’s record that was liked/reposted/quoted
textstring | nullauthorstringauthor_idstringauthor_namestring | nullauthor_avatarstring (uri) | nullcreated_atstring (date-time)is_readbooleanparent_idstring | nullroot_idstring | nullurlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Mark all as seen (Notifications)
/accounts/{accountId}/bluesky/notifications/mark-seenMark all as seen. Mentions, replies, quotes, likes, reposts, follows and starter-pack joins. Marking as seen also clears the badge in the Bluesky app. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/notifications.
Try it with MCPAsk your agent to call bluesky-notifications-mark-seen (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
seen_atstring (date-time)Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Unread count (Notifications)
/accounts/{accountId}/bluesky/notifications/unread-countUnread count. Mentions, replies, quotes, likes, reposts, follows and starter-pack joins. Marking as seen also clears the badge in the Bluesky app. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/notifications.
Try it with MCPAsk your agent to call bluesky-notifications-unread-count (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Reply (Notifications)
/accounts/{accountId}/bluesky/notifications/{itemId}/replyReply to a mention/reply/quote notification. Mentions, replies, quotes, likes, reposts, follows and starter-pack joins. Marking as seen also clears the badge in the Bluesky app. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/notifications.
Try it with MCPAsk your agent to call bluesky-notifications-reply (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Conversations
Bluesky: List Messages
/accounts/{accountId}/bluesky/conversationsDirect messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Cursor pagination: pass next_cursor back as cursor. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call bluesky-conversations-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringstatusstringrequestaccepted
unread_onlybooleanReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstringtitlestring | nullparticipantsarray of objectShow 5 item attributes
idstringnamestringusernamestringavatar_urlstring (uri) | nullis_selfbooleanlast_messagestring | nullupdated_atstring (date-time) | nullunread_countintegerstatusstringrequestaccepted
mutedbooleankindstringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Messages item
/accounts/{accountId}/bluesky/conversationsStart (or reopen) a 1:1 conversation. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call bluesky-conversations-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
participantstringrequiredhandle or DID
textstringReturns object
idstringtitlestring | nullparticipantsarray of objectShow 5 item attributes
idstringnamestringusernamestringavatar_urlstring (uri) | nullis_selfbooleanlast_messagestring | nullupdated_atstring (date-time) | nullunread_countintegerstatusstringrequestaccepted
mutedbooleankindstringResponses
Bluesky: Get a Messages item
/accounts/{accountId}/bluesky/conversations/{itemId}Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call bluesky-conversations-get (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringtitlestring | nullparticipantsarray of objectShow 5 item attributes
idstringnamestringusernamestringavatar_urlstring (uri) | nullis_selfbooleanlast_messagestring | nullupdated_atstring (date-time) | nullunread_countintegerstatusstringrequestaccepted
mutedbooleankindstringResponses
Bluesky: Delete a Messages item
/accounts/{accountId}/bluesky/conversations/{itemId}Leave the conversation. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call bluesky-conversations-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Bluesky: Accept request (Messages)
/accounts/{accountId}/bluesky/conversations/{itemId}/acceptAccept request. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call bluesky-conversations-accept (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Mark read (Messages)
/accounts/{accountId}/bluesky/conversations/{itemId}/mark-readMark read. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call bluesky-conversations-mark-read (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Mute (Messages)
/accounts/{accountId}/bluesky/conversations/{itemId}/muteMute. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call bluesky-conversations-mute (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Unmute (Messages)
/accounts/{accountId}/bluesky/conversations/{itemId}/unmuteUnmute. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call bluesky-conversations-unmute (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Mark all read (Messages)
/accounts/{accountId}/bluesky/conversations/mark-all-readMark all read. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call bluesky-conversations-mark-all-read (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statusstringrequestaccepted
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Messages
Bluesky: List Conversation
/accounts/{accountId}/bluesky/messagesMessages of one conversation with reactions; delete is “for me” only. Cursor pagination: pass next_cursor back as cursor. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/messages.
Try it with MCPAsk your agent to call bluesky-messages-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringconversationstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstring<conversation_id>:<message_id>
message_idstringconversation_idstringtextstring | null≤ 10000 characters
directionstringinout
from_idstringsent_atstring (date-time)deletedbooleanreactionsarray of objectShow 2 item attributes
valuestringfrom_idstringembed_uristring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Conversation item
/accounts/{accountId}/bluesky/messagesMessages of one conversation with reactions; delete is “for me” only. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/messages.
Try it with MCPAsk your agent to call bluesky-messages-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
conversationstringrequiredconversation id, or a handle/DID to DM
textstringrequired≤ 1000 graphemes
embed_uristringpost to embed
Returns object
idstring<conversation_id>:<message_id>
message_idstringconversation_idstringtextstring | null≤ 10000 characters
directionstringinout
from_idstringsent_atstring (date-time)deletedbooleanreactionsarray of objectShow 2 item attributes
valuestringfrom_idstringembed_uristring | nullResponses
Bluesky: Delete a Conversation item
/accounts/{accountId}/bluesky/messages/{itemId}Delete for the account only. Messages of one conversation with reactions; delete is “for me” only. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/messages.
Try it with MCPAsk your agent to call bluesky-messages-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Bluesky: React (Conversation)
/accounts/{accountId}/bluesky/messages/{itemId}/reactReact. Messages of one conversation with reactions; delete is “for me” only. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/messages.
Try it with MCPAsk your agent to call bluesky-messages-react (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
valuestringrequiredone emoji
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Remove reaction (Conversation)
/accounts/{accountId}/bluesky/messages/{itemId}/unreactRemove reaction. Messages of one conversation with reactions; delete is “for me” only. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/messages.
Try it with MCPAsk your agent to call bluesky-messages-unreact (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
valuestringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Notification preferences
Bluesky: Get Notification settings
/accounts/{accountId}/bluesky/notification-preferencesWhich notifications the account receives (app.bsky.notification.getPreferences / putPreferencesV2). Requires one of: include:app.bsky.authManageNotifications?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/notification-preferences.
Try it with MCPAsk your agent to call bluesky-notification-preferences-get (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
chatobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanfollowobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanlikeobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanlikeViaRepostobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanmentionobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanquoteobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanreplyobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanrepostobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanrepostViaRepostobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanstarterpackJoinedobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleansubscribedPostobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanunverifiedobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanverifiedobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanResponses
Bluesky: Update Notification settings
/accounts/{accountId}/bluesky/notification-preferencesWhich notifications the account receives (app.bsky.notification.getPreferences / putPreferencesV2). Requires one of: include:app.bsky.authManageNotifications?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/notification-preferences.
Try it with MCPAsk your agent to call bluesky-notification-preferences-update (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
chatobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanfollowobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanlikeobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanlikeViaRepostobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanmentionobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanquoteobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanreplyobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanrepostobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanrepostViaRepostobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanstarterpackJoinedobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleansubscribedPostobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanunverifiedobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanverifiedobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanReturns object
chatobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanfollowobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanlikeobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanlikeViaRepostobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanmentionobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanquoteobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanreplyobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanrepostobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanrepostViaRepostobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanstarterpackJoinedobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleansubscribedPostobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanunverifiedobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanverifiedobjectShow 3 child attributes
includestringallfollowsaccepted
listbooleanpushbooleanResponses
Activity subscriptions
Bluesky: List Post alerts
/accounts/{accountId}/bluesky/activity-subscriptions“Notify me when X posts” subscriptions (app.bsky.notification.*ActivitySubscription). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/activity-subscriptions.
Try it with MCPAsk your agent to call bluesky-activity-subscriptions-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 24 item attributes
idstringDID
didstringhandlestringdisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullbanner_urlstring (uri) | nullfollowers_countinteger | nullfollowing_countinteger | nullposts_countinteger | nulllabelsarray of stringis_botbooleanverifiedbooleancreated_atstring (date-time) | nullindexed_atstring (date-time) | nullviewer_followingstring | nullfollow record URI when the account follows them
viewer_followed_bystring | nullviewer_mutedbooleanviewer_blockingstring | nullblock record URI
viewer_blocked_bybooleanallow_incoming_chatstring | nullallfollowingnone
urlstring (uri)notify_postsbooleannotify_repliesbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Post alerts item
/accounts/{accountId}/bluesky/activity-subscriptions“Notify me when X posts” subscriptions (app.bsky.notification.*ActivitySubscription). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/activity-subscriptions.
Try it with MCPAsk your agent to call bluesky-activity-subscriptions-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
actorstringrequirednotify_postsbooleandefault: truenotify_repliesbooleandefault: falseReturns object
idstringDID
didstringhandlestringdisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullbanner_urlstring (uri) | nullfollowers_countinteger | nullfollowing_countinteger | nullposts_countinteger | nulllabelsarray of stringis_botbooleanverifiedbooleancreated_atstring (date-time) | nullindexed_atstring (date-time) | nullviewer_followingstring | nullfollow record URI when the account follows them
viewer_followed_bystring | nullviewer_mutedbooleanviewer_blockingstring | nullblock record URI
viewer_blocked_bybooleanallow_incoming_chatstring | nullallfollowingnone
urlstring (uri)notify_postsbooleannotify_repliesbooleanResponses
Bluesky: Update a Post alerts item
/accounts/{accountId}/bluesky/activity-subscriptions/{itemId}“Notify me when X posts” subscriptions (app.bsky.notification.*ActivitySubscription). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/activity-subscriptions.
Try it with MCPAsk your agent to call bluesky-activity-subscriptions-update (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
notify_postsbooleannotify_repliesbooleanReturns object
idstringDID
didstringhandlestringdisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullbanner_urlstring (uri) | nullfollowers_countinteger | nullfollowing_countinteger | nullposts_countinteger | nulllabelsarray of stringis_botbooleanverifiedbooleancreated_atstring (date-time) | nullindexed_atstring (date-time) | nullviewer_followingstring | nullfollow record URI when the account follows them
viewer_followed_bystring | nullviewer_mutedbooleanviewer_blockingstring | nullblock record URI
viewer_blocked_bybooleanallow_incoming_chatstring | nullallfollowingnone
urlstring (uri)notify_postsbooleannotify_repliesbooleanResponses
Bluesky: Delete a Post alerts item
/accounts/{accountId}/bluesky/activity-subscriptions/{itemId}“Notify me when X posts” subscriptions (app.bsky.notification.*ActivitySubscription). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/activity-subscriptions.
Try it with MCPAsk your agent to call bluesky-activity-subscriptions-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Chat settings
Bluesky: Get Who can message
/accounts/{accountId}/bluesky/chat-settingschat.bsky.actor.declaration: brands usually allow messages from everyone. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/chat-settings.
Try it with MCPAsk your agent to call bluesky-chat-settings-get (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
allow_incomingstringallfollowingnone
Responses
Bluesky: Update Who can message
/accounts/{accountId}/bluesky/chat-settingschat.bsky.actor.declaration: brands usually allow messages from everyone. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/chat-settings.
Try it with MCPAsk your agent to call bluesky-chat-settings-update (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
allow_incomingstringrequiredallfollowingnone
Returns object
allow_incomingstringallfollowingnone
Responses
Likes
Bluesky: List Likes
/accounts/{accountId}/bluesky/likesPosts the account liked (app.bsky.feed.getActorLikes, own account only). Cursor pagination: pass next_cursor back as cursor. Requires one of: repo:app.bsky.feed.like | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/likes.
Try it with MCPAsk your agent to call bluesky-likes-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 35 item attributes
idstringrequiredAT-URI
uristringrequiredcidstringrequiredrkeystringurlstring (uri)textstringrequired≤ 3000 characters
created_atstring (date-time)indexed_atstring (date-time) | nulllangsarray of stringtagsarray of stringlabelsarray of stringauthor_idstringauthor_handlestringauthor_namestring | nullauthor_avatarstring (uri) | nullis_ownbooleanis_replybooleanparent_idstring | nullroot_idstring | nulllike_countintegerrepost_countintegerreply_countintegerquote_countintegerbookmark_countintegerembedobject | nullShow 7 child attributes
typestringimagesvideoexternalrecordrecord_with_media
imagesarray of objectShow 3 item attributes
urlstring (uri)thumbstring (uri)altstringplayliststring (uri) | nullthumbnailstring (uri) | nulluristring (uri) | nulltitlestring | nullrecord_uristring | nullviewer_likestring | nullviewer_repoststring | nullviewer_bookmarkedbooleanviewer_thread_mutedbooleanreply_disabledbooleanembedding_disabledbooleanpinnedbooleanreposted_bystring | nullthreadgate_rulesarray of string | nullhidden_repliesarray of stringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Likes item
/accounts/{accountId}/bluesky/likesPosts the account liked (app.bsky.feed.getActorLikes, own account only). Requires one of: repo:app.bsky.feed.like | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/likes.
Try it with MCPAsk your agent to call bluesky-likes-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
uristringrequiredpost AT-URI or bsky.app URL
Returns object
idstringrequiredAT-URI
uristringrequiredcidstringrequiredrkeystringurlstring (uri)textstringrequired≤ 3000 characters
created_atstring (date-time)indexed_atstring (date-time) | nulllangsarray of stringtagsarray of stringlabelsarray of stringauthor_idstringauthor_handlestringauthor_namestring | nullauthor_avatarstring (uri) | nullis_ownbooleanis_replybooleanparent_idstring | nullroot_idstring | nulllike_countintegerrepost_countintegerreply_countintegerquote_countintegerbookmark_countintegerembedobject | nullShow 7 child attributes
typestringimagesvideoexternalrecordrecord_with_media
imagesarray of objectShow 3 item attributes
urlstring (uri)thumbstring (uri)altstringplayliststring (uri) | nullthumbnailstring (uri) | nulluristring (uri) | nulltitlestring | nullrecord_uristring | nullviewer_likestring | nullviewer_repoststring | nullviewer_bookmarkedbooleanviewer_thread_mutedbooleanreply_disabledbooleanembedding_disabledbooleanpinnedbooleanreposted_bystring | nullthreadgate_rulesarray of string | nullhidden_repliesarray of stringResponses
Bluesky: Delete a Likes item
/accounts/{accountId}/bluesky/likes/{itemId}Unlike (id = post or like URI). Posts the account liked (app.bsky.feed.getActorLikes, own account only). Requires one of: repo:app.bsky.feed.like | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/likes.
Try it with MCPAsk your agent to call bluesky-likes-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Reposts
Bluesky: List Reposts
/accounts/{accountId}/bluesky/repostsThe account’s reposts (app.bsky.feed.repost records). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/reposts.
Try it with MCPAsk your agent to call bluesky-reposts-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 37 item attributes
idstringAT-URI
uristringcidstringrkeystringurlstring (uri)textstring≤ 3000 characters
created_atstring (date-time)indexed_atstring (date-time) | nulllangsarray of stringtagsarray of stringlabelsarray of stringauthor_idstringauthor_handlestringauthor_namestring | nullauthor_avatarstring (uri) | nullis_ownbooleanis_replybooleanparent_idstring | nullroot_idstring | nulllike_countintegerrepost_countintegerreply_countintegerquote_countintegerbookmark_countintegerembedobject | nullShow 7 child attributes
typestringimagesvideoexternalrecordrecord_with_media
imagesarray of objectShow 3 item attributes
urlstring (uri)thumbstring (uri)altstringplayliststring (uri) | nullthumbnailstring (uri) | nulluristring (uri) | nulltitlestring | nullrecord_uristring | nullviewer_likestring | nullviewer_repoststring | nullviewer_bookmarkedbooleanviewer_thread_mutedbooleanreply_disabledbooleanembedding_disabledbooleanpinnedbooleanreposted_bystring | nullthreadgate_rulesarray of string | nullhidden_repliesarray of stringrepost_uristringreposted_atstring (date-time)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Reposts item
/accounts/{accountId}/bluesky/repostsThe account’s reposts (app.bsky.feed.repost records). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/reposts.
Try it with MCPAsk your agent to call bluesky-reposts-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
uristringrequiredpost AT-URI or bsky.app URL
Returns object
idstringAT-URI
uristringcidstringrkeystringurlstring (uri)textstring≤ 3000 characters
created_atstring (date-time)indexed_atstring (date-time) | nulllangsarray of stringtagsarray of stringlabelsarray of stringauthor_idstringauthor_handlestringauthor_namestring | nullauthor_avatarstring (uri) | nullis_ownbooleanis_replybooleanparent_idstring | nullroot_idstring | nulllike_countintegerrepost_countintegerreply_countintegerquote_countintegerbookmark_countintegerembedobject | nullShow 7 child attributes
typestringimagesvideoexternalrecordrecord_with_media
imagesarray of objectShow 3 item attributes
urlstring (uri)thumbstring (uri)altstringplayliststring (uri) | nullthumbnailstring (uri) | nulluristring (uri) | nulltitlestring | nullrecord_uristring | nullviewer_likestring | nullviewer_repoststring | nullviewer_bookmarkedbooleanviewer_thread_mutedbooleanreply_disabledbooleanembedding_disabledbooleanpinnedbooleanreposted_bystring | nullthreadgate_rulesarray of string | nullhidden_repliesarray of stringrepost_uristringreposted_atstring (date-time)Responses
Bluesky: Delete a Reposts item
/accounts/{accountId}/bluesky/reposts/{itemId}Undo (id = repost or post URI). The account’s reposts (app.bsky.feed.repost records). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/reposts.
Try it with MCPAsk your agent to call bluesky-reposts-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Bookmarks
Bluesky: List Bookmarks
/accounts/{accountId}/bluesky/bookmarksPrivate bookmarks (app.bsky.bookmark.*). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/bookmarks.
Try it with MCPAsk your agent to call bluesky-bookmarks-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 36 item attributes
idstringAT-URI
uristringcidstringrkeystringurlstring (uri)textstring≤ 3000 characters
created_atstring (date-time)indexed_atstring (date-time) | nulllangsarray of stringtagsarray of stringlabelsarray of stringauthor_idstringauthor_handlestringauthor_namestring | nullauthor_avatarstring (uri) | nullis_ownbooleanis_replybooleanparent_idstring | nullroot_idstring | nulllike_countintegerrepost_countintegerreply_countintegerquote_countintegerbookmark_countintegerembedobject | nullShow 7 child attributes
typestringimagesvideoexternalrecordrecord_with_media
imagesarray of objectShow 3 item attributes
urlstring (uri)thumbstring (uri)altstringplayliststring (uri) | nullthumbnailstring (uri) | nulluristring (uri) | nulltitlestring | nullrecord_uristring | nullviewer_likestring | nullviewer_repoststring | nullviewer_bookmarkedbooleanviewer_thread_mutedbooleanreply_disabledbooleanembedding_disabledbooleanpinnedbooleanreposted_bystring | nullthreadgate_rulesarray of string | nullhidden_repliesarray of stringbookmarked_atstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Bookmarks item
/accounts/{accountId}/bluesky/bookmarksPrivate bookmarks (app.bsky.bookmark.*). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/bookmarks.
Try it with MCPAsk your agent to call bluesky-bookmarks-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
uristringrequiredpost AT-URI or bsky.app URL
Returns object
idstringAT-URI
uristringcidstringrkeystringurlstring (uri)textstring≤ 3000 characters
created_atstring (date-time)indexed_atstring (date-time) | nulllangsarray of stringtagsarray of stringlabelsarray of stringauthor_idstringauthor_handlestringauthor_namestring | nullauthor_avatarstring (uri) | nullis_ownbooleanis_replybooleanparent_idstring | nullroot_idstring | nulllike_countintegerrepost_countintegerreply_countintegerquote_countintegerbookmark_countintegerembedobject | nullShow 7 child attributes
typestringimagesvideoexternalrecordrecord_with_media
imagesarray of objectShow 3 item attributes
urlstring (uri)thumbstring (uri)altstringplayliststring (uri) | nullthumbnailstring (uri) | nulluristring (uri) | nulltitlestring | nullrecord_uristring | nullviewer_likestring | nullviewer_repoststring | nullviewer_bookmarkedbooleanviewer_thread_mutedbooleanreply_disabledbooleanembedding_disabledbooleanpinnedbooleanreposted_bystring | nullthreadgate_rulesarray of string | nullhidden_repliesarray of stringbookmarked_atstring (date-time) | nullResponses
Bluesky: Delete a Bookmarks item
/accounts/{accountId}/bluesky/bookmarks/{itemId}Private bookmarks (app.bsky.bookmark.*). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/bookmarks.
Try it with MCPAsk your agent to call bluesky-bookmarks-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Post engagement
Bluesky: List Who engaged
/accounts/{accountId}/bluesky/post-engagementAccounts that liked, reposted or quoted a post (getLikes / getRepostedBy / getQuotes). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/post-engagement.
Try it with MCPAsk your agent to call bluesky-post-engagement-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
uristringrequiredtypestringdefault: "likes"likesrepostsquotes
limitintegerdefault: 50cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 25 item attributes
idstringDID
didstringhandlestringdisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullbanner_urlstring (uri) | nullfollowers_countinteger | nullfollowing_countinteger | nullposts_countinteger | nulllabelsarray of stringis_botbooleanverifiedbooleancreated_atstring (date-time) | nullindexed_atstring (date-time) | nullviewer_followingstring | nullfollow record URI when the account follows them
viewer_followed_bystring | nullviewer_mutedbooleanviewer_blockingstring | nullblock record URI
viewer_blocked_bybooleanallow_incoming_chatstring | nullallfollowingnone
urlstring (uri)engaged_atstring (date-time) | nullquote_uristring | nullquote_textstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Followers
Bluesky: List Followers
/accounts/{accountId}/bluesky/followersCursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call bluesky-followers-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringactorstringdefaults to the account
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 22 item attributes
idstringrequiredDID
didstringhandlestringrequireddisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullbanner_urlstring (uri) | nullfollowers_countinteger | nullfollowing_countinteger | nullposts_countinteger | nulllabelsarray of stringis_botbooleanverifiedbooleancreated_atstring (date-time) | nullindexed_atstring (date-time) | nullviewer_followingstring | nullfollow record URI when the account follows them
viewer_followed_bystring | nullviewer_mutedbooleanviewer_blockingstring | nullblock record URI
viewer_blocked_bybooleanallow_incoming_chatstring | nullallfollowingnone
urlstring (uri)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Follow (Followers)
/accounts/{accountId}/bluesky/followers/{itemId}/followFollow. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call bluesky-followers-follow (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Unfollow (Followers)
/accounts/{accountId}/bluesky/followers/{itemId}/unfollowUnfollow. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call bluesky-followers-unfollow (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Mute (Followers)
/accounts/{accountId}/bluesky/followers/{itemId}/muteMute. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call bluesky-followers-mute (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Unmute (Followers)
/accounts/{accountId}/bluesky/followers/{itemId}/unmuteUnmute. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call bluesky-followers-unmute (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Block (Followers)
/accounts/{accountId}/bluesky/followers/{itemId}/blockBlock. Destructive. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call bluesky-followers-block (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Unblock (Followers)
/accounts/{accountId}/bluesky/followers/{itemId}/unblockUnblock. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call bluesky-followers-unblock (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Report account (Followers)
/accounts/{accountId}/bluesky/followers/{itemId}/reportReport account. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call bluesky-followers-report (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reason_typestringspamviolationmisleadingsexualrudeother
reasonstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Following
Bluesky: List Following
/accounts/{accountId}/bluesky/followingCursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call bluesky-following-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringactorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 22 item attributes
idstringrequiredDID
didstringhandlestringrequireddisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullbanner_urlstring (uri) | nullfollowers_countinteger | nullfollowing_countinteger | nullposts_countinteger | nulllabelsarray of stringis_botbooleanverifiedbooleancreated_atstring (date-time) | nullindexed_atstring (date-time) | nullviewer_followingstring | nullfollow record URI when the account follows them
viewer_followed_bystring | nullviewer_mutedbooleanviewer_blockingstring | nullblock record URI
viewer_blocked_bybooleanallow_incoming_chatstring | nullallfollowingnone
urlstring (uri)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Following item
/accounts/{accountId}/bluesky/followingFollow an account. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call bluesky-following-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
actorstringrequiredhandle or DID
Returns object
idstringrequiredDID
didstringhandlestringrequireddisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullbanner_urlstring (uri) | nullfollowers_countinteger | nullfollowing_countinteger | nullposts_countinteger | nulllabelsarray of stringis_botbooleanverifiedbooleancreated_atstring (date-time) | nullindexed_atstring (date-time) | nullviewer_followingstring | nullfollow record URI when the account follows them
viewer_followed_bystring | nullviewer_mutedbooleanviewer_blockingstring | nullblock record URI
viewer_blocked_bybooleanallow_incoming_chatstring | nullallfollowingnone
urlstring (uri)Responses
Bluesky: Delete a Following item
/accounts/{accountId}/bluesky/following/{itemId}Unfollow. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call bluesky-following-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Bluesky: Mute (Following)
/accounts/{accountId}/bluesky/following/{itemId}/muteMute. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call bluesky-following-mute (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Block (Following)
/accounts/{accountId}/bluesky/following/{itemId}/blockBlock. Destructive. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call bluesky-following-block (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Blocks
Bluesky: List Blocked accounts
/accounts/{accountId}/bluesky/blocksBlocks are public records (app.bsky.graph.block). Cursor pagination: pass next_cursor back as cursor. Requires one of: repo:app.bsky.graph.block | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/blocks.
Try it with MCPAsk your agent to call bluesky-blocks-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 22 item attributes
idstringrequiredDID
didstringhandlestringrequireddisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullbanner_urlstring (uri) | nullfollowers_countinteger | nullfollowing_countinteger | nullposts_countinteger | nulllabelsarray of stringis_botbooleanverifiedbooleancreated_atstring (date-time) | nullindexed_atstring (date-time) | nullviewer_followingstring | nullfollow record URI when the account follows them
viewer_followed_bystring | nullviewer_mutedbooleanviewer_blockingstring | nullblock record URI
viewer_blocked_bybooleanallow_incoming_chatstring | nullallfollowingnone
urlstring (uri)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Blocked accounts item
/accounts/{accountId}/bluesky/blocksBlocks are public records (app.bsky.graph.block). Requires one of: repo:app.bsky.graph.block | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/blocks.
Try it with MCPAsk your agent to call bluesky-blocks-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
actorstringrequiredhandle or DID
Returns object
idstringrequiredDID
didstringhandlestringrequireddisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullbanner_urlstring (uri) | nullfollowers_countinteger | nullfollowing_countinteger | nullposts_countinteger | nulllabelsarray of stringis_botbooleanverifiedbooleancreated_atstring (date-time) | nullindexed_atstring (date-time) | nullviewer_followingstring | nullfollow record URI when the account follows them
viewer_followed_bystring | nullviewer_mutedbooleanviewer_blockingstring | nullblock record URI
viewer_blocked_bybooleanallow_incoming_chatstring | nullallfollowingnone
urlstring (uri)Responses
Bluesky: Delete a Blocked accounts item
/accounts/{accountId}/bluesky/blocks/{itemId}Blocks are public records (app.bsky.graph.block). Requires one of: repo:app.bsky.graph.block | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/blocks.
Try it with MCPAsk your agent to call bluesky-blocks-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Mutes
Bluesky: List Muted accounts
/accounts/{accountId}/bluesky/mutesMutes are private (app.bsky.graph.muteActor). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/mutes.
Try it with MCPAsk your agent to call bluesky-mutes-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 22 item attributes
idstringrequiredDID
didstringhandlestringrequireddisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullbanner_urlstring (uri) | nullfollowers_countinteger | nullfollowing_countinteger | nullposts_countinteger | nulllabelsarray of stringis_botbooleanverifiedbooleancreated_atstring (date-time) | nullindexed_atstring (date-time) | nullviewer_followingstring | nullfollow record URI when the account follows them
viewer_followed_bystring | nullviewer_mutedbooleanviewer_blockingstring | nullblock record URI
viewer_blocked_bybooleanallow_incoming_chatstring | nullallfollowingnone
urlstring (uri)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Muted accounts item
/accounts/{accountId}/bluesky/mutesMutes are private (app.bsky.graph.muteActor). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/mutes.
Try it with MCPAsk your agent to call bluesky-mutes-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
actorstringrequiredhandle or DID
Returns object
idstringrequiredDID
didstringhandlestringrequireddisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullbanner_urlstring (uri) | nullfollowers_countinteger | nullfollowing_countinteger | nullposts_countinteger | nulllabelsarray of stringis_botbooleanverifiedbooleancreated_atstring (date-time) | nullindexed_atstring (date-time) | nullviewer_followingstring | nullfollow record URI when the account follows them
viewer_followed_bystring | nullviewer_mutedbooleanviewer_blockingstring | nullblock record URI
viewer_blocked_bybooleanallow_incoming_chatstring | nullallfollowingnone
urlstring (uri)Responses
Bluesky: Delete a Muted accounts item
/accounts/{accountId}/bluesky/mutes/{itemId}Mutes are private (app.bsky.graph.muteActor). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/mutes.
Try it with MCPAsk your agent to call bluesky-mutes-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Suggested follows
Bluesky: List Suggested accounts
/accounts/{accountId}/bluesky/suggested-followsCursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/suggested-follows.
Try it with MCPAsk your agent to call bluesky-suggested-follows-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringsimilar_tostringhandle/DID: accounts similar to this one
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 22 item attributes
idstringrequiredDID
didstringhandlestringrequireddisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullbanner_urlstring (uri) | nullfollowers_countinteger | nullfollowing_countinteger | nullposts_countinteger | nulllabelsarray of stringis_botbooleanverifiedbooleancreated_atstring (date-time) | nullindexed_atstring (date-time) | nullviewer_followingstring | nullfollow record URI when the account follows them
viewer_followed_bystring | nullviewer_mutedbooleanviewer_blockingstring | nullblock record URI
viewer_blocked_bybooleanallow_incoming_chatstring | nullallfollowingnone
urlstring (uri)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Follow (Suggested accounts)
/accounts/{accountId}/bluesky/suggested-follows/{itemId}/followFollow. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/suggested-follows.
Try it with MCPAsk your agent to call bluesky-suggested-follows-follow (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Mute (Suggested accounts)
/accounts/{accountId}/bluesky/suggested-follows/{itemId}/muteMute. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/suggested-follows.
Try it with MCPAsk your agent to call bluesky-suggested-follows-mute (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Lists
Bluesky: List Lists
/accounts/{accountId}/bluesky/listsCuration lists (feeds of people) and moderation lists (mute/block in bulk). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call bluesky-lists-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringpurposestringcuratemodreference
actorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 14 item attributes
idstringAT-URI
uristringcidstringnamestring≤ 64 characters
purposestringcuratemodreference
descriptionstring | null≤ 300 graphemes
avatar_urlstring (uri) | nullmember_countinteger | nullcreator_handlestring | nullviewer_mutedbooleanviewer_blockedstring | nulllistblock record URI when subscribed as a block list
labelsarray of stringindexed_atstring (date-time) | nullurlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Lists item
/accounts/{accountId}/bluesky/listsCuration lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call bluesky-lists-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequiredpurposestringrequiredcuratemod
descriptionstringavatarstringReturns object
idstringAT-URI
uristringcidstringnamestring≤ 64 characters
purposestringcuratemodreference
descriptionstring | null≤ 300 graphemes
avatar_urlstring (uri) | nullmember_countinteger | nullcreator_handlestring | nullviewer_mutedbooleanviewer_blockedstring | nulllistblock record URI when subscribed as a block list
labelsarray of stringindexed_atstring (date-time) | nullurlstring (uri) | nullResponses
Bluesky: Get a Lists item
/accounts/{accountId}/bluesky/lists/{itemId}Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call bluesky-lists-get (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringAT-URI
uristringcidstringnamestring≤ 64 characters
purposestringcuratemodreference
descriptionstring | null≤ 300 graphemes
avatar_urlstring (uri) | nullmember_countinteger | nullcreator_handlestring | nullviewer_mutedbooleanviewer_blockedstring | nulllistblock record URI when subscribed as a block list
labelsarray of stringindexed_atstring (date-time) | nullurlstring (uri) | nullResponses
Bluesky: Update a Lists item
/accounts/{accountId}/bluesky/lists/{itemId}Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call bluesky-lists-update (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
namestringdescriptionstring | nullavatarstringremove_avatarbooleanReturns object
idstringAT-URI
uristringcidstringnamestring≤ 64 characters
purposestringcuratemodreference
descriptionstring | null≤ 300 graphemes
avatar_urlstring (uri) | nullmember_countinteger | nullcreator_handlestring | nullviewer_mutedbooleanviewer_blockedstring | nulllistblock record URI when subscribed as a block list
labelsarray of stringindexed_atstring (date-time) | nullurlstring (uri) | nullResponses
Bluesky: Delete a Lists item
/accounts/{accountId}/bluesky/lists/{itemId}Delete the list and its member records. Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call bluesky-lists-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Bluesky: Subscribe as mute list (Lists)
/accounts/{accountId}/bluesky/lists/{itemId}/mute-listSubscribe as mute list. Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call bluesky-lists-mute-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Unsubscribe (mute) (Lists)
/accounts/{accountId}/bluesky/lists/{itemId}/unmute-listUnsubscribe (mute). Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call bluesky-lists-unmute-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Subscribe as block list (Lists)
/accounts/{accountId}/bluesky/lists/{itemId}/block-listSubscribe as block list. Curation lists (feeds of people) and moderation lists (mute/block in bulk). Destructive. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call bluesky-lists-block-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Unsubscribe (block) (Lists)
/accounts/{accountId}/bluesky/lists/{itemId}/unblock-listUnsubscribe (block). Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call bluesky-lists-unblock-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
List members
Bluesky: List List members
/accounts/{accountId}/bluesky/list-membersAccounts in a list (app.bsky.graph.listitem records). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/list-members.
Try it with MCPAsk your agent to call bluesky-list-members-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringliststringlist AT-URI or URL
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 24 item attributes
idstringlistitem AT-URI
didstringhandlestringdisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullbanner_urlstring (uri) | nullfollowers_countinteger | nullfollowing_countinteger | nullposts_countinteger | nulllabelsarray of stringis_botbooleanverifiedbooleancreated_atstring (date-time) | nullindexed_atstring (date-time) | nullviewer_followingstring | nullfollow record URI when the account follows them
viewer_followed_bystring | nullviewer_mutedbooleanviewer_blockingstring | nullblock record URI
viewer_blocked_bybooleanallow_incoming_chatstring | nullallfollowingnone
urlstring (uri)listitem_uristringlist_uristringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a List members item
/accounts/{accountId}/bluesky/list-membersAccounts in a list (app.bsky.graph.listitem records). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/list-members.
Try it with MCPAsk your agent to call bluesky-list-members-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
liststringrequiredactorstringrequiredhandle or DID
Returns object
idstringlistitem AT-URI
didstringhandlestringdisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullbanner_urlstring (uri) | nullfollowers_countinteger | nullfollowing_countinteger | nullposts_countinteger | nulllabelsarray of stringis_botbooleanverifiedbooleancreated_atstring (date-time) | nullindexed_atstring (date-time) | nullviewer_followingstring | nullfollow record URI when the account follows them
viewer_followed_bystring | nullviewer_mutedbooleanviewer_blockingstring | nullblock record URI
viewer_blocked_bybooleanallow_incoming_chatstring | nullallfollowingnone
urlstring (uri)listitem_uristringlist_uristringResponses
Bluesky: Delete a List members item
/accounts/{accountId}/bluesky/list-members/{itemId}Remove a member (id = listitem AT-URI). Accounts in a list (app.bsky.graph.listitem records). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/list-members.
Try it with MCPAsk your agent to call bluesky-list-members-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Starter packs
Bluesky: List Starter packs
/accounts/{accountId}/bluesky/starter-packsShareable bundles of accounts and up to 3 feeds (backed by a reference list). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/starter-packs.
Try it with MCPAsk your agent to call bluesky-starter-packs-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringactorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 14 item attributes
idstringuristringcidstringnamestring≤ 50 graphemes
descriptionstring | nulllist_uristringfeedsarray of string≤ 3 items
member_countinteger | nulljoined_weekinteger | nulljoined_all_timeinteger | nullcreator_handlestring | nullmembers_samplearray of stringcreated_atstring (date-time) | nullurlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Starter packs item
/accounts/{accountId}/bluesky/starter-packsCreates the reference list, its members and the starter pack in one applyWrites batch. Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/starter-packs.
Try it with MCPAsk your agent to call bluesky-starter-packs-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequireddescriptionstringmembersarray of string≤ 150 items
feedsarray of string≤ 3 items
Returns object
idstringuristringcidstringnamestring≤ 50 graphemes
descriptionstring | nulllist_uristringfeedsarray of string≤ 3 items
member_countinteger | nulljoined_weekinteger | nulljoined_all_timeinteger | nullcreator_handlestring | nullmembers_samplearray of stringcreated_atstring (date-time) | nullurlstring (uri) | nullResponses
Bluesky: Get a Starter packs item
/accounts/{accountId}/bluesky/starter-packs/{itemId}Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/starter-packs.
Try it with MCPAsk your agent to call bluesky-starter-packs-get (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringuristringcidstringnamestring≤ 50 graphemes
descriptionstring | nulllist_uristringfeedsarray of string≤ 3 items
member_countinteger | nulljoined_weekinteger | nulljoined_all_timeinteger | nullcreator_handlestring | nullmembers_samplearray of stringcreated_atstring (date-time) | nullurlstring (uri) | nullResponses
Bluesky: Update a Starter packs item
/accounts/{accountId}/bluesky/starter-packs/{itemId}Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/starter-packs.
Try it with MCPAsk your agent to call bluesky-starter-packs-update (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
namestringdescriptionstring | nullfeedsarray of string≤ 3 items
Returns object
idstringuristringcidstringnamestring≤ 50 graphemes
descriptionstring | nulllist_uristringfeedsarray of string≤ 3 items
member_countinteger | nulljoined_weekinteger | nulljoined_all_timeinteger | nullcreator_handlestring | nullmembers_samplearray of stringcreated_atstring (date-time) | nullurlstring (uri) | nullResponses
Bluesky: Delete a Starter packs item
/accounts/{accountId}/bluesky/starter-packs/{itemId}Delete the starter pack, its list and members. Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/starter-packs.
Try it with MCPAsk your agent to call bluesky-starter-packs-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Bluesky: Add account (Starter packs)
/accounts/{accountId}/bluesky/starter-packs/{itemId}/add-memberAdd account. Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/starter-packs.
Try it with MCPAsk your agent to call bluesky-starter-packs-add-member (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
actorstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Remove account (Starter packs)
/accounts/{accountId}/bluesky/starter-packs/{itemId}/remove-memberRemove account. Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/starter-packs.
Try it with MCPAsk your agent to call bluesky-starter-packs-remove-member (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
actorstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
List subscriptions
Bluesky: List Subscribed mod lists
/accounts/{accountId}/bluesky/list-subscriptionsModeration lists the account subscribes to as mute or block lists (getListMutes / getListBlocks). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/list-subscriptions.
Try it with MCPAsk your agent to call bluesky-list-subscriptions-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringtypestringdefault: "mute"muteblock
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 15 item attributes
idstringAT-URI
uristringcidstringnamestring≤ 64 characters
purposestringcuratemodreference
descriptionstring | null≤ 300 graphemes
avatar_urlstring (uri) | nullmember_countinteger | nullcreator_handlestring | nullviewer_mutedbooleanviewer_blockedstring | nulllistblock record URI when subscribed as a block list
labelsarray of stringindexed_atstring (date-time) | nullurlstring (uri) | nullsubscriptionstringmuteblock
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Delete a Subscribed mod lists item
/accounts/{accountId}/bluesky/list-subscriptions/{itemId}Unsubscribe (mute and block). Moderation lists the account subscribes to as mute or block lists (getListMutes / getListBlocks). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/list-subscriptions.
Try it with MCPAsk your agent to call bluesky-list-subscriptions-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Saved feeds
Bluesky: List Saved & pinned feeds
/accounts/{accountId}/bluesky/saved-feedsThe feeds and lists shown in the account’s Bluesky app (pinned ones appear as tabs). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/saved-feeds.
Try it with MCPAsk your agent to call bluesky-saved-feeds-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringsaved-feed item id
typestringfeedlisttimeline
valuestringfeed/list AT-URI or "following"
pinnedbooleanpositionintegerdisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullcreator_handlestring | nullurlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Saved & pinned feeds item
/accounts/{accountId}/bluesky/saved-feedsThe feeds and lists shown in the account’s Bluesky app (pinned ones appear as tabs). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/saved-feeds.
Try it with MCPAsk your agent to call bluesky-saved-feeds-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
uristringrequiredfeed generator or list AT-URI / URL
pinnedbooleanReturns object
idstringsaved-feed item id
typestringfeedlisttimeline
valuestringfeed/list AT-URI or "following"
pinnedbooleanpositionintegerdisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullcreator_handlestring | nullurlstring (uri) | nullResponses
Bluesky: Update a Saved & pinned feeds item
/accounts/{accountId}/bluesky/saved-feeds/{itemId}The feeds and lists shown in the account’s Bluesky app (pinned ones appear as tabs). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/saved-feeds.
Try it with MCPAsk your agent to call bluesky-saved-feeds-update (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
pinnedbooleanrequiredReturns object
idstringsaved-feed item id
typestringfeedlisttimeline
valuestringfeed/list AT-URI or "following"
pinnedbooleanpositionintegerdisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullcreator_handlestring | nullurlstring (uri) | nullResponses
Bluesky: Delete a Saved & pinned feeds item
/accounts/{accountId}/bluesky/saved-feeds/{itemId}The feeds and lists shown in the account’s Bluesky app (pinned ones appear as tabs). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/saved-feeds.
Try it with MCPAsk your agent to call bluesky-saved-feeds-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Bluesky: Reorder (Saved & pinned feeds)
/accounts/{accountId}/bluesky/saved-feeds/reorderReorder. The feeds and lists shown in the account’s Bluesky app (pinned ones appear as tabs). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/saved-feeds.
Try it with MCPAsk your agent to call bluesky-saved-feeds-reorder (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
idsarray of stringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Feed generators
Bluesky: List Discover feeds
/accounts/{accountId}/bluesky/feed-generatorsSuggested and searchable custom feeds; save, pin or like them. Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/feed-generators.
Try it with MCPAsk your agent to call bluesky-feed-generators-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringqstringsearch (app.bsky.unspecced.getPopularFeedGenerators)
actorstringfeeds created by this account
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 14 item attributes
idstringAT-URI
uristringcidstringservice_didstring | nulldisplay_namestringdescriptionstring | nullavatar_urlstring (uri) | nulllike_countintegercreator_handlestring | nullaccepts_interactionsbooleancontent_modestring | nullcontentModeUnspecifiedcontentModeVideo
viewer_likestring | nulllabelsarray of stringurlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Get a Discover feeds item
/accounts/{accountId}/bluesky/feed-generators/{itemId}Suggested and searchable custom feeds; save, pin or like them. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/feed-generators.
Try it with MCPAsk your agent to call bluesky-feed-generators-get (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringAT-URI
uristringcidstringservice_didstring | nulldisplay_namestringdescriptionstring | nullavatar_urlstring (uri) | nulllike_countintegercreator_handlestring | nullaccepts_interactionsbooleancontent_modestring | nullcontentModeUnspecifiedcontentModeVideo
viewer_likestring | nulllabelsarray of stringurlstring (uri) | nullResponses
Bluesky: Save (Discover feeds)
/accounts/{accountId}/bluesky/feed-generators/{itemId}/saveSave. Suggested and searchable custom feeds; save, pin or like them. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/feed-generators.
Try it with MCPAsk your agent to call bluesky-feed-generators-save (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Pin (Discover feeds)
/accounts/{accountId}/bluesky/feed-generators/{itemId}/pinPin. Suggested and searchable custom feeds; save, pin or like them. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/feed-generators.
Try it with MCPAsk your agent to call bluesky-feed-generators-pin (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Like feed (Discover feeds)
/accounts/{accountId}/bluesky/feed-generators/{itemId}/likeLike feed. Suggested and searchable custom feeds; save, pin or like them. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/feed-generators.
Try it with MCPAsk your agent to call bluesky-feed-generators-like (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Unlike feed (Discover feeds)
/accounts/{accountId}/bluesky/feed-generators/{itemId}/unlikeUnlike feed. Suggested and searchable custom feeds; save, pin or like them. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/feed-generators.
Try it with MCPAsk your agent to call bluesky-feed-generators-unlike (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Feed posts
Bluesky: List Feed viewer
/accounts/{accountId}/bluesky/feed-postsPosts of any custom feed or list feed (app.bsky.feed.getFeed / getListFeed). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/feed-posts.
Try it with MCPAsk your agent to call bluesky-feed-posts-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringfeedstringfeed generator or list AT-URI / URL
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 35 item attributes
idstringrequiredAT-URI
uristringrequiredcidstringrequiredrkeystringurlstring (uri)textstringrequired≤ 3000 characters
created_atstring (date-time)indexed_atstring (date-time) | nulllangsarray of stringtagsarray of stringlabelsarray of stringauthor_idstringauthor_handlestringauthor_namestring | nullauthor_avatarstring (uri) | nullis_ownbooleanis_replybooleanparent_idstring | nullroot_idstring | nulllike_countintegerrepost_countintegerreply_countintegerquote_countintegerbookmark_countintegerembedobject | nullShow 7 child attributes
typestringimagesvideoexternalrecordrecord_with_media
imagesarray of objectShow 3 item attributes
urlstring (uri)thumbstring (uri)altstringplayliststring (uri) | nullthumbnailstring (uri) | nulluristring (uri) | nulltitlestring | nullrecord_uristring | nullviewer_likestring | nullviewer_repoststring | nullviewer_bookmarkedbooleanviewer_thread_mutedbooleanreply_disabledbooleanembedding_disabledbooleanpinnedbooleanreposted_bystring | nullthreadgate_rulesarray of string | nullhidden_repliesarray of stringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
My feeds
Bluesky: List My feed generators
/accounts/{accountId}/bluesky/my-feedsPublish/maintain custom feed listings (app.bsky.feed.generator). Requires running a feed-generator service. Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authManageFeedDeclarations | transition:generic. Generic route: /v1/accounts/{accountId}/focus/my-feeds.
Try it with MCPAsk your agent to call bluesky-my-feeds-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 14 item attributes
idstringAT-URI
uristringcidstringservice_didstring | nulldisplay_namestringdescriptionstring | nullavatar_urlstring (uri) | nulllike_countintegercreator_handlestring | nullaccepts_interactionsbooleancontent_modestring | nullcontentModeUnspecifiedcontentModeVideo
viewer_likestring | nulllabelsarray of stringurlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a My feed generators item
/accounts/{accountId}/bluesky/my-feedsPublish/maintain custom feed listings (app.bsky.feed.generator). Requires running a feed-generator service. Requires one of: include:app.bsky.authManageFeedDeclarations | transition:generic. Generic route: /v1/accounts/{accountId}/focus/my-feeds.
Try it with MCPAsk your agent to call bluesky-my-feeds-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
rkeystringrequiredshort feed id used in the URL (create only)
pattern ^[a-zA-Z0-9-]{1,15}$
service_didstringrequireddid:web of the feed generator service
display_namestringrequired≤ 24 graphemes
descriptionstringavatarstringaccepts_interactionsbooleancontent_modestringunspecifiedvideo
Returns object
idstringAT-URI
uristringcidstringservice_didstring | nulldisplay_namestringdescriptionstring | nullavatar_urlstring (uri) | nulllike_countintegercreator_handlestring | nullaccepts_interactionsbooleancontent_modestring | nullcontentModeUnspecifiedcontentModeVideo
viewer_likestring | nulllabelsarray of stringurlstring (uri) | nullResponses
Bluesky: Update a My feed generators item
/accounts/{accountId}/bluesky/my-feeds/{itemId}Publish/maintain custom feed listings (app.bsky.feed.generator). Requires running a feed-generator service. Requires one of: include:app.bsky.authManageFeedDeclarations | transition:generic. Generic route: /v1/accounts/{accountId}/focus/my-feeds.
Try it with MCPAsk your agent to call bluesky-my-feeds-update (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
rkeystringshort feed id used in the URL (create only)
pattern ^[a-zA-Z0-9-]{1,15}$
service_didstringdid:web of the feed generator service
display_namestring≤ 24 graphemes
descriptionstringavatarstringaccepts_interactionsbooleancontent_modestringunspecifiedvideo
Returns object
idstringAT-URI
uristringcidstringservice_didstring | nulldisplay_namestringdescriptionstring | nullavatar_urlstring (uri) | nulllike_countintegercreator_handlestring | nullaccepts_interactionsbooleancontent_modestring | nullcontentModeUnspecifiedcontentModeVideo
viewer_likestring | nulllabelsarray of stringurlstring (uri) | nullResponses
Bluesky: Delete a My feed generators item
/accounts/{accountId}/bluesky/my-feeds/{itemId}Publish/maintain custom feed listings (app.bsky.feed.generator). Requires running a feed-generator service. Requires one of: include:app.bsky.authManageFeedDeclarations | transition:generic. Generic route: /v1/accounts/{accountId}/focus/my-feeds.
Try it with MCPAsk your agent to call bluesky-my-feeds-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Reports
Bluesky: Create a Report content item
/accounts/{accountId}/bluesky/reportsReport posts, lists, feeds or accounts to Bluesky moderation (or another labeler). Keep a record of reports — the developer guidelines require it. Requires one of: rpc:com.atproto.moderation.createReport?aud=* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/reports.
Try it with MCPAsk your agent to call bluesky-reports-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
subjectstringrequiredpost/list/feed AT-URI or URL, or an account handle/DID
reason_typestringrequiredspamviolationmisleadingsexualrudeotherappeal
reasonstring≤ 2000 characters
labelerstringlabeler DID (default Bluesky moderation)
Returns object
idinteger | nullreason_typestringsubjectobjectShow 2 child attributes
uristringdidstringcreated_atstring (date-time)Responses
Muted words
Bluesky: List Muted words & tags
/accounts/{accountId}/bluesky/muted-wordsCursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/muted-words.
Try it with MCPAsk your agent to call bluesky-muted-words-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
idstringvaluestringword, phrase or tag (without #)
targetsarray of stringactor_targetstringallexclude-following
expires_atstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Muted words & tags item
/accounts/{accountId}/bluesky/muted-wordsRequires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/muted-words.
Try it with MCPAsk your agent to call bluesky-muted-words-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
valuestringrequiredtargetsarray of stringactor_targetstringallexclude-following
expires_atstring (date-time) | nullReturns object
idstringvaluestringword, phrase or tag (without #)
targetsarray of stringactor_targetstringallexclude-following
expires_atstring (date-time) | nullResponses
Bluesky: Update a Muted words & tags item
/accounts/{accountId}/bluesky/muted-words/{itemId}Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/muted-words.
Try it with MCPAsk your agent to call bluesky-muted-words-update (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
valuestringtargetsarray of stringactor_targetstringallexclude-following
expires_atstring (date-time) | nullReturns object
idstringvaluestringword, phrase or tag (without #)
targetsarray of stringactor_targetstringallexclude-following
expires_atstring (date-time) | nullResponses
Bluesky: Delete a Muted words & tags item
/accounts/{accountId}/bluesky/muted-words/{itemId}Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/muted-words.
Try it with MCPAsk your agent to call bluesky-muted-words-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Content filters
Bluesky: Get Content filters
/accounts/{accountId}/bluesky/content-filtersAdult content and how Bluesky moderation labels are shown (adultContentPref + contentLabelPref). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/content-filters.
Try it with MCPAsk your agent to call bluesky-content-filters-get (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
adult_content_enabledbooleanlabelsobjectShow 5 child attributes
pornstringignoreshowwarnhide
sexualstringignoreshowwarnhide
nuditystringignoreshowwarnhide
graphic-mediastringignoreshowwarnhide
gorestringignoreshowwarnhide
Responses
Bluesky: Update Content filters
/accounts/{accountId}/bluesky/content-filtersAdult content and how Bluesky moderation labels are shown (adultContentPref + contentLabelPref). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/content-filters.
Try it with MCPAsk your agent to call bluesky-content-filters-update (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
adult_content_enabledbooleanlabelsobjectShow 5 child attributes
pornstringignoreshowwarnhide
sexualstringignoreshowwarnhide
nuditystringignoreshowwarnhide
graphic-mediastringignoreshowwarnhide
gorestringignoreshowwarnhide
Returns object
adult_content_enabledbooleanlabelsobjectShow 5 child attributes
pornstringignoreshowwarnhide
sexualstringignoreshowwarnhide
nuditystringignoreshowwarnhide
graphic-mediastringignoreshowwarnhide
gorestringignoreshowwarnhide
Responses
Labelers
Bluesky: List Moderation services
/accounts/{accountId}/bluesky/labelersSubscribed labelers (labelersPref). Bluesky’s own moderation always applies and cannot be removed. Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/labelers.
Try it with MCPAsk your agent to call bluesky-labelers-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstringdidstringhandlestring | nulldisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nulllike_countintegerlabel_valuesarray of stringbuiltinbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Moderation services item
/accounts/{accountId}/bluesky/labelersSubscribed labelers (labelersPref). Bluesky’s own moderation always applies and cannot be removed. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/labelers.
Try it with MCPAsk your agent to call bluesky-labelers-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
didstringrequiredlabeler account DID
Returns object
idstringdidstringhandlestring | nulldisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nulllike_countintegerlabel_valuesarray of stringbuiltinbooleanResponses
Bluesky: Delete a Moderation services item
/accounts/{accountId}/bluesky/labelers/{itemId}Subscribed labelers (labelersPref). Bluesky’s own moderation always applies and cannot be removed. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/labelers.
Try it with MCPAsk your agent to call bluesky-labelers-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Hidden posts
Bluesky: List Hidden posts
/accounts/{accountId}/bluesky/hidden-postsPosts hidden from the account’s feeds (hiddenPostsPref). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/hidden-posts.
Try it with MCPAsk your agent to call bluesky-hidden-posts-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 35 item attributes
idstringrequiredAT-URI
uristringrequiredcidstringrequiredrkeystringurlstring (uri)textstringrequired≤ 3000 characters
created_atstring (date-time)indexed_atstring (date-time) | nulllangsarray of stringtagsarray of stringlabelsarray of stringauthor_idstringauthor_handlestringauthor_namestring | nullauthor_avatarstring (uri) | nullis_ownbooleanis_replybooleanparent_idstring | nullroot_idstring | nulllike_countintegerrepost_countintegerreply_countintegerquote_countintegerbookmark_countintegerembedobject | nullShow 7 child attributes
typestringimagesvideoexternalrecordrecord_with_media
imagesarray of objectShow 3 item attributes
urlstring (uri)thumbstring (uri)altstringplayliststring (uri) | nullthumbnailstring (uri) | nulluristring (uri) | nulltitlestring | nullrecord_uristring | nullviewer_likestring | nullviewer_repoststring | nullviewer_bookmarkedbooleanviewer_thread_mutedbooleanreply_disabledbooleanembedding_disabledbooleanpinnedbooleanreposted_bystring | nullthreadgate_rulesarray of string | nullhidden_repliesarray of stringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Create a Hidden posts item
/accounts/{accountId}/bluesky/hidden-postsPosts hidden from the account’s feeds (hiddenPostsPref). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/hidden-posts.
Try it with MCPAsk your agent to call bluesky-hidden-posts-create (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
uristringrequiredReturns object
idstringrequiredAT-URI
uristringrequiredcidstringrequiredrkeystringurlstring (uri)textstringrequired≤ 3000 characters
created_atstring (date-time)indexed_atstring (date-time) | nulllangsarray of stringtagsarray of stringlabelsarray of stringauthor_idstringauthor_handlestringauthor_namestring | nullauthor_avatarstring (uri) | nullis_ownbooleanis_replybooleanparent_idstring | nullroot_idstring | nulllike_countintegerrepost_countintegerreply_countintegerquote_countintegerbookmark_countintegerembedobject | nullShow 7 child attributes
typestringimagesvideoexternalrecordrecord_with_media
imagesarray of objectShow 3 item attributes
urlstring (uri)thumbstring (uri)altstringplayliststring (uri) | nullthumbnailstring (uri) | nulluristring (uri) | nulltitlestring | nullrecord_uristring | nullviewer_likestring | nullviewer_repoststring | nullviewer_bookmarkedbooleanviewer_thread_mutedbooleanreply_disabledbooleanembedding_disabledbooleanpinnedbooleanreposted_bystring | nullthreadgate_rulesarray of string | nullhidden_repliesarray of stringResponses
Bluesky: Delete a Hidden posts item
/accounts/{accountId}/bluesky/hidden-posts/{itemId}Posts hidden from the account’s feeds (hiddenPostsPref). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/hidden-posts.
Try it with MCPAsk your agent to call bluesky-hidden-posts-delete (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Search posts
Bluesky: List Search posts
/accounts/{accountId}/bluesky/search-postsSocial listening over Bluesky posts (app.bsky.feed.searchPosts; Lucene-like syntax, e.g. "from:alice.bsky.social #atproto"). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/search-posts.
Try it with MCPAsk your agent to call bluesky-search-posts-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
qstringrequiredsortstringdefault: "latest"toplatest
sincestring (date-time)untilstring (date-time)authorstringmentionsstringlangstringdomainstringurlstring (uri)tagarray of stringlimitintegerdefault: 25≤ 100
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 35 item attributes
idstringrequiredAT-URI
uristringrequiredcidstringrequiredrkeystringurlstring (uri)textstringrequired≤ 3000 characters
created_atstring (date-time)indexed_atstring (date-time) | nulllangsarray of stringtagsarray of stringlabelsarray of stringauthor_idstringauthor_handlestringauthor_namestring | nullauthor_avatarstring (uri) | nullis_ownbooleanis_replybooleanparent_idstring | nullroot_idstring | nulllike_countintegerrepost_countintegerreply_countintegerquote_countintegerbookmark_countintegerembedobject | nullShow 7 child attributes
typestringimagesvideoexternalrecordrecord_with_media
imagesarray of objectShow 3 item attributes
urlstring (uri)thumbstring (uri)altstringplayliststring (uri) | nullthumbnailstring (uri) | nulluristring (uri) | nulltitlestring | nullrecord_uristring | nullviewer_likestring | nullviewer_repoststring | nullviewer_bookmarkedbooleanviewer_thread_mutedbooleanreply_disabledbooleanembedding_disabledbooleanpinnedbooleanreposted_bystring | nullthreadgate_rulesarray of string | nullhidden_repliesarray of stringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Like (Search posts)
/accounts/{accountId}/bluesky/search-posts/{itemId}/likeLike. Social listening over Bluesky posts (app.bsky.feed.searchPosts; Lucene-like syntax, e.g. "from:alice.bsky.social #atproto"). Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/search-posts.
Try it with MCPAsk your agent to call bluesky-search-posts-like (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Repost (Search posts)
/accounts/{accountId}/bluesky/search-posts/{itemId}/repostRepost. Social listening over Bluesky posts (app.bsky.feed.searchPosts; Lucene-like syntax, e.g. "from:alice.bsky.social #atproto"). Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/search-posts.
Try it with MCPAsk your agent to call bluesky-search-posts-repost (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Search accounts
Bluesky: List Search accounts
/accounts/{accountId}/bluesky/search-accountsCursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/search-accounts.
Try it with MCPAsk your agent to call bluesky-search-accounts-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
qstringrequiredtypeaheadbooleanlimitintegerdefault: 25cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 22 item attributes
idstringrequiredDID
didstringhandlestringrequireddisplay_namestring | nulldescriptionstring | nullavatar_urlstring (uri) | nullbanner_urlstring (uri) | nullfollowers_countinteger | nullfollowing_countinteger | nullposts_countinteger | nulllabelsarray of stringis_botbooleanverifiedbooleancreated_atstring (date-time) | nullindexed_atstring (date-time) | nullviewer_followingstring | nullfollow record URI when the account follows them
viewer_followed_bystring | nullviewer_mutedbooleanviewer_blockingstring | nullblock record URI
viewer_blocked_bybooleanallow_incoming_chatstring | nullallfollowingnone
urlstring (uri)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Bluesky: Follow (Search accounts)
/accounts/{accountId}/bluesky/search-accounts/{itemId}/followFollow. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/search-accounts.
Try it with MCPAsk your agent to call bluesky-search-accounts-follow (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bluesky: Mute (Search accounts)
/accounts/{accountId}/bluesky/search-accounts/{itemId}/muteMute. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/search-accounts.
Try it with MCPAsk your agent to call bluesky-search-accounts-mute (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Search starter packs
Bluesky: List Search starter packs
/accounts/{accountId}/bluesky/search-starter-packsCursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/search-starter-packs.
Try it with MCPAsk your agent to call bluesky-search-starter-packs-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
qstringrequiredlimitintegerdefault: 25cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 8 item attributes
idstringuristringnamestringdescriptionstring | nullmember_countinteger | nulljoined_all_timeinteger | nullcreator_handlestring | nullurlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Analytics overview
Bluesky: Get Overview
/accounts/{accountId}/bluesky/analytics-overviewPass ?since&until; the API supplies stored snapshots as ctx.snapshots. Followers, following and posts with follower growth from daily snapshots, plus engagement on recent posts. Bluesky has no impressions or views. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/analytics-overview.
Try it with MCPAsk your agent to call bluesky-analytics-overview-get (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
followersintegerfollowingintegerposts_countintegerseriesarray of objectShow 2 item attributes
datestring (date)metricsobjectShow 3 child attributes
followersintegerfollowingintegerfollower_changeintegertotalsobjectShow 3 child attributes
followersintegerfollowingintegerfollower_changeintegerrecent_engagementobjectShow 7 child attributes
postsintegerlikesintegersharesintegercommentsintegerquotesintegersavesintegerengagementsintegerResponses
Post analytics
Bluesky: List Post performance
/accounts/{accountId}/bluesky/post-analyticsLikes, reposts, replies, quotes and bookmarks per recent post. Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/post-analytics.
Try it with MCPAsk your agent to call bluesky-post-analytics-list (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sortstringdefault: "recent"recenttop
limitintegerdefault: 50≤ 200
sincestring (date-time)untilstring (date-time)Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringcreated_atstring (date-time)textstringlike_countintegerrepost_countintegerreply_countintegerquote_countintegerbookmark_countintegerengagementsintegerurlstring (uri)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Video limits
Bluesky: Get Video quota
/accounts/{accountId}/bluesky/video-limitsRemaining daily video uploads and bytes (app.bsky.video.getUploadLimits). Bluesky-hosted accounts need a verified email. Requires one of: rpc:com.atproto.repo.uploadBlob?aud=* + rpc:app.bsky.video.getUploadLimits?aud=* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/video-limits.
Try it with MCPAsk your agent to call bluesky-video-limits-get (toolset focus_bluesky)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
can_uploadbooleanremaining_daily_videosinteger | nullremaining_daily_bytesinteger | nullmessagestring | null