This server lets MCP clients interact with Bluesky/AT Protocol, supporting public reads without credentials and account actions when credentials are configured.
Public, credential-free tools: get profiles, resolve handles, search posts, view author feeds, read post threads, get follow suggestions, list actor likes, followers, and follows.
Authenticated tools: view your timeline, create and delete posts, follow/unfollow users, and like/unlike posts.
Pagination support: cursor-based tools accept cursors from previous responses.
Flexible configuration: use the default public API endpoint or set BSKY_SERVICE; add BSKY_HANDLE and BSKY_PASSWORD to enable authenticated actions.
Provides tools for interacting with the AT Protocol ecosystem, enabling profile retrieval, social discovery, and feed fetching for Bluesky.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ATProto MCP Server find posts about AT Protocol"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server that gives compatible clients access to Bluesky and the AT Protocol over stdio. It works without credentials for public reads and enables account actions when Bluesky credentials are configured.
Independent project; see the trademark notice.
Public tools: get_profile, resolve_handle, search_posts, get_author_feed, get_post_thread, get_suggestions, get_actor_likes, get_followers, and get_follows.
Authenticated tools: get_timeline, create_post, delete_post, follow, unfollow, like, and unlike.
Cursor-based tools accept the cursor returned by a previous response. Write operations use AT URIs (and, for likes, the target CID) so callers can safely refer to exact records.
Related MCP server: bluesky-mcp
Requires Node.js 20 or newer.
npm install
npm run build
npm startThe default read-only endpoint is https://public.api.bsky.app. To use another service, set BSKY_SERVICE.
For authenticated tools, set BSKY_HANDLE and BSKY_PASSWORD. A Bluesky app password is recommended instead of the account password. When credentials are present, the default service changes to https://bsky.social.
Build the project first, then add it to your client's MCP configuration:
{
"mcpServers": {
"atproto": {
"command": "node",
"args": ["/absolute/path/to/atproto-mcp-server/build/index.js"],
"env": {
"BSKY_HANDLE": "alice.bsky.social",
"BSKY_PASSWORD": "xxxx-xxxx-xxxx-xxxx"
}
}
}
}Omit env for read-only use. The server writes logs to stderr, leaving stdout reserved for MCP messages.
npm testThe tests build the TypeScript project and validate that the advertised MCP tool surface is backed by handlers, including argument validation and AT Protocol request mapping.
If you find this project useful, consider supporting its development:
Retrieve the post feed for a specific author.
Inputs: actor (required), limit, cursor.
Get a specific post and its surrounding conversation thread.
Inputs: uri (required), depth.
Get detailed profile information for a Bluesky actor (handle or DID).
Inputs: actor (required).
Get suggested actors to follow.
Inputs: limit.
Resolve a Bluesky handle to its persistent Decentralized Identifier (DID).
Inputs: handle (required).
Search for public posts on Bluesky using keywords or phrases.
Inputs: q (required), limit.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 6 tools
Each tool targets a distinct aspect of the AT Protocol: feed, thread, profile, suggestions, handle resolution, and search. No overlap in functionality.
All tool names follow a consistent verb_noun pattern with underscores, using verbs like get, resolve, and search paired with specific nouns.
With 6 tools, the server is appropriately scoped for its purpose, covering key read operations without being excessive or insufficient.
The tools cover common read and query operations for Bluesky, but lack write capabilities (e.g., posting, following), which may be intentional but leaves a minor gap.
Discover MCP servers and A2A agents; verify, message, post, follow, react, and receive webhooks.
MCP server for OnceAsk, the AI-native current-address layer for people and agents.
MCP server for interacting with the Supabase platform
