Skip to main content
Glama

Ariel — Bluesky MCP Server

Ariel is an MCP (Model Context Protocol) server that exposes AT Protocol (Bluesky) operations as tools. It enables AI assistants to read, write, and interact on Bluesky with human-in-the-loop control — nothing posts without explicit action.

Installation

npm install -g @ticktockbent/ariel

Or run directly with npx:

npx @ticktockbent/ariel

Or build from source:

git clone https://github.com/TickTockBent/ariel.git
cd ariel
npm install
npm run build

Related MCP server: bluesky-mcp

Configuration

Environment Variables

Variable

Required

Description

BLUESKY_IDENTIFIER

Yes

Your Bluesky handle or email

BLUESKY_APP_PASSWORD

Yes

A Bluesky app password

BLUESKY_SERVICE_URL

No

PDS URL (default: https://bsky.social)

ARIEL_DATA_DIR

No

Session storage directory (default: ~/.ariel/)

MCP Client Configuration

Add to your MCP client config (e.g. claude_desktop_config.json):

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

Tools

Ariel exposes 33 tools across six categories.

Authentication

  • ariel_auth_status — Check auth state, handle, DID, and rate limits

  • ariel_auth_logout — Log out and clear stored session

Reading

  • ariel_get_timeline — Home timeline

  • ariel_get_author_feed — A user's posts

  • ariel_get_post_thread — Post with thread context

  • ariel_get_posts — Multiple posts by AT URI (max 25)

  • ariel_get_profile — User profile

  • ariel_get_feed — Custom feed generator posts

  • ariel_search_posts — Search posts

  • ariel_search_users — Search users

  • ariel_get_trends — Trending topics

  • ariel_get_saved_feeds — Your saved/pinned feeds

  • ariel_get_list — List metadata and members

  • ariel_get_list_feed — Posts from a list feed

  • ariel_resolve_url — Convert bsky.app URL to AT URI

Writing

  • ariel_create_post — Create a post with auto-detected mentions/links/hashtags

  • ariel_create_thread — Create a multi-post thread

  • ariel_reply — Reply to a post (auto-resolves thread root)

  • ariel_quote_post — Quote-post another post

  • ariel_delete_post — Delete your post

Media

  • ariel_upload_image — Upload an image blob

  • ariel_create_post_with_images — Post with images (max 4)

  • ariel_create_post_with_link_card — Post with Open Graph link card

Social

  • ariel_follow / ariel_unfollow — Follow/unfollow users

  • ariel_get_followers / ariel_get_follows — View follower/following lists

  • ariel_like / ariel_unlike — Like/unlike posts

  • ariel_repost / ariel_unrepost — Repost/remove reposts

  • ariel_mute / ariel_unmute — Mute/unmute users

  • ariel_block / ariel_unblock — Block/unblock users

Notifications

  • ariel_get_notifications — Recent notifications

  • ariel_get_unread_count — Unread notification count

  • ariel_mark_notifications_read — Mark all notifications as read

Resources

Ariel provides three MCP resources with reference material that clients can pull into context:

  • ariel://at-protocol-concepts — DIDs, handles, AT URIs, facets, embeds, and viewer state

  • ariel://tool-conventions — URL acceptance, error format, the format parameter, and viewer state auto-resolution

  • ariel://post-schema — Post record structure, embed types, facet format, and thread mechanics

Prompts

Three built-in prompts for common workflows:

  • summarize-timeline — Fetch your home timeline and produce a thematic summary

  • draft-thread — Research a topic and draft a thread for review before posting

  • review-notifications — Review recent notifications and suggest responses

Development

npm run dev          # Watch mode TypeScript compilation
npm test             # Run tests
npm run build        # Production build
npm start            # Run the server

See CONTRIBUTING.md for development guidelines.

License

MIT

Available Tools

38 tools
ariel_auth_logoutA
Destructive

Log out of Bluesky, clear stored session

Inputs: no named parameters.

ariel_auth_statusA
Read-only

Check Bluesky authentication state, handle, DID, profile info, and rate limits

Inputs: no named parameters.

ariel_blockB

Block a user on Bluesky

Inputs: actor (required).

ariel_create_postB

Create a new post on Bluesky with automatic mention/link/hashtag detection

Inputs: text (required), langs.

ariel_create_post_with_imagesA

Create a post with attached images (max 4 images, max 1MB each)

Inputs: text (required), images (required), langs.

ariel_create_post_with_link_cardA

Create a post with a link card (fetches Open Graph metadata for preview)

Inputs: url (required), text (required), langs.

ariel_create_threadA

Create a thread of multiple posts. Each post is chained as a reply to the previous one.

Inputs: posts (required).

ariel_delete_postA
Destructive

Delete one of your posts

Inputs: uri (required).

ariel_followB

Follow a user on Bluesky

Inputs: actor (required).

ariel_get_author_feedB
Read-only

Get posts from a specific user's feed

Inputs: actor (required), limit, cursor, filter, +1 more.

ariel_get_feedB
Read-only

Get posts from a custom feed (feed generator)

Inputs: feed (required), limit, cursor, format.

ariel_get_followersC
Read-only

Get a user's followers

Inputs: actor (required), limit, cursor.

ariel_get_followsB
Read-only

Get users that a user follows

Inputs: actor (required), limit, cursor.

ariel_get_listA
Read-only

Get a list's metadata and members

Inputs: list (required), limit, cursor.

ariel_get_list_feedB
Read-only

Get posts from a list feed

Inputs: list (required), limit, cursor, format.

ariel_get_notificationsA
Read-only

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

Inputs: limit, cursor, format.

ariel_get_postsA
Read-only

Get multiple posts by their AT URIs (max 25)

Inputs: uris (required), format.

ariel_get_post_threadA
Read-only

Get a post and its thread (parents and replies)

Inputs: uri (required), depth, format, parentHeight.

ariel_get_profileB
Read-only

Get a user's profile information

Inputs: actor (required), format.

ariel_get_saved_feedsB
Read-only

Get the authenticated user's saved and pinned feeds

Inputs: format.

ariel_get_timelineB
Read-only

Get the authenticated user's home timeline. Use mode 'hours' to fetch all posts within a time window.

Inputs: mode, limit, cursor, format.

ariel_get_unread_countA
Read-only

Get the number of unread notifications

Inputs: no named parameters.

ariel_likeB

Like a post

Inputs: uri (required).

ariel_mark_notifications_readA

Mark all notifications as read

Inputs: no named parameters.

ariel_muteB

Mute a user on Bluesky

Inputs: actor (required).

ariel_quote_postA

Create a post that quotes another post

Inputs: text (required), quotedUri (required), langs.

ariel_replyA

Reply to a post. Automatically resolves the thread root for proper threading.

Inputs: text (required), parentUri (required), langs.

ariel_repostC

Repost a post

Inputs: uri (required).

ariel_resolve_urlA
Read-only

Convert a bsky.app URL to an AT URI with metadata

Inputs: url (required).

ariel_search_postsC
Read-only

Search for posts on Bluesky

Inputs: query (required), lang, sort, limit, +5 more.

ariel_search_usersC
Read-only

Search for users on Bluesky

Inputs: query (required), limit, cursor, format.

ariel_unblockB
Destructive

Unblock a user. Automatically resolves the block record from viewer state.

Inputs: actor (required).

ariel_unfollowA
Destructive

Unfollow a user. Automatically resolves the follow record from viewer state.

Inputs: actor (required).

ariel_unlikeA
Destructive

Unlike a post. Accepts the post URI (auto-resolves like record) or like record URI directly.

Inputs: uri (required).

ariel_unmuteA
Destructive

Unmute a user on Bluesky

Inputs: actor (required).

ariel_unrepostA
Destructive

Remove a repost. Accepts the post URI (auto-resolves repost record) or repost record URI directly.

Inputs: uri (required).

ariel_upload_imageA

Upload an image blob to Bluesky. Returns a blob reference for use in post creation.

Inputs: alt (required), mimeType (required), imageData (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 38 tools

    Disambiguation4/5

    Most tools map to a distinct Bluesky action/resource, but there are several similarly named feed retrievers (get_timeline, get_feed, get_author_feed, get_list_feed) and post creation variants that could be confused without close reading of descriptions.

    Naming Consistency4/5

    The set consistently uses an ariel_ prefix with snake_case, mostly following verb_noun (get_timeline, create_post, delete_post). Minor deviations like ariel_auth_status and single-word actions (ariel_reply, ariel_like) keep it from being perfectly uniform, but the pattern is predictable.

    Tool Count2/5

    38 tools is well above the 25+ threshold for a heavy toolset. While the scope is broad, many operations could be consolidated, making the surface larger than necessary for an agent to navigate efficiently.

    Completeness4/5

    The core Bluesky lifecycle is well covered: post creation/reading/deletion, social interactions, search, notifications, and moderation. Gaps such as no login method, no profile editing, and no list/post management are workable but prevent full domain coverage.

    Maintenance

    ActivityInactive
    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
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that connects to Bluesky and provides natural language tools to interact with the ATProtocol, enabling feed fetching, post management, search, and profile analysis.
      32
      MIT