🦋 Model Context Protocol server for Bluesky / AT Protocol — post & read as you, or read anything public with no login (couchsky). 24 tools.
  • TypeScript 100%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
peterlodri-sec 655174996c fix(deps): patch the MCP SDK's transitive audit findings
npm audit fix bumps proxy-addr (critical IP spoofing), hono, qs, and
ip-address to their patched releases — 6 vulnerabilities to 0, no API
change. Rebuilt and re-verified: 24 tools, live reads intact.

💘 Generated with Crush

Assisted-by: Crush:deepseek-v4-flash
2026-10-07 22:21:15 +09:00
.github/workflows ci: add Blacksmith CI (build + test) 2026-07-28 05:59:29 +02:00
assets docs: add SVG hero banner to the README 2026-07-27 04:58:35 +02:00
docs bluesky-mcp — MCP server for Bluesky / AT Protocol (OSS, MIT) 2026-07-27 03:40:26 +02:00
src feat: music.vaked.dev integration module — choreographies, now playing 2026-07-29 06:54:16 +02:00
.env.example bluesky-mcp — MCP server for Bluesky / AT Protocol (OSS, MIT) 2026-07-27 03:40:26 +02:00
.gitignore bluesky-mcp — MCP server for Bluesky / AT Protocol (OSS, MIT) 2026-07-27 03:40:26 +02:00
AGENTS.md bluesky-mcp — MCP server for Bluesky / AT Protocol (OSS, MIT) 2026-07-27 03:40:26 +02:00
LICENSE bluesky-mcp — MCP server for Bluesky / AT Protocol (OSS, MIT) 2026-07-27 03:40:26 +02:00
package-lock.json fix(deps): patch the MCP SDK's transitive audit findings 2026-10-07 22:21:15 +09:00
package.json bluesky-mcp — MCP server for Bluesky / AT Protocol (OSS, MIT) 2026-07-27 03:40:26 +02:00
README.md docs: add SVG hero banner to the README 2026-07-27 04:58:35 +02:00
tsconfig.json bluesky-mcp — MCP server for Bluesky / AT Protocol (OSS, MIT) 2026-07-27 03:40:26 +02:00

bluesky-mcp — a Model Context Protocol server for Bluesky and the AT Protocol

🦋 bluesky-mcp

A Model Context Protocol server for Bluesky / the AT Protocol — give any MCP-capable agent (Claude, etc.) the ability to post, read, and browse Bluesky.

Two access modes, one server:

  • Account tools (bluesky_*) act as your logged-in account — post, reply, like, repost, follow, and read your timeline + notifications. Needs an app password.
  • couchsky tools (couchsky_*) are public, read-only, no login — read any profile, feed, or thread through the public AppView. The read-only "Couch Sky" way; needs no credentials.

24 tools · TypeScript · stdio transport · MIT.

Install

git clone https://github.com/8b-is/bluesky-mcp.git
cd bluesky-mcp
npm install
npm run build

Configure (only for the account tools)

Copy .env.example to .env and fill in an app password (Bluesky → Settings → App Passwords — never your main password):

BLUESKY_IDENTIFIER="your-handle.bsky.social"
BLUESKY_APP_PASSWORD="xxxx-xxxx-xxxx-xxxx"

The server loads .env from its own directory, so it works no matter where your client launches it. The couchsky_* read tools need none of this.

Connect an MCP client

Point your client at the built server (Claude Code, Claude Desktop, etc.):

{
  "mcpServers": {
    "bluesky": {
      "command": "node",
      "args": ["/absolute/path/to/bluesky-mcp/dist/index.js"]
    }
  }
}

Prefer passing secrets through the client? Add an "env": { "BLUESKY_IDENTIFIER": "…", "BLUESKY_APP_PASSWORD": "…" } block instead of a .env. Restart the client to load it.

Tools

Post & act — as you bluesky_post · bluesky_reply · bluesky_like · bluesky_repost · bluesky_follow · bluesky_delete_post

Read — your account bluesky_whoami · bluesky_timeline · bluesky_notifications · bluesky_notification_count · bluesky_get_post · bluesky_get_thread · bluesky_get_author_feed · bluesky_get_likes · bluesky_get_profile · bluesky_search · bluesky_search_actors · bluesky_get_followers · bluesky_get_follows · bluesky_resolve_handle

couchsky — public, read-only, no login couchsky_profile · couchsky_author_feed · couchsky_thread · couchsky_search

The agent-facing guide — when to use which, and posting etiquette — is in AGENTS.md.

Develop

npm run dev      # tsx, live source
npm run build    # tsc → dist/

License

MIT © Peter Lodri · 🜂 ahogy a dolgok vannak