The BlueSky MCP Server allows you to interact with BlueSky social network data through a standardized interface. You can:
- Fetch user profiles and profile information
- Retrieve follows and followers lists
- Get recent posts from users
- Search for posts using query strings
- Get posts liked by users
- Access your personalized BlueSky feed
- Search for user profiles
All list-based operations support pagination.
Provides access to BlueSky social network data through its official API, with tools for retrieving user profiles, following/follower lists, accessing personal feeds, searching posts and profiles, and viewing liked content.
BlueSky MCP Server
A Model Context Protocol (MCP) server that provides access to BlueSky social network data through its official API. This server implements a standardized interface for retrieving user profiles and social graph information.
Features
- Fetch detailed user profile information
- Retrieve user following lists with pagination
- Built-in authentication handling and session management
- Comprehensive error handling
Installation
Claude Desktop
- On MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.json
- On Windows:
%APPDATA%/Claude/claude_desktop_config.json
Running Locally
Install Libraries
Running
After connecting Claude client with the MCP tool via json file and installing the packages, Claude should see the server's mcp tools:
You can run the sever yourself via: In bluesky_mcp repo:
*if you want to run the server inspector along with the server:
Available Tools
The server implements two tools:
get-profile
: Get detailed profile information for a BlueSky userget-follows
: Get a list of accounts that a specified user follows
get-profile
Retrieves detailed profile information for a given BlueSky user.
Input Schema:
Example Response:
get-follows
Retrieves a list of accounts that a specified user follows, with support for pagination.
Input Schema:
Example Response:
Error Handling
The server includes comprehensive error handling for various scenarios:
- Authentication failures
- Rate limiting
- Network connectivity issues
- Invalid parameters
- Timeout handling
- Malformed responses
Error messages are returned in a clear, human-readable format.
Prerequisites
- Python 3.12 or higher
- httpx
- mcp
Authentication
To use this MCP server, you need to:
- Create a BlueSky account if you don't have one
- Generate an App Password in your BlueSky account settings
- Set the following environment variables:
BLUESKY_IDENTIFIER
: Your BlueSky handle (e.g., "username.bsky.social")BLUESKY_APP_PASSWORD
: Your generated App Password
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
Facilitates interaction with the BlueSky social network via its official API, allowing users to retrieve detailed user profiles and following lists with authentication and error handling capabilities.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityEnables interaction with Spotify's music catalog via the Spotify Web API, supporting searches, artist information retrieval, playlist management, and automatic token handling.Last updated -2654712TypeScriptMIT License
- AsecurityAlicenseAqualityEnables interaction with Slack workspaces as a user, supporting channel listing, message posting, threading, reactions, and user management via the Slack API.Last updated -87JavaScriptMIT License
- AsecurityFlicenseAqualityEnables interaction with the Twitch API, allowing users to retrieve comprehensive information about channels, streams, games, and more, with additional support for searching and accessing chat elements like emotes and badges.Last updated -14161TypeScript
- AsecurityFlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with Bluesky/ATProtocol, providing authentication, timeline access, post creation, and social features like likes and follows.Last updated -1827TypeScript