Frequently Asked Questions (FAQ) about Bluesky Social MCP

Q: What is the Bluesky Social MCP?

A: The Bluesky Social MCP (Model Context Protocol) server is a tool available on the UBOS Asset Marketplace that allows you to interact with the Bluesky social network via the atproto protocol. It automates tasks like profile management, posting, and interacting with other users.

Q: What is atproto?

A: Atproto is the decentralized social networking protocol underlying Bluesky. It provides a more open and user-controlled alternative to traditional social media platforms.

Q: Where do I get my Bluesky app password?

A: You can generate an app password from your Bluesky account settings at https://bsky.app/settings/app-passwords.

Q: Why should I pin the version of the MCP server in my configuration?

A: Pinning the version ensures that you have control over when you update to a newer version, giving you time to test and verify compatibility. This is crucial for maintaining stability and security.

Q: What tools are available in the Bluesky Social MCP server?

A: The MCP server includes tools for authentication, profile operations (get profile, follow/unfollow users, mute/unmute users), feed operations (get timeline, get author feed, get post thread), post interactions (like/unlike posts, repost/unrepost), and post creation/management (send text/image/video posts, delete posts).

Q: How do I run the Bluesky Social MCP from a local clone of the repository?

A: You can configure your MCP to run from a local clone by specifying the path to the server.py file in your MCP configuration. An example configuration is provided in the documentation.

Q: How do I install the dependencies for the Bluesky Social MCP?

A: You can install the dependencies by running uv sync in your terminal within the directory of the Bluesky Social MCP.

Q: How do I run the server?

A: You can run the server using the command uv run bluesky-social-mcp.

Q: How can I debug the Bluesky Social MCP with MCP Inspector?

A: Use the command mcp dev server.py or mcp dev server.py --with-editable . to debug the server with MCP Inspector.

Q: How do I run the tests for the Bluesky Social MCP?

A: Ensure you have set the BLUESKY_IDENTIFIER and BLUESKY_APP_PASSWORD environment variables and then run uv run pytest.

Q: What is UBOS?

A: UBOS is a full-stack AI Agent Development Platform focused on bringing AI Agents to every business department. Our platform helps you orchestrate AI Agents, connect them with your enterprise data, build custom AI Agents with your LLM model, and Multi-Agent Systems.