Skip to main content
Glama
Bluesky MCP

Bluesky MCP

by isteamhq

@isteam/bluesky-mcp

npm version License: MIT

MCP server for Bluesky / AT Protocol — search, post, reply, like, and follow via AI agents.

Built by is.team — the AI-native project management platform.

Quick Start

Add to your MCP config (.mcp.json for Claude Code, or Claude Desktop settings):

{
  "mcpServers": {
    "bluesky": {
      "command": "npx",
      "args": ["-y", "@isteam/bluesky-mcp"],
      "env": {
        "BLUESKY_IDENTIFIER": "your-handle.bsky.social",
        "BLUESKY_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

Related MCP server: bluesky-mcp

Tools (15)

Search & Discovery

Tool

Description

search_posts

Search posts by keywords, hashtags, or phrases

search_users

Search users by name or handle

get_user_feed

Get a user's recent posts

get_timeline

Get your home timeline

Engagement

Tool

Description

create_post

Create a new post (max 300 characters, auto-detects links and mentions)

reply_post

Reply to a post

delete_post

Delete a post by AT URI

like_post

Like a post

repost

Repost a post

follow_user

Follow a user by handle

Profile & Info

Tool

Description

get_profile

Get a user's profile (or your own)

get_post

Get a specific post with metrics

get_thread

Get a full post thread with replies

get_notifications

Get recent notifications (likes, replies, follows, mentions)

update_profile

Update your display name or bio

Environment Variables

Variable

Required

Description

BLUESKY_IDENTIFIER

Yes

Your Bluesky handle (e.g. you.bsky.social)

BLUESKY_APP_PASSWORD

Yes

App-specific password

Getting your credentials

  1. Go to Bluesky Settings and sign in

  2. Navigate to Privacy and Security > App passwords

  3. Create a new app password

  4. Use your full handle (e.g. yourname.bsky.social) as the identifier

Rate Limits & Agent Safety

Bluesky / AT Protocol enforces soft rate limits per 5-minute window:

Endpoint

Limit

Notes

createRecord (post, reply, like, repost)

~300 / 5 min

Soft limit, may vary by account age

searchPosts

~600 / 5 min

getTimeline

~1,000 / 5 min

getProfile

~1,000 / 5 min

General per-account

~2,000–5,000 / 5 min

Depends on account reputation

Idempotency note: Bluesky does not deduplicate identical posts. Posting the same text twice creates two records. If your agent retries on timeout, use get_user_feed to check whether the post already exists before retrying.

Token refresh: The server automatically refreshes expired sessions (401/ExpiredToken) — no manual intervention needed.

Usage Examples

Engage with your community:

"Search Bluesky for posts about 'AI project management' and like the most relevant ones"

Post an update:

"Post on Bluesky: We just launched real-time AI collaboration on is.team! Your AI teammates can now join standups."

Monitor your feed:

"Check my Bluesky notifications and reply to any mentions"

About is.team

is.team is an AI-native project management platform where AI agents and humans collaborate as real teammates. AI agents join boards, create tasks, chat, and get work done — just like any other team member.

Part of the is.team open-source MCP ecosystem:

License

MIT

Available Tools

15 tools
create_postA

Create a new Bluesky post (max 300 chars). URLs and @mentions auto-linked.

Inputs: text (required).

delete_postB

Delete a Bluesky post by AT URI

Inputs: uri (required).

follow_userB

Follow a Bluesky user by handle

Inputs: handle (required).

get_notificationsA

Get recent notifications (likes, replies, follows, mentions)

Inputs: limit.

get_postA

Get a specific Bluesky post by AT URI

Inputs: uri (required).

get_profileA

Get a Bluesky user profile (omit handle for own profile)

Inputs: handle.

get_threadB

Get a post thread with replies

Inputs: uri (required).

get_timelineC

Get your home timeline

Inputs: limit.

get_user_feedA

Get recent posts from a specific user

Inputs: handle (required), limit.

like_postA

Like a Bluesky post (requires URI + CID)

Inputs: cid (required), uri (required).

reply_postA

Reply to a Bluesky post. Requires parent URI + CID (get from search or get_post).

Inputs: text (required), parent_cid (required), parent_uri (required), root_cid, +1 more.

repostA

Repost a Bluesky post (requires URI + CID)

Inputs: cid (required), uri (required).

search_postsA

Search Bluesky posts by keywords, hashtags, or phrases

Inputs: query (required), limit.

search_usersA

Search Bluesky users by name or handle

Inputs: query (required), limit.

update_profileA

Update your Bluesky display name and/or bio

Inputs: description, display_name.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 15 tools

    Disambiguation5/5

    Each tool maps to a distinct resource and action: search, post, reply, like, repost, follow, profile, notifications, and thread retrieval. Even similar tools like get_user_feed and get_timeline are clearly differentiated by 'specific user' vs 'home timeline' in their descriptions.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun snake_case pattern such as search_posts, create_post, delete_post, like_post, follow_user, and get_profile. The only minor deviation is 'repost' instead of something like 'repost_post', but this is still readable and predictable.

    Tool Count5/5

    15 tools is at the upper edge of the ideal range but each tool serves a distinct, useful purpose for a Bluesky client. The count feels well-scoped for covering search, reading, posting, interacting, profiles, and notifications without unnecessary duplication.

    Completeness3/5

    Core workflows are covered well: search, create/delete posts, reply, like, repost, follow, profile updates, and notifications. However, there are notable gaps for undo actions—unlike_post, unrepost, and unfollow_user are missing—which leaves interaction workflows incomplete.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI assistants to interact with Bluesky/ATProtocol, providing authentication, timeline access, post creation, and social features like likes and follows.
      21
      51
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server for Bluesky that can post on your behalf by using the AT Protocol.
      7
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      MCP server for Bluesky/AT Protocol enabling LLM clients and agents to authenticate, search, post, like, follow, and manage chat on Bluesky.
      MIT