MCP server

Bluesky

io.github.cyanheads/bluesky-mcp-server

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Search Bluesky posts and feeds; read profiles, threads, and trends. STDIO or Streamable HTTP.

Working at last checkAbout 6,077 tokens per request once connected9 tools

Source

https://bluesky.caseyjhand.com/mcp

At a glance

Type: MCP server
Publisher: Not verified
Status: Working at last check
Tools: 9
Token cost: About 6,077 tokens per request
Sets up in: Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok
Last checked: 26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to Cursor Add to VS Code VS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http bluesky-mcp-server https://bluesky.caseyjhand.com/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.bluesky-mcp-server]
url = "https://bluesky.caseyjhand.com/mcp"

Gemini CLI

{"mcpServers":{"bluesky-mcp-server":{"httpUrl":"https://bluesky.caseyjhand.com/mcp"}}}

Cursor

{"mcpServers":{"bluesky-mcp-server":{"url":"https://bluesky.caseyjhand.com/mcp"}}}

VS Code

{"servers":{"bluesky-mcp-server":{"type":"http","url":"https://bluesky.caseyjhand.com/mcp"}}}

Antigravity

agy mcp add bluesky-mcp-server https://bluesky.caseyjhand.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"bluesky-mcp-server","server_url":"https://bluesky.caseyjhand.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"bluesky-mcp-server","server_url":"https://bluesky.caseyjhand.com/mcp"}

Tools

bsky_get_author_feed ~1051 tokens
Get a Bluesky user's recent feed ordered newest-first. Filter by post type: "posts_with_replies" (everything), "posts_no_replies" (excludes replies), "posts_and_author_threads" (posts the author started), "posts_with_media" (the actor's own posts with images or video — no link cards), or "posts_with
bsky_get_feed ~750 tokens
Read the posts a Bluesky feed generator serves, in the order the feed ranks them. Accepts the feed's AT-URI (at://<handle-or-did>/app.bsky.feed.generator/<rkey>) or its bsky.app page (https://bsky.app/profile/<handle-or-did>/feed/<rkey>). Feeds come from the "feedUri" of each bsky_get_trending topic
bsky_get_follows ~721 tokens
Fetch the social graph edges for a Bluesky account — who follows them, or who they follow. Returns paginated actor profiles (handle, DID, displayName, bio, pronouns when set, and Bluesky verification status) plus a summary of the subject account. Follower, following, and post counts and the website
bsky_get_post_quotes ~810 tokens
Read the quote posts behind a Bluesky post's "quoteCount" — the posts that embed it with commentary of their own. Sort latest (default) is newest first; top is descending like count as ordered by Bluesky. On Bluesky this is where much of the reaction to a post lives; bsky_get_post_thread returns rep
bsky_get_post_thread ~1246 tokens
Fetch the conversation for a post by AT-URI — the parent chain upward and the reply tree downward. Enter the thread at any point and traverse the discussion. AT-URIs have the format "at://<handle-or-did>/<collection>/<rkey>" and are returned in the "uri" field of every post the other post-returning
bsky_get_profile ~493 tokens
Fetch a Bluesky actor's public profile by handle (e.g. "bsky.app") or DID (e.g. "did:plc:z72i7hdynmk6r22z27h6tvur"). Returns displayName, handle, DID, bio, pronouns, website, ordered profile links, follower/following/post counts, avatar URL, moderation labels, pinned post AT-URI, and Bluesky verific
bsky_get_trending ~294 tokens
Fetch the current real-time trending topics on Bluesky. Returns topics with display name, Bluesky's one-sentence summary of the story, post count, category (politics, sports, pop-culture, etc.), status, start time, and the representative accounts driving each topic — so "who is talking about this" n
bsky_search_actors ~372 tokens
Find Bluesky accounts by name or handle fragment. Returns ranked profiles with handle, DID, displayName, bio, pronouns when the account set them, and Bluesky verification status — which tells a verified account from a look-alike handle. Follower, following, and post counts and the website are not on
bsky_search_feeds ~340 tokens
Search metadata in the provider’s public feed catalog, without credentials. This searches feed names and descriptions, not post text, and does not enumerate every feed. Returns feeds in provider order with generator AT-URIs and creator identities; pass a feedUri to bsky_get_feed to read its posts. U

Browse

Related MCP servers

HubVibe: Pay-per-Call Agent Tools: Web Search, Email Verify, Contact Screening, Stocks, Crypto, News
Pay-per-call agent tools: web search, email verification, contact screening, stocks, crypto and news
Social Data
Instagram, TikTok, Threads, Bluesky and 8 more: one API, one key, one JSON shape
Post Kit
Posts, video scripts, TikTok slide images, and a launch clip from your page.
Bluesky
Bluesky MCP — wraps the AT Protocol API
Social Media Data API: Posts, Profiles, Comments, Search and Mentions
Social media posts, profiles, comments, search and mentions across 10 platforms. Pay per call (x402)
Hermoso
AI marketing agent and AI ad generator: 1035 tools, usable alone. No markup on models.
TechSnif
Agent-first tech news: ranked story clusters, coverage and discussion links, trends, and events.
Taproot: AT Protocol MCP
Read public AT Protocol profiles, records, threads, backlinks and lexicons. No API key required.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.cyanheads/bluesky-mcp-server.svg)](https://aptlynx.net/servers/io.github.cyanheads/bluesky-mcp-server)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents