Skip to main content
MCP server CX Codex

bluesky-mcp-server — Claude Code MCP server

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

Apache-2.0 1,128 installs ★ 3 updated 2026-10-23

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http bluesky-mcp-server https://bluesky-mcp-server--cyanheads.run.tools
Open on GitHub

What bluesky-mcp-server 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.

What it helps with

  • 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 for the agent

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

How to install bluesky-mcp-server

Platform CLI: remote server

claude mcp add --transport http bluesky-mcp-server https://bluesky-mcp-server--cyanheads.run.tools

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about bluesky-mcp-server

How do I install bluesky-mcp-server in Claude Code?

Run claude mcp add --transport http bluesky-mcp-server https://bluesky-mcp-server--cyanheads.run.tools.

What does bluesky-mcp-server do?

It gives an agent MCP tools for finding accounts and posts, reading profiles and feeds, inspecting threads and quotes, checking follows, and viewing Bluesky trends.

What is required for full-text post search?

Set BLUESKY_IDENTIFIER and BLUESKY_APP_PASSWORD. The post-search tool is omitted until both variables are configured.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open