# bluesky-mcp-server

Gives an agent access to Bluesky profiles, posts, feeds, threads, and trends. It can read public content without an account.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1128 installs · ★ 3 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/bluesky-mcp-server
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/bluesky-mcp-server

## What it does

bluesky-mcp-server connects Bluesky to an MCP-capable coding agent. It can find accounts and posts, load profiles, read author and custom feeds, inspect reply threads and quotes, check follow relationships, and report trending topics. Handles and DIDs identify profiles; posts and feeds can be passed as Bluesky URLs or AT-URIs.

Public reading works without signing in. Full-text post search is exposed only when `BLUESKY_IDENTIFIER` and `BLUESKY_APP_PASSWORD` are configured, since Bluesky requires an authenticated account for that operation. Without those variables, the post-search tool is not registered.

Claude Code uses a remote HTTP connection. Codex, Cursor, GitHub Copilot, and Gemini CLI can use the same hosted endpoint with their own configuration format.

## Requirements
- Remote server: `https://bluesky-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http bluesky-mcp-server https://bluesky-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add bluesky-mcp-server --url https://bluesky-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bluesky-mcp-server": {
            "url": "https://bluesky-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bluesky-mcp-server": {
            "type": "http",
            "url": "https://bluesky-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http bluesky-mcp-server https://bluesky-mcp-server--cyanheads.run.tools
```

## When to use it
- search Bluesky posts by author, language, tag, or domain
- look up a profile from a handle or DID
- trace replies around a post
- read an author or custom feed
- check live trending topics and their related feeds

## Example prompts
- Search Bluesky for posts by `@handle` about React.
- Open this Bluesky profile and summarize the author’s latest posts.
- Read the thread at this post URL and list the current trending topics.

## Similar
- [bluesky](https://affpapa.org/en/nevibecode/skills/bluesky.md) — skill · 467 installs
- [bluesky-post](https://affpapa.org/en/nevibecode/skills/bluesky-post.md) — skill · ★ 71 repo stars
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [freeq](https://affpapa.org/en/nevibecode/mcp/freeq.md) — MCP server · ★ 92 repo stars
- [share-of-voice-tracker](https://affpapa.org/en/nevibecode/skills/share-of-voice-tracker.md) — skill · 1100 installs
- [nimistu](https://affpapa.org/en/nevibecode/mcp/nimistu.md) — MCP server · 1596 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
