MCP 服务器

Bluesky MCP

MCP server for Bluesky/AT Protocol that enables AI agents to search, post, reply, like, and follow.

README

@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

Go to Bluesky Settings and sign in
Navigate to Privacy and Security > App passwords
Create a new app password
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: