BlueSky

by berlinbra

9 stars
Not rated
GitHub

About

Integrates with BlueSky's API to retrieve user profiles and social graph data, enabling user analysis, network visualization, and content discovery.

Details

Author
berlinbra
GitHub stars
9
Categories
Communication, Other, Productivity, Developer Tools, Design, File Management, AI, Community, Search, API, Knowledge Base, Frontend, Infrastructure

- Fetch detailed user profile information
- Retrieve user following lists with pagination
- Built-in authentication handling and session management
- Comprehensive error handling

uv pip install -e .

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:

uv run src/bluesky_mcp/server.py

*if you want to run the server inspector along with the server:

npx @modelcontextprotocol/inspector uv --directory C:\\Users\\{INSERT_USER}\\YOUR\\PATH\\TO\\bluesky-mcp run src/bluesky_mcp/server.py

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

A Model Context Protocol (MCP) server that provides access toBlueSkysocial network data through its official API. This server implements a standardized interface for retrieving user profiles and social graph information.

- Fetch detailed user profile information
- Retrieve user following lists with pagination
- Built-in authentication handling and session management
- Comprehensive error handling

- On MacOS:~/Library/Application\ Support/Claude/claude_desktop_config.json
- On Windows:%APPDATA%/Claude/claude_desktop_config.json

"mcpServers": { "bluesky-mcp": { "command": "uv", "args": [ "--directory", "C:\\Users\\{INSERT_USER}\\YOUR\\PATH\\TO\\bluesky-mcp\\bluesky-mcp", "run", "src/bluesky_mcp/server.py" ], "env": { "BLUESKY_IDENTIFIER": "your.handle.bsky.social", "BLUESKY_APP_PASSWORD": "your-app-password" } } }

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:

npx @modelcontextprotocol/inspector uv --directory C:\\Users\\{INSERT_USER}\\YOUR\\PATH\\TO\\bluesky-mcp run src/bluesky_mcp/server.py

- get-profile: Get detailed profile information for a BlueSky user
- get-follows: Get a list of accounts that a specified user follows

Retrieves detailed profile information for a given BlueSky user.

{ "handle": { "type": "string", "description": "The user's handle (e.g., 'alice.bsky.social')" } }
Profile information for alice.bsky.social: Handle: alice.bsky.social Display Name: Alice Description: Just a BlueSky user sharing thoughts Followers: 1234 Following: 567 Posts: 789

Retrieves a list of accounts that a specified user follows, with support for pagination.

{ "actor": { "type": "string", "description": "The user's handle (e.g., 'alice.bsky.social')" }, "limit": { "type": "integer", "description": "Maximum number of results to return", "default": 50, "minimum": 1, "maximum": 100 }, "cursor": { "type": "string", "description": "Pagination cursor", "optional": true } }
Follows for alice.bsky.social: Follows: Handle: bob.bsky.social Display Name: Bob --- Handle: carol.bsky.social Display Name: Carol --- Handle: dave.bsky.social Display Name: Dave --- More results available. Use cursor: bafygeia...

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.
- 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

Contributions are welcome! Please feel free to submit a Pull Request.

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.

AI-powered social media posting across 14 platforms with per-platform content adaptation, scheduling, and 30-day calendar generation

Publish to multiple social networks with only one MCP

Schedule and queue text, image, and video posts to many social networks, including LinkedIn, X, Bluesky, Instagram, Facebook, Threads, Tiktok.

An MCP server to connect and interact with all your social media

Check brand name availability across domains, social handles, trademarks, app stores, and SaaS channels

Groniz — Social Media Connector for AI Agents

Groniz is a remote MCP server that lets AI agents publish and schedule social content across 32+ networks, including X, Instagram, LinkedIn, Facebook, Threads, TikTok, YouTube, Reddit, Pinterest, Bluesky, Mastodon, Telegram, and Discord. It provides a unified interface for managing connected accounts, authentication, platform-specific formatting, and content delivery.

Social media scheduler for AI agents: draft posts into a human-approved queue, then publish to 15 networks.

An automated tool for searching and commenting on the social media platform Xiaohongshu (Rednote) using Playwright.

Bulk publish to multiple social media at once.

Publish, schedule, and manage social media across 11 platforms with media uploads and analytics tracking.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.