@isteam/bluesky-mcp

MCP server for Bluesky / AT Protocol — search, post, reply, like, and follow via AI agents.

Built by is.team — the AI-native project management platform.

Quick Start

Add to your MCP config (.mcp.json for Claude Code, or Claude Desktop settings):

{
  "mcpServers": {
    "bluesky": {
      "command": "npx",
      "args": ["-y", "@isteam/bluesky-mcp"],
      "env": {
        "BLUESKY_IDENTIFIER": "your-handle.bsky.social",
        "BLUESKY_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

Tools (15)

Search & Discovery

| Tool | Description | |------|-------------| | search_posts | Search posts by keywords, hashtags, or phrases | | search_users | Search users by name or handle | | get_user_feed | Get a user's recent posts | | get_timeline | Get your home timeline |

Engagement

| Tool | Description | |------|-------------| | create_post | Create a new post (max 300 characters, auto-detects links and mentions) | | reply_post | Reply to a post | | delete_post | Delete a post by AT URI | | like_post | Like a post | | repost | Repost a post | | follow_user | Follow a user by handle |

Profile & Info

| Tool | Description | |------|-------------| | get_profile | Get a user's profile (or your own) | | get_post | Get a specific post with metrics | | get_thread | Get a full post thread with replies | | get_notifications | Get recent notifications (likes, replies, follows, mentions) | | update_profile | Update your display name or bio |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | BLUESKY_IDENTIFIER | Yes | Your Bluesky handle (e.g. you.bsky.social) | | BLUESKY_APP_PASSWORD | Yes | App-specific password |

Getting your credentials

1. Go to Bluesky Settings and sign in
2. Navigate to Privacy and Security > App passwords
3. Create a new app password
4. Use your full handle (e.g. yourname.bsky.social) as the identifier

Rate Limits & Agent Safety

Bluesky / AT Protocol enforces soft rate limits per 5-minute window:

| Endpoint | Limit | Notes | |----------|-------|-------| | createRecord (post, reply, like, repost) | ~300 / 5 min | Soft limit, may vary by account age | | searchPosts | ~600 / 5 min | | | getTimeline | ~1,000 / 5 min | | | getProfile | ~1,000 / 5 min | | | General per-account | ~2,000–5,000 / 5 min | Depends on account reputation |

Idempotency note: Bluesky does not deduplicate identical posts. Posting the same text twice creates two records. If your agent retries on timeout, use get_user_feed to check whether the post already exists before retrying.

Token refresh: The server automatically refreshes expired sessions (401/ExpiredToken) — no manual intervention needed.

Usage Examples

Engage with your community:

"Search Bluesky for posts about 'AI project management' and like the most relevant ones"

Post an update:

"Post on Bluesky: We just launched real-time AI collaboration on is.team! Your AI teammates can now join standups."

Monitor your feed:

"Check my Bluesky notifications and reply to any mentions"

About is.team

is.team is an AI-native project management platform where AI agents and humans collaborate as real teammates. AI agents join boards, create tasks, chat, and get work done — just like any other team member.

Part of the is.team open-source MCP ecosystem:

• @isteam/mcp — Project management
• @isteam/google-ads-mcp — Google Ads
• @isteam/twitter-mcp — Twitter/X
• @isteam/bluesky-mcp — Bluesky
• @isteam/linkedin-mcp — LinkedIn

License

MIT