Bluesky

live Social

Read Bluesky social data — profiles, posts, feeds, and threads. Most tools are public; search requires BYO auth.

8 tools

0ms auth

free tier 50 calls/day

🔑 Authentication

Some tools (search_posts) require your own Bluesky credentials. Add your handle and an app password as query params on the gateway URL. Public tools work without any credentials.

Config with credentials

{
  "mcpServers": {
    "pipeworx-bluesky": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gateway.pipeworx.io/bluesky/mcp?bsky_handle=you.bsky.social&bsky_app_password=xxxx-xxxx-xxxx-xxxx"
      ]
    }
  }
}

Generate an app password →

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.

No parameters required.

▶ Try it

Response

get_posts

Fetch recent posts from a Bluesky user's timeline. Returns post text, timestamps, likes, reposts, reply counts, and threaded replies.

No parameters required.

▶ Try it

Response

search_posts

Search Bluesky posts by keyword or phrase. Returns matching posts with author handles, timestamps, engagement metrics, and content.

No parameters required.

▶ Try it

Response

get_feed

Get posts from a Bluesky feed (e.g., "discover", "what's-hot"). Returns recent posts with authors, timestamps, and engagement counts.

No parameters required.

▶ Try it

Response

get_followers

Get a user's followers on Bluesky by handle. Returns follower profiles including handles, display names, bios, and follower counts.

No parameters required.

▶ Try it

Response

get_follows

Get accounts a Bluesky user follows by handle. Returns followed profiles with handles, display names, bios, and descriptions.

No parameters required.

▶ Try it

Response

get_thread

Fetch a post thread by URI. Returns the parent post and all replies in conversation order with timestamps, authors, and engagement data.

No parameters required.

▶ Try it

Response

resolve_handle

Convert a Bluesky handle to its DID (decentralized identifier). Returns the DID for programmatic account lookups.

No parameters required.

▶ Try it

Response

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://gateway.pipeworx.io/bluesky/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Call a tool

bash

curl -X POST https://gateway.pipeworx.io/bluesky/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_profile","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript

import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("get_profile", {});

ask_pipeworx

// Or ask in plain English:
const answer = await px.ask("read bluesky social data — profiles, posts, feeds, and threads");

Related packs

Other Pipeworx packs in the same categories (Social):

MCP Config

claude_desktop_config.json

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