A
license-
qualityD
maintenanceA Model Context Protocol (MCP) server for Bluesky that can post on your behalf by using the AT Protocol.
17
7
MIT
bluesky-mcp
by sandraschi
{
"answer": "bluesky-mcp is a Bluesky/AT Proto MCP server that provides a human-approved, dry-run-first outbox client for managing social media content over MCP and REST.\n\n- Compose & publish: Create posts with text and media attachments, reply to existing posts, repost content, and set visibility — all via the bluesky_social portmanteau tool.\n- Human-approved outbox workflow: Enqueue drafts (outbox_enqueue), list/approve pending drafts, and publish — nothing goes live without explicit approval. Includes a rich UI card (show_outbox_card) to visualize the queue.\n- Dry-run default: Operations run in preview mode by default, so you can review actions before they actually post.\n- Timelines & notifications: Pull home timelines and other feeds, plus read Bluesky notifications (mentions, replies, follows, etc.).\n- Webhooks: Inbound webhook support secured by a shared secret for event delivery.\n- Webapp: A full SOTA web interface (Dashboard, Inbox, Outbox, AI-assisted Compose, Chat, Skills, Tools, Settings, Help) served on a companion port.\n- Fleet PR integration: Handoff promotion drafts from fleet-public-relations-mcp through the outbox.\n- Server utilities: bluesky_help for introspection (version, ports, tools, outbox flow), bluesky_shutdown for graceful shutdown, and SQLite-backed stateful storage for the outbox queue and webhook event log.\n- MCP transport: Available via stdio (Claude Desktop / Cursor) or HTTP (127.0.0.1:10760/mcp)."
}
Provides tools for interacting with Bluesky (AT Protocol) to compose and manage posts, replies, reposts, media, timelines, notifications, and webhooks, including a human-approved outbox for promotion drafts.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bluesky-mcppost a hello world message to my timeline"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
bluesky-mcp
Bluesky / AT Proto client — compose, timelines, and a human-approved outbox for promotion drafts from fleet-public-relations-mcp.
v0.1.1 · Ports 10760 / 10761 · Sibling of discord-mcp · ActivityPub sibling mastodon-mcp
FastMCP 3.4+ · full portmanteau (reply/repost/media/webhooks) · SOTA webapp · dry-run default · Windows CI + local
just ci
Bluesky = AT Proto. Not Mastodon / ActivityPub.
Principle
Agents draft. Humans approve. Nothing posts without outbox approve → publish.
Tone: FLEET_PROMOTION.md.
Related MCP server: Bluesky MCP Server
Features
Human-approved outbox + fleet-PR REST handoff
Full
bluesky_socialops: post, reply, Repost, media, timelines, notifications, webhooksDark SOTA webapp: Dashboard, Inbox, Outbox, Compose (AI assist), Chat, Skills, Tools, Settings, Help
Dry-run default; inbound webhooks with shared secret
Ruff + Biome + pytest gate; Windows-only CI workflow
Stack
Layer | Tech |
Backend | FastAPI + FastMCP 3.4 (uvicorn, pydantic v2, httpx) |
Webapp | React 18 + Vite + TailwindCSS + Lucide + Framer Motion + Zustand + TanStack Query |
Storage | SQLite outbox + webhook event log |
Desktop | Tauri 2 (NSIS installer, embedded PyInstaller backend) |
Quality | ruff, biome, pyright, pytest + pytest-cov, Playwright e2e |
Quick start
cd D:\Dev\repos\bluesky-mcp
Copy-Item .env.example .env
# Edit BLUESKY_INSTANCE + BLUESKY_ACCESS_TOKEN
.\start.batDashboard: http://127.0.0.1:10761 · MCP: http://127.0.0.1:10760/mcp
Claude Desktop / Cursor MCP config (stdio):
{
"mcpServers": {
"bluesky-mcp": {
"command": "uv",
"args": ["run", "--directory", "D:\\Dev\\repos\\bluesky-mcp", "python", "-m", "bluesky_mcp"]
}
}
}Documentation
Doc | Contents |
Install paths | |
First-timer: account creation, app passwords, download links, verify | |
Bluesky / AT Proto vs ActivityPub — where this server sits | |
Env vars | |
MCP + REST reference | |
Lint, | |
Symptom → fix | |
Product requirements + roadmap | |
LLM index + full corpus | |
Release history |
Ports
Service | Port |
Backend | 10760 |
Webapp | 10761 |
MCP tools
Portmanteau bluesky_social — all operations implemented (see docs/TOOLS.md). Also bluesky_help, bluesky_shutdown, show_outbox_card.
Quality
just ciPrivate repos: GitHub Actions stay disabled at account level (billing). Workflow file is still required; run just ci locally.
License
MIT (see LICENSE if present)
Maintenance
–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceMCP server for Bluesky/AT Protocol enabling LLM clients and agents to authenticate, search, post, like, follow, and manage chat on Bluesky.121MIT
- FlicenseAqualityBmaintenanceAn MCP server for interacting with the AT Protocol (ATProto) ecosystem, including Bluesky, providing tools for identity, profiles, and social discovery.61
- Alicense-qualityDmaintenanceMCP server for Bluesky/AT Protocol that enables AI agents to search, post, reply, like, and follow.91MIT
Related MCP Connectors
Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
FastMCP server for posting formatted content to X (Twitter) — Tollbooth-monetized, DPYC-native
Mastodon MCP — public Mastodon data via mastodon.social (no auth required)
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/sandraschi/bluesky-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server