# Bluesky Social MCP MCP > Bluesky Social MCP gives your AI agent full control over decentralized social media interactions. You can publish posts, manage connections, and monitor activity directly from your workflow without ever leaving your workspace. It handles everything from following accounts to monitoring your timeline. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** microblogging, decentralized-web, at-protocol, social-automation, content-publishing, relationship-intelligence ## Description Tired of manually switching between apps just to post an update or check a mention? This MCP connects your AI agent directly to Bluesky, letting you treat your social presence like another tool in your belt. You can orchestrate complex microblogging workflows with natural conversation. Need to build out your understanding of who's talking about what? Use the discovery tools to pull detailed profile data and analyze follower lists. Want to stay updated on community discussions without missing a beat? Your agent monitors your home timeline for you. Because Vinkius hosts this MCP, you get access to all these functions through one connection point, turning scattered social tasks into simple commands. ## Tools ### create_post Publishes an update directly to your Bluesky profile. ### follow_user Establishes a connection by making you follow another account. ### get_user_posts Lists a collection of posts written by a specific account handle. ### get_profile Retrieves the full details, bio, and metadata for any specified user profile. ### list_popular_feeds Lists various types of custom or popular feed generators available on the platform. ### list_followers Generates a directory listing all the accounts that currently follow your profile. ### list_muted_users Shows a list of accounts you have programmatically muted from your feed. ### list_notifications Fetches all recent activity and alerts directed at your account. ### list_timeline Retrieves a snapshot of your current home feed content. ### mute_user Silences an account, preventing their posts from appearing in your timeline. ### search_profiles Searches the network for users based on keywords or criteria. ### unmute_user Re-enables an account, allowing their posts to appear in your timeline again. ## Prompt Examples **Prompt:** ``` Post to Bluesky: 'Enjoying the new decentralized web experience!' ``` **Response:** ``` Post published successfully! Your update is now live on your Bluesky profile. I've enabled automatic link detection for you. Shall I monitor for any immediate replies? ``` **Prompt:** ``` Show the last 5 posts in my home timeline. ``` **Response:** ``` Retrieving timeline... Your home feed features 5 recent posts, including a tech update from @user1 and several community discussions. Would you like the detailed author metadata for any of these? ``` **Prompt:** ``` Search for users interested in 'MCP Servers' and show their profiles. ``` **Response:** ``` Searching social graph... I found 3 users matching your query, including 'Vinkius' and 2 other tech profiles. I've retrieved their high-fidelity bios and follower counts for you. Shall I follow any of them? ``` ## Capabilities ### Manage Posts and Content Automatically publish posts to your Bluesky profile, detecting links and mentions as you go. ### Analyze User Connections Search for specific accounts or retrieve full profiles, including bios and follower counts. ### Control Your Feed Experience Monitor your home timeline, view notifications, or manage who you follow and mute. ### Track Account Relationships View detailed lists of accounts that follow you or accounts you follow. ## Use Cases ### Monitoring an Industry Trend A researcher needs to know who is talking about decentralized identity. They tell their agent to run `search_profiles` for 'decentralized identity'. The agent finds 10 key accounts, then uses `list_followers` on the top three profiles to map out the immediate network influence. ### Running a Content Campaign A social manager needs to post an announcement and tag several people. They ask their agent to use `create_post`, specifying the content and listing all necessary mentions, ensuring consistency across multiple posts. ### Cleaning Up Your Feed After a week of heavy spamming from one account, you want quiet. You tell your agent to check who is bothering you, use `list_muted_users` to confirm the list, and then run `mute_user` on the source. ### Catching Up After a Break You missed several important discussions. You ask your agent to check your home feed using `list_timeline`, review any recent alerts via `list_notifications`, and then use `get_user_posts` on the most relevant person. ## Benefits - You can publish an update using `create_post` without ever opening the Bluesky app. Just tell your agent what you want to say, and it posts it for you. - Researching a competitor? Use `search_profiles` and then run `get_profile` on them. You instantly get their bios, stats, and follower count—all in one query. - Keep track of everything happening with `list_notifications`. Your agent pulls all the alerts so you don't have to manually check every tab. - Building a clean feed? Use `get_user_posts` for specific content or run `list_popular_feeds` to see what kind of content is trending right now. - Managing your digital space is easy. You can use `mute_user` when you need a break from noise, and then use `unmute_user` when the topic comes back up. ## How It Works The bottom line is you run all your social media tasks through simple conversation with your AI agent. 1. First, connect your Bluesky account to the MCP and retrieve both your Handle (e.g., name.bsky.social) and an App Password from your Bluesky settings. 2. Next, point your AI agent at this MCP via any compatible client like Claude or Cursor. 3. You can then issue commands—like 'Get me a list of users interested in X'—and the tool executes the action on Bluesky. ## Frequently Asked Questions **How do I use the `create_post` tool with this MCP?** You simply tell your agent to 'Create a post saying X.' The MCP takes that request and publishes it directly to your Bluesky profile. It's as simple as talking to it. **Can I use `search_profiles` with this MCP?** Yes, you can search for users by name or keywords within the network. This helps you find specific people you want to monitor or connect with. **What is the difference between `list_timeline` and `get_user_posts`?** `list_timeline` shows your general home feed—what's popular right now. `get_user_posts`, however, gives you a dedicated list of content only from one specific user. **If I mute someone, how do I use the `mute_user` tool?** To use it, just tell your agent to run the `mute_user` tool on that account's handle. You won't see their posts anymore, which can be useful for focus. **What credentials do I need before using `get_profile` with this MCP?** You'll need your Bluesky Handle (e.g., user.bsky.social) and an App Password generated in your account settings. The MCP requires both pieces of info to authorize any action, so make sure they are current. **Does `list_followers` support pagination if a profile has thousands of followers?** Yes, the MCP handles large datasets by supporting paginated calls. You just need to pass the cursor or page number in your request parameters to guarantee you retrieve all available results. **If I use `follow_user` and the target account doesn't exist, what error should I expect?** The MCP returns a specific 404 status code with an explicit message stating that the provided DID was not found. Always run `get_profile` first to verify the user's handle before attempting any action. **When I call `list_notifications`, can I filter the results by type or date range?** Yes, the MCP accepts optional filters. You can narrow down your notifications by specifying types (like 'mention' or 'reply') and setting a specific start and end date for the query. **How do I find my Bluesky Handle and App Password?** Your handle is your username (e.g., name.bsky.social). For the password, go to **Settings** > **App Passwords** in Bluesky and generate a new one. **Can I search for users via AI?** Yes! The `search_profiles` tool allows your agent to find Bluesky users matching a text query programmatically. **How do I check my social notifications?** Use the `list_notifications` tool to retrieve recent likes, reposts, and mentions directly through your AI agent.