# Bluesky

> Bluesky is a freemium MCP server for web search and scraping. Read-only Bluesky profiles, posts, feeds and threads for AI assistants via a gateway. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/bluesky
- **Repository:** https://github.com/pipeworx-io/mcp-bluesky
- **MCP Registry name:** io.github.pipeworx-io/bluesky
- **Categories:** [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping)
- **Listing updated:** 2026-11-18

## About

The Pipeworx Bluesky server gives an AI client read access to public Bluesky data through the AT Protocol: user profiles, recent timelines, feed contents, follower and following lists, post threads, and handle-to-DID resolution. Most tools need no credentials at all.

Keyword post search is the exception. It requires your own Bluesky handle and an app password, which are passed as query parameters on the gateway URL rather than stored by the server. Calls are counted against a daily allowance that is higher when a free Pipeworx API key is supplied.

It suits developers and researchers who want an assistant to pull Bluesky activity into a workflow without building their own AT Protocol client. The README also notes that the endpoint lists the shared gateway meta-tools alongside the Bluesky tools, and that a stdio npm package is available for local use.

## Features

- **Public profile lookup:** Returns display name, bio, follower and following counts, avatar and verification status for a handle.
- **Timeline and feed reads:** Fetches recent posts from a user's timeline or a named feed with engagement counts.
- **Follower and follow lists:** Lists the accounts a user follows or is followed by, with profile details.
- **Thread retrieval:** Returns a parent post and its replies in conversation order from a post URI.
- **Handle to DID resolution:** Converts a Bluesky handle into its decentralized identifier for programmatic lookups.
- **Credentialed keyword search:** Searches posts by keyword when the user supplies their own handle and app password.

## Good for

- Pulling a public account's recent posts into an assistant for summarising activity
- Checking a feed such as discover for topics during research
- Mapping who follows or is followed by a given account
- Following a reply thread to see the full discussion context
- Converting handles to DIDs before calling other AT Protocol tools

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http bluesky https://gateway.pipeworx.io/bluesky/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/bluesky/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "bluesky": {
      "url": "https://gateway.pipeworx.io/bluesky/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "bluesky": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/bluesky/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "bluesky": {
      "serverUrl": "https://gateway.pipeworx.io/bluesky/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "bluesky": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/bluesky/mcp"
    }
  }
}
```

## Tools

- `get_profile`: Look up a Bluesky user's profile by handle.
- `get_posts`: Fetch recent posts from a Bluesky user's timeline.
- `search_posts`: Search Bluesky posts by keyword or phrase; requires bsky credentials in the gateway URL.
- `get_feed`: Get posts from a Bluesky feed.
- `get_followers`: Get a user's followers by handle.
- `get_follows`: Get accounts a Bluesky user follows by handle.
- `get_thread`: Fetch a post thread by URI.
- `resolve_handle`: Convert a Bluesky handle to its DID.

## FAQ

### Do I need credentials to use it?

No. Public tools work without credentials. Keyword search requires your own Bluesky handle and an app password passed in the gateway URL.

### Is there a free tier?

The pricing page describes an anonymous allowance of 50 tool calls a day and a free registered account with 200 calls a day.

### Is the server open source?

The repository is published on GitHub under the MIT licence, and the npm package runs as a local stdio bridge to the hosted gateway.

### Does the endpoint expose only Bluesky tools?

The README says the endpoint also lists shared Pipeworx meta-tools such as ask_pipeworx alongside the Bluesky tools.

### Is Bluesky free?

Bluesky has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Bluesky to Claude Code?

Run this command in your terminal: claude mcp add --transport http bluesky https://gateway.pipeworx.io/bluesky/mcp

### What are the best alternatives to Bluesky?

The closest alternatives to Bluesky are Bluesky Posts Scraper, No Login Needed, Kizuki Social Monitoring, LowlandData Social and Skyvern.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Bluesky Posts Scraper, No Login Needed](https://ai-powered.com/mcp/bluesky-posts-scraper-no-login-needed): Bluesky Posts Scraper, No Login Needed is a freemium MCP server for web search and scraping.
- [Kizuki Social Monitoring](https://ai-powered.com/mcp/kizuki-social-monitoring): Kizuki Social Monitoring is a freemium MCP server for web search and scraping.
- [LowlandData Social](https://ai-powered.com/mcp/lowlanddata-social): LowlandData Social is a freemium MCP server for web search and scraping.
- [Skyvern](https://ai-powered.com/mcp/skyvern-2): Skyvern is a freemium MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/bluesky
