API Reference
Complete API reference for the AT Protocol MCP Server, including all tools, resources, and types.
Overview
The AT Protocol MCP Server provides a comprehensive set of tools and resources for interacting with the AT Protocol ecosystem. This reference documentation covers:
- Tools - MCP tools for performing operations
- Resources - MCP resources for accessing data
- Types - TypeScript type definitions
Tools
Tools are the primary way to interact with the AT Protocol through the MCP server. Each tool performs a specific operation and returns structured data.
Core Social Operations
Essential tools for social networking operations:
- create_post - Create new posts with rich text support
- reply_to_post - Reply to existing posts with threading
- like_post - Like a post
- unlike_post - Remove a like from a post
- repost - Repost content with optional quotes
- unrepost - Remove a repost
User Operations
Tools for managing user relationships and profiles:
- follow_user - Follow a user
- unfollow_user - Unfollow a user
- get_user_profile - Retrieve user profile information
Data Retrieval
Tools for searching and retrieving data:
- search_posts - Search for posts and content
- get_timeline - Retrieve personalized timeline
- get_followers - Get follower lists
- get_follows - Get following lists
- get_notifications - Access notification feeds
Content Management
Tools for managing content and media:
- delete_post - Remove posts
- update_profile - Modify profile settings
- upload_image - Upload image content
- upload_video - Upload video content
- create_rich_text_post - Create posts with rich formatting
- generate_link_preview - Generate link preview cards
OAuth Authentication
Tools for OAuth authentication flows:
- start_oauth_flow - Initiate OAuth authentication
- handle_oauth_callback - Complete OAuth flow
- refresh_oauth_tokens - Refresh authentication tokens
- revoke_oauth_tokens - Revoke OAuth tokens
Moderation
Tools for content and user moderation:
- mute_user - Mute a user
- unmute_user - Unmute a user
- block_user - Block a user
- unblock_user - Unblock a user
- report_content - Report content
- report_user - Report a user
Real-time Streaming & Intelligence
Tools for real-time data streams:
- start_streaming - Start real-time data streaming with filtering
- stop_streaming - Stop streaming
- get_streaming_status - Check streaming status
- get_recent_events - Retrieve recent stream events
- monitor_keywords - Monitor firehose for specific keywords in real-time
- track_users - Track activity from specific users in real-time
Advanced Social Features
Tools for advanced social networking:
- create_list - Create user lists
- add_to_list - Add users to lists
- remove_from_list - Remove users from lists
- get_list - Retrieve list information
- get_thread - View post threads
- get_custom_feed - Access custom feeds
Batch Operations
Tools for performing multiple operations at once:
- batch_follow - Follow multiple users at once (up to 25)
- batch_like - Like multiple posts at once (up to 25)
- batch_repost - Repost multiple posts at once (up to 25)
Analytics & Insights
Tools for analyzing engagement and network patterns:
- analyze_engagement - Analyze engagement patterns across posts
- analyze_network - Analyze user's network and connections
- suggest_content_strategy - Get content strategy recommendations based on performance
- find_influential_users - Find influential users in a topic area
Content Discovery
Tools for discovering content and users:
- discover_trending - Discover trending topics and posts
- find_similar_users - Find users similar to a given user
- recommend_content - Get personalized content recommendations
- discover_communities - Discover communities around topics
Composite Operations
Tools that combine multiple operations:
- get_user_summary - Get complete user profile with stats and analysis
- get_post_context - Get post with thread, author, and engagement data
- create_thread - Create multi-post threads in one call
Rich Media
Tools for working with images and media:
- generate_alt_text - Generate descriptive alt text for images
- analyze_image - Analyze image metadata and properties
- extract_media_from_post - Extract all media from posts
Enhanced Moderation
Additional moderation tools:
- analyze_moderation_status - Check moderation status of content
Resources
Resources provide read-only access to AT Protocol data through the MCP protocol:
- Timeline Resource - Current user's timeline feed (requires authentication)
- Profile Resource - Current user's profile information (requires authentication)
- Notifications Resource - Current user's notifications (requires authentication)
- Conversation Context Resource - Tracks conversation state across LLM interactions (always available)
Types
TypeScript type definitions used throughout the server:
- Core Types - Branded types and AT Protocol identifiers
- Configuration Types - Server and authentication configuration
- Parameter Types - Tool parameter schemas
- Error Types - Error classes and handling
- Utility Types - Helper types and interfaces
Authentication
Most tools require authentication. The server supports two authentication methods:
App Passwords (Development)
export ATPROTO_IDENTIFIER="your-handle.bsky.social"
export ATPROTO_PASSWORD="your-app-password"OAuth (Production)
export ATPROTO_CLIENT_ID="your-client-id"
export ATPROTO_CLIENT_SECRET="your-client-secret"Unauthenticated Mode
As of 2025, the AT Protocol API has changed to require authentication for most endpoints. Only the following tools work without authentication:
get_user_profile(ENHANCED mode: provides additional viewer-specific data when authenticated)start_oauth_flowhandle_oauth_callbackrefresh_oauth_tokensrevoke_oauth_tokens
Note: Tools like search_posts, get_followers, get_follows, get_thread, and get_custom_feed now require authentication.
Error Handling
All tools follow consistent error handling patterns. See the Error Handling Guide for details.
Rate Limiting
The server respects AT Protocol rate limits. See the Configuration Guide for rate limiting settings.
Examples
For practical examples of using these tools, see:
- Basic Usage Examples
- Social Operations Examples
- Content Management Examples
- Real-time Data Examples
- Custom Integration Examples