mcp -bluesky

This MCP server provides a set of Bluesky utilities that interface with Bluesky accounts. Once started, you can authenticate using a Bluesky username and password, with the optional Bluesky PDS URL to point at a specific Bluesky data service endpoint. The server exposes a collection of tools for common Bluesky actions, including retrieving profiles, managing follows, posting and interacting with content, and retrieving timelines and threads. Tools are invoked by their names (e.g., bluesky_get_profile, bluesky_post, bluesky_like) through the MCP interface to perform the corresponding Bluesky operations without needing to interact with the Bluesky UI directly.

Prerequisites:

• Node.js (and npm or corepack) installed on your machine.
• Internet access to fetch the MCP server package from npm.

1. Ensure Node.js and npm are installed. Verify with: node -v npm -v

2. Install and run the MCP server using npx (as configured in the README): npx -y mcp-server-bluesky

3. Set up environment variables for Bluesky authentication (either in the MCP config as shown or in your environment):

   • BLUESKY_USERNAME: your Bluesky username
   • BLUESKY_PASSWORD: your Bluesky password
   • BLUESKY_PDS_URL: Bluesky PDS URL (optional; defaults to https://bsky.social if omitted)

4. When the server starts, it will be ready to accept MCP tool calls such as bluesky_get_profile, bluesky_post, bluesky_like, bluesky_get_timeline, etc.

Notes and tips:

• BLUESKY_PDS_URL is optional; if not provided, the server defaults to https://bsky.social.
• Ensure your Bluesky credentials are kept secure and not committed to version control.
• If you encounter authentication errors, verify that your Bluesky username and password are correct and that the PDS URL is accessible from your network.
• Tools available include: 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.