mcp-server-bluesky

MCP.Pizza Chef: morinokami

mcp-server-bluesky is an MCP server designed to integrate Bluesky social platform functionalities into AI workflows. It provides structured access to Bluesky's API, allowing models to retrieve profiles, manage follows, post content, search posts, and interact with timelines. This server supports authentication via environment variables and offers a comprehensive set of tools for social media automation and analysis within the Bluesky ecosystem. It is ideal for developers building AI agents that need real-time, programmatic access to Bluesky data and actions.

Use This MCP server To

Retrieve user profiles and social data from Bluesky Automate posting and deleting content on Bluesky Manage follows and followers programmatically Search and analyze posts on Bluesky platform Fetch and interact with Bluesky timelines and threads Like, repost, and manage social interactions on Bluesky

README

mcp-server-bluesky

MCP server for Bluesky.

Usage with Claude Desktop

{
  "mcpServers": {
    "bluesky": {
      "command": "npx",
      "args": ["-y", "mcp-server-bluesky"],
      "env": {
        "BLUESKY_USERNAME": "username",
        "BLUESKY_PASSWORD": "password",
        "BLUESKY_PDS_URL": "https://bsky.social"
      }
    }
  }
}

The BLUESKY_PDS_URL is optional and defaults to https://bsky.social if not specified.

Tools

bluesky_get_profile
bluesky_follow
bluesky_delete_follow
bluesky_get_follows
bluesky_get_followers
bluesky_search_posts
bluesky_post
bluesky_delete_post
bluesky_repost
bluesky_delete_repost
bluesky_get_timeline
bluesky_get_post_thread
bluesky_get_likes
bluesky_like
bluesky_delete_like

mcp-server-bluesky FAQ

How do I authenticate the mcp-server-bluesky?

Authentication is done via environment variables BLUESKY_USERNAME and BLUESKY_PASSWORD, with an optional BLUESKY_PDS_URL for the Bluesky server endpoint.

Can I customize the Bluesky server URL?

Yes, by setting the BLUESKY_PDS_URL environment variable; it defaults to https://bsky.social if not specified.

What kind of actions can I perform with mcp-server-bluesky?

You can manage profiles, follows, posts, likes, reposts, and timelines on Bluesky through its exposed tools.

Is mcp-server-bluesky compatible with multiple LLM providers?

Yes, it works with any MCP client and LLM provider such as OpenAI, Claude, and Gemini.

How do I start the mcp-server-bluesky?

Use the command 'npx -y mcp-server-bluesky' with the required environment variables set for username and password.

Does mcp-server-bluesky support real-time updates?

It provides access to current Bluesky data via API calls but does not inherently push real-time updates.

Can I delete posts and follows using this server?

Yes, tools like bluesky_delete_post and bluesky_delete_follow allow you to remove posts and unfollow users.

How do I integrate mcp-server-bluesky with an MCP client?

Configure the MCP client to launch the server with the appropriate command and environment variables as shown in the usage example.