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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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
typestringWhether count represents number of posts or hours to look backone of
posts · hourscountnumberNumber of posts to fetch or hours to look back
create-postCreate a new post on Bluesky2 params
Create a new post on Bluesky
Parameters* required
textstringThe content of your post
replyTostringOptional URI of post to reply to
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
sortstringSort order for search results - 'top' for most relevant or 'latest' for most recentone of
top · latestdefault: toplimitnumberNumber of results to fetch (1-100)default: 50
querystringSearch query
get-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
limitnumberNumber of trending topics to fetch (1-50)default: 10
includeSuggestedbooleanWhether to include suggested topics in addition to trending topicsdefault: false
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
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 · hourscountnumberNumber of posts to fetch or hours to look back
get-list-postsFetch posts from users in a specified list3 params
Fetch posts from users in a specified list
Parameters* required
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 · hourscountnumberNumber of posts to fetch or hours to look back
get-user-postsFetch posts from a specific user3 params
Fetch posts from a specific user
Parameters* required
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)
countnumberNumber of posts to fetch or hours to look back
get-followsGet a list of users that a person follows2 params
Get a list of users that a person follows
Parameters* required
userstringThe handle or DID of the user (e.g., alice.bsky.social)
limitnumberMaximum number of follows to fetch (1-500)default: 500
get-followersGet a list of users that follow a person2 params
Get a list of users that follow a person
Parameters* required
userstringThe handle or DID of the user (e.g., alice.bsky.social)
limitnumberMaximum number of followers to fetch (1-500)default: 500
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
uristringThe URI of the post to get likes for (e.g., at://did:plc:abcdef/app.bsky.feed.post/123)
limitnumberMaximum number of likes to fetch (1-100)default: 100
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 673+ 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. |
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"
}
}
}
Or connect to the full Pipeworx gateway for access to all 673+ data sources:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English:
ask_pipeworx({ question: "your question about Bluesky data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →