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.

Features

• Human-approved outbox + fleet-PR REST handoff

• Full bluesky_social ops: post, reply, Repost, media, timelines, notifications, webhooks

• Dark 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

Quick start

cd D:\Dev\repos\bluesky-mcp
Copy-Item .env.example .env
# Edit BLUESKY_INSTANCE + BLUESKY_ACCESS_TOKEN
.\start.bat

Dashboard: 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

Ports

MCP tools

Portmanteau bluesky_social — all operations implemented (see docs/TOOLS.md). Also bluesky_help, bluesky_shutdown, show_outbox_card.

Quality

just ci

Private repos: GitHub Actions stay disabled at account level (billing). Workflow file is still required; run just ci locally.

License

MIT (see LICENSE if present)