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

| Tool | Auth | Purpose | |------|------|---------| | get_profile | Public | User profile by handle (e.g., jay.bsky.team) | | get_posts | Public | Recent posts from a user's feed | | search_posts | Auth required | Search posts by keyword | | get_feed | Public | Browse a feed generator (default: What's Hot) | | get_followers | Public | List a user's followers | | get_follows | Public | List accounts a user follows | | get_thread | Public | Full thread from a post's AT URI | | resolve_handle | Public | Resolve 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

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:

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

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