Bluesky

live Social

Read public Bluesky social data — profiles, posts, feeds, and threads

8 tools
0ms auth
free forever

Tools

get_profile required: handle

Get a Bluesky user profile by handle (e.g., "alice.bsky.social")

Parameters
Name Type Description
handle req string Bluesky handle (e.g., alice.bsky.social)
get_posts required: handle

Get recent posts from a Bluesky user's feed

Parameters
Name Type Description
handle req string Bluesky handle
limit opt number Number of posts (1-100, default 20)
search_posts required: query

Search Bluesky posts by keyword

Parameters
Name Type Description
query req string Search query
limit opt number Number of results (1-100, default 25)
get_feed

Get posts from a Bluesky feed (default: discover/whats-hot)

Parameters
Name Type Description
feed_uri opt string AT URI of the feed generator (default: whats-hot)
limit opt number Number of posts (1-100, default 20)
get_followers required: handle

Get a user's followers

Parameters
Name Type Description
handle req string Bluesky handle
limit opt number Number of followers (1-100, default 50)
get_follows required: handle

Get accounts that a user follows

Parameters
Name Type Description
handle req string Bluesky handle
limit opt number Number of follows (1-100, default 50)
get_thread required: post_uri

Get a post thread by AT URI

Parameters
Name Type Description
post_uri req string AT URI of the post (at://did/app.bsky.feed.post/rkey)
resolve_handle required: handle

Resolve a Bluesky handle to a DID

Parameters
Name Type Description
handle req string Bluesky handle to resolve

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash 
curl -X POST https://pipeworx-gateway.subscriptions-ecc.workers.dev/bluesky/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash 
curl -X POST https://pipeworx-gateway.subscriptions-ecc.workers.dev/bluesky/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_profile","arguments":{"handle": "example"}}}'