Bluesky MCP
Provides tools for interacting with Bluesky (AT Protocol), enabling AI agents to search posts and users, create, reply, delete, like, repost posts, follow users, get profiles, timelines, threads, notifications, and update profile.
Click on "Deploy 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 MCP Search Bluesky for posts about AI project management"
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.
@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"
}
}
}
}Related MCP server: bluesky-mcp
Tools (15)
Search & Discovery
Tool | Description |
| Search posts by keywords, hashtags, or phrases |
| Search users by name or handle |
| Get a user's recent posts |
| Get your home timeline |
Engagement
Tool | Description |
| Create a new post (max 300 characters, auto-detects links and mentions) |
| Reply to a post |
| Delete a post by AT URI |
| Like a post |
| Repost a post |
| Follow a user by handle |
Profile & Info
Tool | Description |
| Get a user's profile (or your own) |
| Get a specific post with metrics |
| Get a full post thread with replies |
| Get recent notifications (likes, replies, follows, mentions) |
| Update your display name or bio |
Environment Variables
Variable | Required | Description |
| Yes | Your Bluesky handle (e.g. |
| 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 |
| ~300 / 5 min | Soft limit, may vary by account age |
| ~600 / 5 min | |
| ~1,000 / 5 min | |
| ~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
Available Tools
15 toolscreate_postA
Create a new Bluesky post (max 300 chars). URLs and @mentions auto-linked.
Inputs: text (required).
delete_postB
Delete a Bluesky post by AT URI
Inputs: uri (required).
follow_userB
Follow a Bluesky user by handle
Inputs: handle (required).
get_notificationsA
Get recent notifications (likes, replies, follows, mentions)
Inputs: limit.
get_postA
Get a specific Bluesky post by AT URI
Inputs: uri (required).
get_profileA
Get a Bluesky user profile (omit handle for own profile)
Inputs: handle.
get_threadB
Get a post thread with replies
Inputs: uri (required).
get_timelineC
Get your home timeline
Inputs: limit.
get_user_feedA
Get recent posts from a specific user
Inputs: handle (required), limit.
like_postA
Like a Bluesky post (requires URI + CID)
Inputs: cid (required), uri (required).
reply_postA
Reply to a Bluesky post. Requires parent URI + CID (get from search or get_post).
Inputs: text (required), parent_cid (required), parent_uri (required), root_cid, +1 more.
repostA
Repost a Bluesky post (requires URI + CID)
Inputs: cid (required), uri (required).
search_postsA
Search Bluesky posts by keywords, hashtags, or phrases
Inputs: query (required), limit.
search_usersA
Search Bluesky users by name or handle
Inputs: query (required), limit.
update_profileA
Update your Bluesky display name and/or bio
Inputs: description, display_name.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Each tool maps to a distinct resource and action: search, post, reply, like, repost, follow, profile, notifications, and thread retrieval. Even similar tools like get_user_feed and get_timeline are clearly differentiated by 'specific user' vs 'home timeline' in their descriptions.
Most tools follow a consistent verb_noun snake_case pattern such as search_posts, create_post, delete_post, like_post, follow_user, and get_profile. The only minor deviation is 'repost' instead of something like 'repost_post', but this is still readable and predictable.
15 tools is at the upper edge of the ideal range but each tool serves a distinct, useful purpose for a Bluesky client. The count feels well-scoped for covering search, reading, posting, interacting, profiles, and notifications without unnecessary duplication.
Core workflows are covered well: search, create/delete posts, reply, like, repost, follow, profile updates, and notifications. However, there are notable gaps for undo actions—unlike_post, unrepost, and unfollow_user are missing—which leaves interaction workflows incomplete.
Maintenance
Related MCP Connectors
MCP server for AI agents: posts, messages and comments on WhatsApp, Instagram, TikTok and Facebook.
Remote MCP server for The Colony — a social network for AI agents (posts, DMs, search, marketplace).
MCP server for QPost — lets AI agents publish video and image posts to YouTube, TikTok, Instagram.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Related MCP Servers
- AlicenseBqualityDmaintenanceA Model Context Protocol server that enables AI assistants to interact with Bluesky/ATProtocol, providing authentication, timeline access, post creation, and social features like likes and follows.2151MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server for Bluesky that can post on your behalf by using the AT Protocol.7MIT
- AlicenseNot gradedqualityNot gradedmaintenanceMCP server for Bluesky/AT Protocol enabling LLM clients and agents to authenticate, search, post, like, follow, and manage chat on Bluesky.MIT
- AlicenseAqualityCmaintenanceMCP server for Twitter/X enabling AI agents to search, post, reply, and engage with tweets.1415 npm2MIT