Awesome MCP › Social & Messaging

laulauland/bluesky-context-server

⭐ 34 TypeScript added to this list on 2025-05-06 repository created 2024-11-29

Bluesky Context Server is a Model Context Protocol server that gives MCP clients such as Claude Desktop read access to a Bluesky account. It runs under Bun or Node.js 22.6.0 and above, and is configured through two environment variables: BLUESKY_IDENTIFIER, the account handle in either plain or at-prefixed form, and BLUESKY_APP_KEY, an app password generated in the Bluesky privacy and security settings rather than the account password itself. Installation is either automatic through Smithery, which writes the client configuration for Claude Desktop, or manual by cloning the repository and pointing the client at the server entry point with the chosen runtime. The server exposes eight tools grouped into three areas. Profile and account tools return the authenticated user's profile data, the accounts they follow and the accounts following them, with optional limit and cursor parameters for pagination up to one hundred items per call. Post and feed tools return the user's own recent posts with engagement data, the personalised timeline and the posts the user has liked, using the same pagination parameters. Search tools accept a required query string and return matching posts across the network or matching user profiles. All responses are plain structured data handed back to the model, so a client can answer questions such as what is in the current feed, who followed recently, or which posts mention a given topic. The README documents troubleshooting for authentication failures, an unresponsive server and file permission problems, and suggests verifying the runtime and starting the server manually to inspect errors. The code is TypeScript, organised as a workspace with a server package. It suits Bluesky users who want an assistant to read and search their account without handing over full account credentials, since an app password can be revoked on its own.

https://github.com/laulauland/bluesky-context-server

mcpblueskyatprotosocialsearchtypescript