get-profileLABSCO SUMMARY
Social graph questions answered from the API rather than by scrolling.
Two calls cover the reconnaissance people actually do before engaging with an account: what it says about itself and how big it is, then who it follows — which says more about a corner of the network than a bio does.
What it is
A small server over BlueSky's official API: a user's profile, and the list of accounts they follow.
What you get
- A profile by handle — display name, description, follower, following and post counts
- The accounts a user follows, returned with pagination
- Session handling and authentication managed for you between calls
Requirements
A BlueSky account: your handle and an app password rather than your login password, both set as environment variables. Python, run through uv.
Setup effort
Build from source — git clone https://github.com/berlinbra/BlueSky-MCP.git
USE CASES
01
Sizing up an account before you engage
Read the profile — description, follower and post counts — in one call.
02
Mapping who matters in a niche
Read the following list of an account already in that niche and page through it.
03
Finding accounts worth following
Start from someone whose taste you trust and work through who they follow.
04
Checking a handle is the account you think it is
Pull the profile by handle and compare the description and counts against what you expected.
2 tools
Listed in project docs. Your client may show a different list.
get-followsBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation. Both tools only read; nothing posts, follows, likes or replies. Names use hyphens.
Requires
- Python 3.12 or later
- BLUESKY_APP_PASSWORD in your environment
- BLUESKY_IDENTIFIER in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/berlinbra/BlueSky-MCP.git
cd BlueSky-MCP
uv syncAdd the Claude Desktop configuration below to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%/Claude/claude_desktop_config.json), with your clone path, BlueSky handle and App Password
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"bluesky-mcp": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_BLUE_SKY_MCP>",
"run",
"src/bluesky_mcp/server.py"
],
"env": {
"BLUESKY_IDENTIFIER": "<YOUR_SUBDOMAIN>.handle.bsky.social",
"BLUESKY_APP_PASSWORD": "<YOUR_BLUESKY_APP_PASSWORD>"
}
}
}
}
