Bluesky MCP Server
by MCP-Mirror
A Model Context Protocol (MCP) server that connects to Bluesky and provides tools to interact with the ATProtocol. It allows users to bring context from Bluesky API endpoints into LLM-based applications.
Last updated: N/A
What is Bluesky MCP Server?
This is a Model Context Protocol (MCP) server designed to interface with the Bluesky social network via the ATProtocol. It provides a set of tools that allow Large Language Models (LLMs) to access and utilize data from Bluesky, enabling natural language interactions with the platform.
How to use Bluesky MCP Server?
First, clone the repository and install the dependencies using pnpm install and build the project using pnpm run build. Then, configure your MCP client (e.g., Claude Desktop) with the server's command and environment variables (BLUESKY_IDENTIFIER, BLUESKY_APP_PASSWORD, BLUESKY_SERVICE_URL). You can also test the tools using MCP Inspector.
Key features of Bluesky MCP Server
Interact with Bluesky via natural language
Fetch and analyze feeds
Fetch and analyze lists of followers
Use an LLM to write and post to Bluesky
Search for feeds, posts, and people
Use cases of Bluesky MCP Server
Using natural language to get recent posts from a specific user
Finding and summarizing feeds about a specific topic
Analyzing the types of accounts a user follows
Automating the creation and posting of content to Bluesky
Searching for and summarizing posts about a specific event
FAQ from Bluesky MCP Server
What is an App Password and why do I need it?
What is an App Password and why do I need it?
An App Password is a unique password generated specifically for third-party applications to access your Bluesky account without exposing your main password. You need it to authenticate the MCP server with Bluesky.
How do I create an App Password?
How do I create an App Password?
Log in to Bluesky, go to Settings > App Passwords, and create a new app password specifically for this integration.
What environment variables do I need to set?
What environment variables do I need to set?
You need to set BLUESKY_IDENTIFIER (your Bluesky handle), BLUESKY_APP_PASSWORD (the app password you created), and BLUESKY_SERVICE_URL (https://bsky.social).
Where does the server store my session information?
Where does the server store my session information?
The server stores your session information in memory only and does not share it with the MCP client.
What tools are available?
What tools are available?
The server provides tools such as get-pinned-feeds, get-timeline-posts, get-feed-posts, get-list-posts, get-user-posts, get-profile, get-follows, get-liked-posts, get-trends, search-posts, search-people, search-feeds, like-post, create-post, and follow-user.