MCP server
Bluesky MCP Server
Search Bluesky posts and feeds; read profiles, threads, and trends. STDIO or Streamable…
- Pricing
- Open source
- Runs
- Locally or Remotely
- Version
- 0.8.0
- Listing updated
- 4 days ago
About Bluesky MCP Server
Bluesky MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.
Search Bluesky posts and feeds; read profiles, threads, and trends. STDIO or Streamable HTTP.
Install
Run in a terminal
claude mcp add --transport http bluesky-mcp-server https://bluesky.caseyjhand.com/mcpAdd to Settings → Connectors → Add custom connector
https://bluesky.caseyjhand.com/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"bluesky-mcp-server": {
"url": "https://bluesky.caseyjhand.com/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"bluesky-mcp-server": {
"type": "http",
"url": "https://bluesky.caseyjhand.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"bluesky-mcp-server": {
"serverUrl": "https://bluesky.caseyjhand.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"bluesky-mcp-server": {
"type": "http",
"url": "https://bluesky.caseyjhand.com/mcp"
}
}
}Configuration
BLUESKY_CLAMP_READ_LIMITSClamp oversized read limits with a notice; false restores rejection.BLUESKY_IDENTIFIERHandle, DID, or email of the Bluesky account post search runs as. Optional: without it and BLUESKY_APP_PASSWORD, bsky_search_posts is not offered, since Bluesky refuses search without a signed-in account. Use a dedicated account — search leaves out posts from accounts in a block relationship with it.BLUESKY_APP_PASSWORDApp password for BLUESKY_IDENTIFIER (a standard, non-privileged one — Settings → Privacy and security → App passwords). Optional; required together with BLUESKY_IDENTIFIER to enable bsky_search_posts.MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').MCP_TRANSPORT_TYPESelects the HTTP transport.BLUESKY_CLAMP_READ_LIMITSClamp oversized read limits with a notice; false restores rejection.BLUESKY_IDENTIFIERHandle, DID, or email of the Bluesky account post search runs as. Optional: without it and BLUESKY_APP_PASSWORD, bsky_search_posts is not offered, since Bluesky refuses search without a signed-in account. Use a dedicated account — search leaves out posts from accounts in a block relationship with it.BLUESKY_APP_PASSWORDApp password for BLUESKY_IDENTIFIER (a standard, non-privileged one — Settings → Privacy and security → App passwords). Optional; required together with BLUESKY_IDENTIFIER to enable bsky_search_posts.MCP_HTTP_HOSTThe hostname for the HTTP server.MCP_HTTP_PORTThe port to run the HTTP server on.MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
Pricing
Open source
Bluesky MCP Server FAQ
Is Bluesky MCP Server free?
Yes. Bluesky MCP Server is open source, so you can use and self-host it for free.
How do I add Bluesky MCP Server to Claude Code?
Run this command in your terminal: claude mcp add --transport http bluesky-mcp-server https://bluesky.caseyjhand.com/mcp