bluesky 8 tools

MCP server exposing 8 tools for bluesky.

Endpoint

This URL is a JSON-RPC 2.0 endpoint over HTTP. Issue POST requests with a JSON-RPC body. Browsers and search crawlers land here on GET.

POST https://gateway.pipeworx.io/bluesky/mcp
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

Tools

• 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.

Full documentation

Code samples (curl / TypeScript / one-click client install), schemas, and the live playground are on the pack page:
https://pipeworx.io/packs/bluesky/

About Pipeworx

Pipeworx is an open MCP gateway connecting AI agents to live data. pipeworx.io