Ariel
Provides tools for interacting with the AT Protocol (Bluesky), enabling AI assistants to read, write, and interact on Bluesky with human-in-the-loop control. Includes authentication, posting, thread creation, replying, quoting, media uploads, social actions (follow, like, repost), and notification management.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Ariel Show my Bluesky home timeline"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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/arielOr run directly with npx:
npx @ticktockbent/arielOr build from source:
git clone https://github.com/TickTockBent/ariel.git
cd ariel
npm install
npm run buildRelated MCP server: bluesky-mcp
Configuration
Environment Variables
Variable | Required | Description |
| Yes | Your Bluesky handle or email |
| Yes | A Bluesky app password |
| No | PDS URL (default: |
| No | Session storage directory (default: |
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 limitsariel_auth_logout— Log out and clear stored session
Reading
ariel_get_timeline— Home timelineariel_get_author_feed— A user's postsariel_get_post_thread— Post with thread contextariel_get_posts— Multiple posts by AT URI (max 25)ariel_get_profile— User profileariel_get_feed— Custom feed generator postsariel_search_posts— Search postsariel_search_users— Search usersariel_get_trends— Trending topicsariel_get_saved_feeds— Your saved/pinned feedsariel_get_list— List metadata and membersariel_get_list_feed— Posts from a list feedariel_resolve_url— Convert bsky.app URL to AT URI
Writing
ariel_create_post— Create a post with auto-detected mentions/links/hashtagsariel_create_thread— Create a multi-post threadariel_reply— Reply to a post (auto-resolves thread root)ariel_quote_post— Quote-post another postariel_delete_post— Delete your post
Media
ariel_upload_image— Upload an image blobariel_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 usersariel_get_followers/ariel_get_follows— View follower/following listsariel_like/ariel_unlike— Like/unlike postsariel_repost/ariel_unrepost— Repost/remove repostsariel_mute/ariel_unmute— Mute/unmute usersariel_block/ariel_unblock— Block/unblock users
Notifications
ariel_get_notifications— Recent notificationsariel_get_unread_count— Unread notification countariel_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 stateariel://tool-conventions— URL acceptance, error format, theformatparameter, and viewer state auto-resolutionariel://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 summarydraft-thread— Research a topic and draft a thread for review before postingreview-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 serverSee CONTRIBUTING.md for development guidelines.
License
Available Tools
38 toolsariel_auth_logoutADestructive
Log out of Bluesky, clear stored session
Inputs: no named parameters.
ariel_auth_statusARead-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_postADestructive
Delete one of your posts
Inputs: uri (required).
ariel_followB
Follow a user on Bluesky
Inputs: actor (required).
ariel_get_author_feedBRead-only
Get posts from a specific user's feed
Inputs: actor (required), limit, cursor, filter, +1 more.
ariel_get_feedBRead-only
Get posts from a custom feed (feed generator)
Inputs: feed (required), limit, cursor, format.
ariel_get_followersCRead-only
Get a user's followers
Inputs: actor (required), limit, cursor.
ariel_get_followsBRead-only
Get users that a user follows
Inputs: actor (required), limit, cursor.
ariel_get_listARead-only
Get a list's metadata and members
Inputs: list (required), limit, cursor.
ariel_get_list_feedBRead-only
Get posts from a list feed
Inputs: list (required), limit, cursor, format.
ariel_get_notificationsARead-only
Get recent notifications (likes, reposts, follows, mentions, replies)
Inputs: limit, cursor, format.
ariel_get_postsARead-only
Get multiple posts by their AT URIs (max 25)
Inputs: uris (required), format.
ariel_get_post_threadARead-only
Get a post and its thread (parents and replies)
Inputs: uri (required), depth, format, parentHeight.
ariel_get_profileBRead-only
Get a user's profile information
Inputs: actor (required), format.
ariel_get_saved_feedsBRead-only
Get the authenticated user's saved and pinned feeds
Inputs: format.
ariel_get_timelineBRead-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_trendsARead-only
Get trending topics on Bluesky (uses unspecced endpoint — may change)
Inputs: limit, format.
ariel_get_unread_countARead-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_urlARead-only
Convert a bsky.app URL to an AT URI with metadata
Inputs: url (required).
ariel_search_postsCRead-only
Search for posts on Bluesky
Inputs: query (required), lang, sort, limit, +5 more.
ariel_search_usersCRead-only
Search for users on Bluesky
Inputs: query (required), limit, cursor, format.
ariel_unblockBDestructive
Unblock a user. Automatically resolves the block record from viewer state.
Inputs: actor (required).
ariel_unfollowADestructive
Unfollow a user. Automatically resolves the follow record from viewer state.
Inputs: actor (required).
ariel_unlikeADestructive
Unlike a post. Accepts the post URI (auto-resolves like record) or like record URI directly.
Inputs: uri (required).
ariel_unmuteADestructive
Unmute a user on Bluesky
Inputs: actor (required).
ariel_unrepostADestructive
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
Scored across 38 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server for AI agents: posts, messages and comments on WhatsApp, Instagram, TikTok and Facebook.
Bluesky posts, profiles, feeds, threads & Substack newsletter search and publication feed MCP API.
Related MCP Servers
- AlicenseBqualityDmaintenanceA 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.2151MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server for Bluesky that can post on your behalf by using the AT Protocol.7MIT
- AlicenseNot gradedqualityNot gradedmaintenanceMCP server for Bluesky/AT Protocol enabling LLM clients and agents to authenticate, search, post, like, follow, and manage chat on Bluesky.MIT
- AlicenseBqualityDmaintenanceA 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.32MIT