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
claude mcp add --transport http bluesky-mcp-server https://bluesky-mcp-server--cyanheads.run.toolsWhat 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
@handleabout 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.toolsPlatform CLI: remote server
codex mcp add bluesky-mcp-server --url https://bluesky-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"bluesky-mcp-server": {
"url": "https://bluesky-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"bluesky-mcp-server": {
"type": "http",
"url": "https://bluesky-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http bluesky-mcp-server https://bluesky-mcp-server--cyanheads.run.toolsStep 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.