Summary
Wraps the AT Protocol API to pull data from Bluesky directly into Claude. You get seven tools: look up profiles by handle, fetch user timelines and followers, pull posts from algorithmic feeds like "discover" or "what's hot", retrieve full conversation threads, and resolve handles to DIDs. No posting or write operations, just read access to public Bluesky data. Part of the Pipeworx gateway, which means you can either connect to this server standalone or access it through their unified endpoint alongside 670+ other data sources. Useful when you need to analyze Bluesky accounts, track conversations, or pull social context into your workflows without leaving your MCP client.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Tools
Public tool metadata for what this MCP can expose to an agent.
21 tools
get-my-handle-and-didReturn the handle and did of the currently authenticated user for this blusesky session. Useful for when someone asks information about themselves using "me" or "my" on bluesky.
Return the handle and did of the currently authenticated user for this blusesky session. Useful for when someone asks information about themselves using "me" or "my" on bluesky.
No parameter schema in public metadata yet.
get-timeline-postsFetch your home timeline from Bluesky, which includes posts from all of the people you follow in reverse chronological order2 params
Fetch your home timeline from Bluesky, which includes posts from all of the people you follow in reverse chronological order
Parameters* required
countnumberNumber of posts to fetch or hours to look back
typestringWhether count represents number of posts or hours to look backone of
posts · hourscreate-postCreate a new post on Bluesky2 params
Create a new post on Bluesky
Parameters* required
replyTostringOptional URI of post to reply to
textstringThe content of your post
get-profileGet a user's profile from Bluesky1 params
Get a user's profile from Bluesky
Parameters* required
handlestringThe handle of the user (e.g., alice.bsky.social)
search-postsSearch for posts on Bluesky3 params
Search for posts on Bluesky
Parameters* required
limitnumberNumber of results to fetch (1-100)default: 50
querystringSearch query
sortstringSort order for search results - 'top' for most relevant or 'latest' for most recentone of
top · latestdefault: topget-post-threadGet a full conversation thread for a specific post, showing replies and context1 params
Get a full conversation thread for a specific post, showing replies and context
Parameters* required
uristringURI of the post to fetch the thread for (e.g., at://did:plc:abcdef/app.bsky.feed.post/123)
convert-url-to-uriConvert a Bluesky web URL to an AT URI format that can be used with other tools1 params
Convert a Bluesky web URL to an AT URI format that can be used with other tools
Parameters* required
urlstringBluesky post URL to convert (e.g., https://bsky.app/profile/username.bsky.social/post/postid)
search-peopleSearch for users/actors on Bluesky2 params
Search for users/actors on Bluesky
Parameters* required
limitnumberNumber of results to fetch (1-100)default: 20
querystringSearch query for finding users
search-feedsSearch for custom feeds on Bluesky2 params
Search for custom feeds on Bluesky
Parameters* required
limitnumberNumber of results to fetch (1-100)default: 10
querystringSearch query for finding feeds
get-liked-postsGet a list of posts that the authenticated user has liked1 params
Get a list of posts that the authenticated user has liked
Parameters* required
limitnumberMaximum number of liked posts to fetch (1-100)default: 50
get-trendsGet current trending topics on Bluesky2 params
Get current trending topics on Bluesky
Parameters* required
includeSuggestedbooleanWhether to include suggested topics in addition to trending topicsdefault: false
limitnumberNumber of trending topics to fetch (1-50)default: 10
like-postLike a post on Bluesky1 params
Like a post on Bluesky
Parameters* required
uristringThe URI of the post to like
follow-userFollow a user on Bluesky1 params
Follow a user on Bluesky
Parameters* required
handlestringThe handle of the user to follow
get-pinned-feedsGet the authenticated user's pinned feeds and lists.
Get the authenticated user's pinned feeds and lists.
No parameter schema in public metadata yet.
get-feed-postsFetch posts from a specified feed3 params
Fetch posts from a specified feed
Parameters* required
countnumberNumber of posts to fetch or hours to look back
feedstringThe URI of the feed to fetch posts from (e.g., at://did:plc:abcdef/app.bsky.feed.generator/whats-hot)
typestringWhether count represents number of posts or hours to look backone of
posts · hoursget-list-postsFetch posts from users in a specified list3 params
Fetch posts from users in a specified list
Parameters* required
countnumberNumber of posts to fetch or hours to look back
liststringThe URI of the list (e.g., at://did:plc:abcdef/app.bsky.graph.list/listname)
typestringWhether count represents number of posts or hours to look backone of
posts · hoursget-user-postsFetch posts from a specific user3 params
Fetch posts from a specific user
Parameters* required
countnumberNumber of posts to fetch or hours to look back
typestringWhether count represents number of posts or hours to look backone of
posts · hoursuserstringThe handle or DID of the user (e.g., alice.bsky.social)
get-followsGet a list of users that a person follows2 params
Get a list of users that a person follows
Parameters* required
limitnumberMaximum number of follows to fetch (1-500)default: 500
userstringThe handle or DID of the user (e.g., alice.bsky.social)
get-followersGet a list of users that follow a person2 params
Get a list of users that follow a person
Parameters* required
limitnumberMaximum number of followers to fetch (1-500)default: 500
userstringThe handle or DID of the user (e.g., alice.bsky.social)
get-post-likesGet information about users who have liked a specific post2 params
Get information about users who have liked a specific post
Parameters* required
limitnumberMaximum number of likes to fetch (1-100)default: 100
uristringThe URI of the post to get likes for (e.g., at://did:plc:abcdef/app.bsky.feed.post/123)
list-resourcesList all available MCP resources with their descriptions
List all available MCP resources with their descriptions
No parameter schema in public metadata yet.
mcp-bluesky
Bluesky MCP — wraps the AT Protocol API
Part of Pipeworx — an MCP gateway connecting AI agents to 1683+ live data sources.
Tools
| Tool | Description |
|---|---|
get_profile | Look up a Bluesky user's profile by handle (e.g., "alice.bsky.social"). Returns display name, bio, follower/following counts, avatar, and verification status. |
get_posts | Fetch recent posts from a Bluesky user's timeline. Returns post text, timestamps, likes, reposts, reply counts, and threaded replies. |
search_posts | Search Bluesky posts by keyword or phrase. Returns matching posts with author handles, timestamps, engagement metrics, and content.Requires bsky_handle and bsky_app_password in the gateway URL query params. |
get_feed | Get posts from a Bluesky feed (e.g., "discover", "what's-hot"). Returns recent posts with authors, timestamps, and engagement counts. |
get_followers | Get a user's followers on Bluesky by handle. Returns follower profiles including handles, display names, bios, and follower counts. |
get_follows | Get accounts a Bluesky user follows by handle. Returns followed profiles with handles, display names, bios, and descriptions. |
get_thread | Fetch a post thread by URI. Returns the parent post and all replies in conversation order with timestamps, authors, and engagement data. |
resolve_handle | Convert a Bluesky handle to its DID (decentralized identifier). Returns the DID for programmatic account lookups. |
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"bluesky": {
"url": "https://gateway.pipeworx.io/bluesky/mcp"
}
}
}
What this endpoint actually serves
tools/list at https://gateway.pipeworx.io/bluesky/mcp returns the tools in the table
above plus the shared Pipeworx meta-tools — ask_pipeworx,
discover_tools, search_within, remember/recall and the rest of the
gateway-wide set. So the tool count you see is larger than this table: a
single-pack endpoint currently lists roughly 30 shared tools alongside the
pack's own. The connection's initialize response states its exact scope, and
is the authoritative answer for a given day.
This is deliberate, not multiplexing by accident. The meta-tools are what let a
scoped connection answer a question this pack does not cover — via
ask_pipeworx, which routes across the whole catalog — without you adding a
second MCP server. There is currently no way to mount a pack endpoint without
them; if the extra schemas cost you more context than the routing is worth,
connect to the full gateway once rather than to several pack endpoints.
Or connect to the full Pipeworx gateway to get every pack's tools listed directly, instead of just this one's:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Both URLs reach the same gateway and the same 1683+ data sources. The
only difference is which pack's tools are listed directly; ask_pipeworx
reaches all of them from either one.
No MCP client? Call it over HTTP
curl -X POST https://gateway.pipeworx.io/v1/tools/bluesky_get_profile \
-H 'Content-Type: application/json' \
-d '{"handle":"alice.bsky.social"}'
No account needed for the first calls. Inspect any tool: GET https://gateway.pipeworx.io/v1/tools/bluesky_get_profile. Find one: POST https://gateway.pipeworx.io/v1/tools/search_packs with {"query":"..."}.
Standalone (no gateway account)
This package also runs as a local stdio MCP server — no Pipeworx account, no gateway round-trip:
{
"mcpServers": {
"bluesky": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-bluesky"]
}
}
}
Or run it directly to confirm it starts:
npx -y @pipeworx/mcp-bluesky
It speaks MCP over stdin/stdout and answers initialize/tools/list/tools/call
for only this pack's tools — none of the shared meta-tools the gateway
connection above adds. Same source, same tools, no ask_pipeworx routing.
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English — this works on the pack endpoint above as well as on the full gateway:
ask_pipeworx({ question: "your question about Bluesky data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →