Bluesky integration
Bluesky Social API built on the AT Protocol (Authenticated Transfer Protocol) for decentralized social networking. Create posts, follow users, like content, search posts and profiles, manage notifications, and build social applications. Bluesky enables federated social media with user-owned data, custom feeds, and interoperability. Perfect for building social bots, content automation, analytics tools, and decentralized social applications.
Say what should happen.
The workflow builds itself.
Common Bluesky use cases
- engagement analysis
- displaying follower lists
- custom feeds
- handle lookup
- deleting posts
- posting images
- profile updates
- content filtering
- unmuting accounts
- blocking harassers
What you can do with Bluesky
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Profile, 3 operations
get_profileGet profileGETRetrieves detailed profile information for a Bluesky user including display name, bio, avatar, follower counts, and account metadata. Can be called without authentication for public profiles.get_profilesGet profilesGETRetrieves profile information for multiple Bluesky users in a single batch request. Accepts up to 25 handles or DIDs for efficient bulk lookups.update_profileUpdate profilePOSTUpdates the user's profile including display name, bio, avatar, and banner image.
Feed, 2 operations
get_author_feedGet author feedGETRetrieves posts from a specific user's profile with optional filtering for replies, media, and threads. Returns chronological post history with engagement metrics.get_feedGet feedGETRetrieves posts from a custom feed generator.
Follow, 2 operations
create_followCreate followPOSTFollows a user on Bluesky by creating a follow record. Requires the target user's DID. Returns the follow record URI for potential unfollowing.get_followsGet followsGETRetrieves the list of accounts a user follows with profile details. Returns following list with pagination support.
Like, 2 operations
create_likeCreate likePOSTLikes a post on Bluesky by creating a like record. Requires the target post's URI and CID. Returns the like record URI for potential deletion.get_likesGet likesGETRetrieves accounts that liked a specific post.
Mute, 2 operations
mute_actorMute actorPOSTMutes an account to hide their posts without unfollowing. Mutes are private.unmute_actorUnmute actorPOSTUnmutes a previously muted account to see their posts again.
Notification, 2 operations
get_unread_countGet unread countGETReturns the count of unread notifications for badge displays. Lightweight alternative to fetching full notification list.list_notificationsList notificationsGETRetrieves notifications for the authenticated user including likes, reposts, follows, mentions, replies, and quotes. Returns detailed notification data with read status.
Post, 2 operations
create_postCreate postPOSTCreates a new post on Bluesky with support for text, mentions, links, images, and quote posts. Returns the post's AT-URI and CID for future reference.search_postsSearch postsGETSearches Bluesky posts by text query with filters for author, date, language, mentions, links, and hashtags. Returns matching posts ranked by relevance or recency.
Repost, 2 operations
create_repostCreate repostPOSTReposts content on Bluesky to share with your followers. Creates a repost record referencing the original post. Returns the repost URI for potential deletion.get_reposted_byGet reposted byGETRetrieves accounts that reposted a specific post.
Session, 2 operations
create_sessionCreate sessionPOSTAuthenticates a user and creates a new session with JWT tokens. Returns accessJwt for API calls and refreshJwt for token renewal. Essential first step for any authenticated Bluesky operations.refresh_sessionRefresh sessionPOSTRefreshes authentication session using refresh token to get new access token.
Actor, 1 operation
search_actorsSearch actorsGETSearches for Bluesky users by handle or display name. Returns matching profiles ranked by relevance for user discovery and autocomplete.
Blob, 1 operation
upload_blobUpload blobPOSTUploads a binary file like an image to your repository. Returns blob metadata for embedding in posts. Required before creating posts with images.
Block, 1 operation
block_actorBlock actorPOSTBlocks an account preventing mutual interaction. Block records are public in Bluesky.
Follower, 1 operation
get_followersGet followersGETRetrieves the list of accounts following a user with profile details. Returns follower list with pagination support.
Identity, 1 operation
resolve_handleResolve handleGETResolves a Bluesky handle to its DID identifier.
Record, 1 operation
delete_recordDelete recordPOSTDeletes a record from your repository to undo actions like posts, likes, reposts, or follows. Requires the collection and record key.
Thread, 1 operation
get_post_threadGet post threadGETRetrieves a complete conversation thread including the post, its replies, and parent context. Returns nested structure for displaying full discussions.
Timeline, 1 operation
get_timelineGet timelineGETRetrieves the authenticated user's home timeline with posts from followed accounts. Returns reverse-chronological feed with full post details and pagination.
Bluesky API rate limits
- 600 requests per minute
- Bursts of up to 3,000 requests
3000 requests per 5 minutes per IP. Record creation limited to 5000 points/hour and 35000 points/day per account.
These are the limits Bluesky documents, not ones LiveContext measured. They can change and often depend on your plan, so check the Bluesky documentation for current values.
Use Bluesky from Claude Code, Cursor or Codex
Connect Bluesky in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Bluesky operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Bluesky
- Create your workspace
Sign up free. Nothing to install.
- Connect Bluesky once
Add your Bluesky connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Bluesky integration FAQ
What can you do with the Bluesky integration?
LiveContext exposes 27 operations on Bluesky, covering profile, feed, follow and like. Common uses include engagement analysis, displaying follower lists and custom feeds.
What are the Bluesky API rate limits?
Bluesky documents 600 requests per minute and bursts of up to 3,000 requests. 3000 requests per 5 minutes per IP. Record creation limited to 5000 points/hour and 35000 points/day per account. Limits are set by Bluesky and can depend on your plan.
