get-pinned-feedsLABSCO SUMMARY
It reads far more than it writes, and the reading is where it earns its place.
Three calls write. The rest bring Bluesky into the conversation — your timeline, any custom feed or list, a full reply thread, who an account follows, trends with their post counts, and search across posts, people and feeds.
What it is
A Bluesky client exposed as tools, working against the ATProtocol API as a signed-in account.
What you get
- Your own view: get-timeline-posts, get-pinned-feeds and get-liked-posts
- Other people: get-profile, get-user-posts, get-follows and get-followers
- Feeds and lists: get-feed-posts, get-list-posts and search-feeds
- Conversations: get-post-thread returns a whole thread with its replies and context
- Discovery: search-posts by top or latest, search-people, and get-trends with post counts
- Writing: create-post publishes, like-post likes a post by URI, follow-user follows an account
- convert-url-to-uri — a Bluesky web URL turned into the AT URI the other calls take
Requirements
A Bluesky account for the server to act as: the timeline, pinned feeds and liked posts belong to that account, and posting, liking and following happen under it.
Setup effort
One command plus credentials — npx -y @smithery/cli install @brianellin/bsky-mcp-server --client claude, then supply credentials
USE CASES
Catching up on what happened while you were away
Read the timeline and the current trends together, so the summary has both what your circle said and what everyone else did.
Understanding a thread you were tagged into
Convert the link you were sent into an AT URI, then pull the whole thread with its replies.
Working out what an account is about
Read the profile, their recent posts and who they follow, which says more than the bio does.
Finding a community around a topic
Search feeds for the subject, read what is posted in the best one, and find the people behind it.
Posting without opening the app
Publish, like and follow from the same conversation that drafted the post.
18 tools
Listed in project docs. Your client may show a different list.
get-timeline-postsget-feed-postsget-list-postsget-user-postsget-profileget-followsget-followersget-liked-postsget-trendsget-post-threadconvert-url-to-urisearch-postssearch-peoplesearch-feedslike-postcreate-postfollow-userBEFORE YOU INSTALL
What to know first
Tools you get
18 tools named in the project's documentation.
Requires
- BLUESKY_IDENTIFIER in your environment
- BLUESKY_APP_PASSWORD in your environment
INSTALLATION
Connect your client
Server setup
Setup
git clone https://github.com/brianellin/bsky-mcp-server.git
cd bsky-mcp-server
pnpm install
pnpm run buildnpx
npx -y @smithery/cli install @brianellin/bsky-mcp-server --client claudeMCP Clients
Claude Desktop
{
"mcpServers": {
"bluesky": {
"command": "node",
"args": [
"<YOUR_PATH_TO_BSKY_MCP_SERVER>/build/src/index.js"
],
"env": {
"BLUESKY_IDENTIFIER": "<YOUR_BLUESKY_IDENTIFIER>",
"BLUESKY_APP_PASSWORD": "<YOUR_BLUESKY_APP_PASSWORD>",
"BLUESKY_SERVICE_URL": "https://bsky.social"
}
}
}
}MCP Inspector (testing)
npx @modelcontextprotocol/inspector node build/src/index.js