# Bluesky Automation MCP for AI Agents MCP

> Bluesky Automation gives your AI client full control over the AT Protocol. You can publish posts with rich formatting, search user profiles to qualify leads, monitor trending topics, or manage community engagement—all from one place.

## Overview
- **Category:** marketing
- **Price:** Free
- **Tags:** bluesky, atproto, social-listening, automation, lead-generation, engagement, quote-post, rich-text, link-cards, trending, mcp

## Description

Manage your presence on Bluesky without logging in and clicking through menus. This MCP connects your account to your AI agent, letting you perform complex social media tasks using the AT Protocol directly through your preferred client. Need to find potential partners? You can search users by keywords and analyze their follower graphs for deep prospect qualification. Want to keep up with industry trends? Your agent monitors trending topics across the network or reads full conversation threads before you reply. It handles everything from drafting posts that automatically include rich links, to monitoring mentions so nothing slips through the cracks. Because this tool connects through Vinkius, your AI client gets access to over 4,000 other MCPs, meaning all your social and operational needs are in one place.

## Tools

### get_notifications
Retrieves notifications, such as mentions and replies, for quick community management.

### follow_user
Adds you to the follower list of a specific Bluesky handle.

### get_timeline
Retrieves the main content feed for your own authenticated user profile.

### like_post
Clicks the like button on a specific Bluesky post using its public URL.

### publish_post
Creates and posts new text content to your Bluesky profile, automatically parsing links and hashtags.

### repost
Shares an existing post from another user onto your own profile.

### delete_post
Removes a post you previously published using its full public URL or AT Protocol URI.

### get_author_feed
Retrieves the entire content feed for any specific Bluesky user handle.

### get_custom_feed
Reads posts generated by a complex, algorithm-based custom feed on Bluesky.

### mute_user
Silences all content from a specific user to keep your personal timeline focused.

### get_trending_topics
Fetches data on what topics are currently generating the most buzz across Bluesky.

### unfollow_user
Removes a specific user from your follow list to curate a cleaner feed.

### get_followers
Gathers a complete list of all users who currently follow the target Bluesky handle.

### get_follows
Gets a list of accounts that the specified Bluesky handle is following.

### get_post_thread
Reads all replies and comments on a post, giving you full context before replying.

### get_profile
Retrieves comprehensive public details about any Bluesky user's profile.

### quote_post
Shares an existing post but includes your own commentary, making it highly visible for thought leadership.

### reply_to_post
Responds directly to a specific user's post on Bluesky.

### search_posts
Searches the entire network for posts matching keywords, sortable by trending or newest activity.

### search_users
Finds specific Bluesky user accounts using various search keywords.

## Prompt Examples

**Prompt:** 
```
Find me 5 top posts about 'WebAssembly' from developer profiles this week.
```

**Response:** 
```
I found five highly engaged posts on WebAssembly: 

*   **@dev.engineer:** (42 Likes, 18 Replies) "WASM is the future of browser performance."
*   **@tech_guru:** (35 Likes, 10 Replies) "Just ran into some WASM memory issues..."

Would you like me to quote any of these posts with commentary for your network?
```

**Prompt:** 
```
Can you check my timeline and tell me if I've been mentioned by anyone in the last 24 hours?
```

**Response:** 
```
**🚨 Notification Summary (Last 24 Hours) 🚨**
*   👤 **@jane_doe**: Mentioned regarding the Q3 report.
*   💬 **@teamlead**: Replied to your post about best practices.

I recommend checking the thread context for @teamlead's reply before you respond. I can also run `get_notifications` for a full list.
```

**Prompt:** 
```
Find me some people interested in sustainable farming and give me their follow lists.
```

**Response:** 
```
Okay, here are three users who fit the 'sustainable agriculture' profile:

1.  **@greenfarm:** (Followers: 9,200)
2.  **@soil_science:** (Followers: 4,500)
3.  **@urban_grower:** (Followers: 1,100)

I've gathered the follow lists for all three. Let me know if you want to target any specific accounts.
```

## Capabilities

### Publishing Rich Content
Create new posts with automatic rich text, clickable links, and link card previews.

### Monitoring Network Activity
Search the entire network for keywords or track real-time trending topics to stay informed about industry conversations.

### Analyzing User Profiles
Retrieve detailed profile information and list of followers/following accounts to qualify specific prospects.

### Managing Engagement Loops
Like, reply to, or quote posts using public URLs to boost thought leadership visibility on the platform.

### Curating Your Timeline
Get your home feed, a specific user's timeline, or custom algorithm feeds for targeted content consumption.

## Use Cases

### Monitoring a Competitor's Buzz
A brand manager needs to know what people are saying about their top three rivals. They ask their agent to run `search_posts` for those keywords, sorting by 'top,' and the system pulls the most engaged discussions from the entire network.

### Building an Early Adopter List
A SaaS founder needs specific developers. They use `search_users` to find profiles matching technical keywords, then run `get_followers` on those accounts to build a qualified list of people interested in their product.

### Keeping up with Niche Trends
A crypto analyst wants to know what's hot right now. They use `get_trending_topics` and then examine the full conversation thread using `get_post_thread` before writing an informed reply.

### Managing a High-Volume Community
A product lead needs to ensure no one is ignored. They set up rules that use `get_notifications` to alert them instantly, and they can manage the conversation by calling `reply_to_post` when necessary.

## Benefits

- Deepen your network presence. Instead of just posting, you can use `quote_post` to add commentary when sharing someone else's work, boosting your thought leadership.
- Find contacts faster. You don't have to manually check profiles; the MCP lets you run `search_users` and analyze their follower graphs immediately.
- Stay on top of conversations. Using `get_notifications` means your agent flags every mention or reply instantly, so you never miss a crucial engagement point.
- Build better content. When drafting posts with `publish_post`, the system automatically handles rich text elements like clickable links and formatted hashtags for maximum visual impact.
- Maintain focus. If your timeline gets noisy, use `mute_user` or `unfollow_user` to keep only the most relevant accounts in your feed.

## How It Works

The bottom line is: it turns complicated social media actions and data retrieval into simple, actionable commands for your AI client.

1. First, navigate to Bluesky Settings > Advanced and create an App Password. You need this secure token.
2. Next, input your Bluesky handle along with that generated App Password into the MCP client settings.
3. Once connected, you can start calling tools like `search_posts` or `get_author_feed` directly from your AI agent.

## Frequently Asked Questions

**How do I create an App Password?**
Log into your Bluesky account on the web or mobile app, navigate to **Settings > Advanced > App Passwords**, and click 'Add App Password'. Name it 'MCP Server' and use the generated password.

**Will my main Bluesky password be safe?**
Yes. This MCP server explicitly requires an App Password, which provides scoped access without exposing your main account credentials. You can revoke this App Password at any time from your Bluesky settings.

**Do links in posts appear clickable?**
Yes. All posts automatically detect URLs, @mentions, and #hashtags and convert them into rich text facets — the AT Protocol standard for clickable elements. Posts with URLs also include a link card preview with the page's title and description.

**Is there a character limit for the posts?**
Yes, Bluesky enforces a strict 300-character limit per post. Your AI agent is instructed to automatically keep all published text within this limit, ensuring your posts are never rejected.