Bluesky MCP Server

Creates posts on Bluesky using the AT Protocol's native post creation endpoint, supporting rich text formatting through facet-based markup (mentions, hashtags, links, embedded media). The implementation directly interfaces with the Bluesky PDS (Personal Data Server) API, handling text segmentation and facet coordinate calculation to map formatted text spans to byte offsets, enabling structured social content creation without manual coordinate management.

Fetches paginated timeline feeds (home, author, or custom algorithm feeds) from Bluesky using AT Protocol's cursor-based pagination mechanism. The implementation maintains cursor state across requests, allowing efficient incremental fetching of posts without re-downloading previously seen content. Supports filtering by feed algorithm and handles the Bluesky feed generator protocol for custom feed subscriptions.

Performs full-text search across Bluesky's indexed content (users, posts, hashtags) using the AT Protocol's search endpoints. The implementation queries Bluesky's search service which maintains inverted indices over post text and user profiles, returning ranked results with relevance scoring. Supports filtering by content type (users vs posts) and handles pagination of search results.

Manages follow relationships by creating or deleting follow records in the user's graph, using AT Protocol's graph operations. The implementation updates the user's follow list (a special graph collection) by adding or removing DID references, with changes immediately reflected in the user's social graph. Supports batch operations and handles graph consistency across the distributed AT Protocol network.

Retrieves and monitors a user's notification feed (likes, reposts, replies, follows) from the AT Protocol's notification service. The implementation fetches paginated notification records with metadata about the action type, actor, and timestamp, supporting filtering by notification type (e.g., only likes, only follows). Handles cursor-based pagination to efficiently track new notifications without re-fetching.

Resolves Bluesky user handles (e.g., @user.bsky.social) to their underlying Decentralized Identifiers (DIDs) using AT Protocol's identity resolution. The implementation queries the Bluesky directory service or PLC (Public LEDGER Consortium) to map handles to DIDs, with optional caching to reduce repeated lookups. Handles both Bluesky-hosted handles and custom domain handles via DNS TXT records.

Exposes all Bluesky operations (post creation, timeline fetching, search, follows, notifications) as MCP tools with JSON schema definitions, enabling LLM agents to invoke them via function calling. The implementation defines tool schemas with input parameters, output types, and descriptions, allowing Claude and other LLM clients to understand and call Bluesky operations as part of agentic workflows. Handles parameter validation and error translation back to the LLM.

Manages AT Protocol authentication by handling login, session token generation, and token refresh. The implementation exchanges Bluesky credentials for session tokens (access and refresh tokens), stores them securely, and automatically refreshes expired access tokens using the refresh token. Supports both password-based login and pre-existing token injection for stateless operation.

Supports creating multiple posts in sequence with optional reply threading, implementing transaction-like semantics where later posts can reference earlier posts created in the same batch. Uses AT Protocol's record creation with reply references (inReplyTo) to establish post relationships, enabling programmatic creation of threaded conversations or multi-post updates. Handles failures gracefully by continuing with subsequent posts and returning partial results.