BlueSky

BlueSky MCP Server

A Model Context Protocol (MCP) server that provides access to [BlueSky](https://bsky.app) 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 user

`get-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

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.