Bluesky#

Tap into the Bluesky social network through the AT Protocol. Most tools work without authentication against the public API — you can read profiles, browse feeds, list followers, and view threads. Post search requires BYO credentials.

All 8 tools#

ToolAuthPurposeget_profilePublicUser profile by handle (e.g., jay.bsky.team)get_postsPublicRecent posts from a user's feedsearch_postsAuth requiredSearch posts by keywordget_feedPublicBrowse a feed generator (default: What's Hot)get_followersPublicList a user's followersget_followsPublicList accounts a user followsget_threadPublicFull thread from a post's AT URIresolve_handlePublicResolve a handle to its DID

When to use#

• Monitoring mentions of a brand or project on Bluesky
• Analyzing follower/following graphs for social network research
• Pulling recent posts from a specific user to summarize or quote
• Building a Bluesky dashboard that aggregates multiple feeds

Example: reading someone's recent posts#

bash

curl -s -X POST https://gateway.pipeworx.io/bluesky/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_posts","arguments":{"handle":"jay.bsky.team","limit":5}}}'

Each post includes the text, timestamp, like count, repost count, and reply count.

Authentication note#

search_posts requires Bluesky credentials. Pass them as query parameters on the gateway URL:

text

https://gateway.pipeworx.io/bluesky/mcp?bsky_handle=you.bsky.social&bsky_app_password=xxxx-xxxx-xxxx

All other tools work anonymously.

MCP client config#

json

{
  "mcpServers": {
    "pipeworx-bluesky": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://gateway.pipeworx.io/bluesky/mcp"]
    }
  }
}