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

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

Ariel