Bluesky Mcp Server
by cyanheadscommunityv0.1.5
An MCP server that provides read-only access to public Bluesky/AT Protocol AppView data. It supports searching posts, profiles, feeds, threads, follows, and trending topics over STDIO or Streamable HTTP, with no authentication required.
From the registry: Search posts, profiles, feeds, threads, and trending topics on Bluesky.
Install & configure
Prerequisites
- requiredInstall Node.js or BunInstall Node.js v24+ or Bun v1.3.0+ to run the server locally. The simplest portable path uses npx, so Node.js is sufficient.https://nodejs.org/
- optionalNo API key requiredThis server uses Bluesky's public AppView and does not require credentials or an account.
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `bluesky-mcp-server` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js or Bun** — Install Node.js v24+ or Bun v1.3.0+ to run the server locally. The simplest portable path uses npx, so Node.js is sufficient. (https://nodejs.org/)
Optional prerequisites:
- No API key required — This server uses Bluesky's public AppView and does not require credentials or an account.
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@cyanheads/bluesky-mcp-server@latest"]
- optional environment variables:
- `MCP_TRANSPORT_TYPE`: Transport mode. Set to stdio for stdio-based MCP clients. (example: `stdio`)
- `MCP_LOG_LEVEL`: Log level (RFC 5424). (example: `info`)
- `MCP_AUTH_MODE`: Authentication mode. (example: `none`)
- `LOGS_DIR`: Directory for log files (Node.js only). (example: `<your-logs-directory>`)
- `STORAGE_PROVIDER_TYPE`: Storage backend type. (example: `in-memory`)
- `OTEL_ENABLED`: Enable OpenTelemetry instrumentation. (example: `false`)
- `MCP_HTTP_PORT`: Port for HTTP transport if you run the server in HTTP mode instead of stdio. (example: `<your-port>`)
Note: Server supports both stdio and Streamable HTTP. The simplest self-hosted config is stdio via npx. A public hosted Streamable HTTP endpoint is also available at https://bluesky.caseyjhand.com/mcp, but canonical config here prefers the portable local stdio path.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Server supports both stdio and Streamable HTTP. The simplest self-hosted config is stdio via npx. A public hosted Streamable HTTP endpoint is also available at https://bluesky.caseyjhand.com/mcp, but canonical config here prefers the portable local stdio path.
Tools (7)
bsky_search_posts
Full-text search across public Bluesky posts with filters for author, language, tags, domain, date range, and sort order.
bsky_get_profile
Fetch a public Bluesky profile by handle or DID and resolve between handle and DID.
bsky_get_author_feed
Get a user's recent posts ordered newest-first, with post-type filtering.
bsky_get_post_thread
Fetch the full conversation thread for a post by AT-URI, including parent chain and reply tree.
bsky_search_actors
Find Bluesky accounts by name or handle fragment.
bsky_get_follows
Fetch paginated followers or following relationships for an account.
bsky_get_trending
Fetch current trending topics on Bluesky with counts, categories, and status.
Prerequisites
- • Node.js v24+
Packages
@cyanheads/bluesky-mcp-server
npmv0.1.5transport: stdio
@cyanheads/bluesky-mcp-server
npmv0.1.5transport: streamable-http
Remote Endpoints
https://bluesky.caseyjhand.com/mcp
type: streamable-http
Details
- Language
- TypeScript
- License
- Apache-2.0
- Released
- Jun 20, 2026
- Last commit
- Jun 20, 2026
- Registry name
- io.github.cyanheads/bluesky-mcp-server