AT Protocol MCP Server

Appearance

AT Protocol MCP ServerComprehensive LLM Integration

Enable LLMs to interact directly with the AT Protocol ecosystem through a powerful Model Context Protocol server

Get Started
View on GitHub
AT Protocol MCP Server Logo

Complete AT Protocol Integration

Full implementation using official @atproto/api with support for all major AT Protocol operations including posts, follows, likes, and real-time data streams.

MCP Server Compliance

Built with @modelcontextprotocol/sdk following the official MCP specification, ensuring compatibility with all MCP-compatible LLM clients.

Type-Safe & Secure

Written in TypeScript with strict type checking, comprehensive input validation, and secure authentication flows for production use.

Batch Operations (New!)

Perform multiple operations in a single call - follow, like, or repost up to 25 items at once to reduce round-trips and improve efficiency.

Analytics & Insights (New!)

Analyze engagement patterns, network connections, and get AI-powered content strategy recommendations based on your performance data.

Content Discovery (New!)

Find similar users, trending topics, and influential voices in your areas of interest with intelligent discovery algorithms.

Conversation Context (New!)

Track conversation state across LLM interactions including discussed posts, active threads, and mentioned users for better context awareness.

High Performance

Optimized for performance with connection pooling, intelligent caching, rate limiting, and efficient data processing pipelines.

Extensible Architecture

Modular design allows easy customization and extension with custom tools, resources, and prompts for specific use cases.

Comprehensive Documentation

Detailed documentation with examples, API reference, troubleshooting guides, and best practices for integration.

What's New in v0.1.1 ​

The latest release brings powerful new capabilities to enhance your AT Protocol integration:

Batch Operations

Perform multiple operations in a single call! Follow, like, or repost up to 25 items at once to reduce API round-trips and improve efficiency.

Analytics & Insights

Get AI-powered insights into your engagement patterns, network connections, and content strategy with new analytics tools.

Content Discovery

Discover similar users, trending topics, and influential voices in your areas of interest with intelligent discovery algorithms.

Conversation Context

New conversation context resource tracks discussed posts, active threads, and mentioned users across LLM interactions for better context awareness.

Quick Start ​

Get up and running with the AT Protocol MCP Server in minutes:

bash
# Install globally
npm install -g atproto-mcp

# Start the server
atproto-mcp

# Or use with npx
npx atproto-mcp

Key Features ​

Social Operations ​

  • Create posts with rich text, images, and embeds
  • Reply to posts with proper threading
  • Like, repost, and manage reactions
  • Follow and unfollow users
  • Access timelines and feeds

Data Retrieval ​

  • Search posts and content across the network
  • Retrieve user profiles and information
  • Access follower and following lists
  • Get real-time notifications
  • Stream live data updates

Authentication ​

  • Secure OAuth flow implementation
  • App password support for development
  • Session management and token refresh
  • Multi-account support

Developer Experience ​

  • TypeScript with full type safety
  • Comprehensive error handling
  • Detailed logging and monitoring
  • Hot reloading for development
  • Extensive test coverage

Architecture ​

The AT Protocol MCP Server bridges the gap between LLMs and the AT Protocol ecosystem:

Use Cases ​

This MCP server enables LLMs to provide powerful AT Protocol capabilities through natural language interaction:

  • LLM-Powered Social Automation: Enable AI assistants to manage posting, engagement, and content on behalf of users through conversational commands
  • AI-Driven Content Analysis: Allow LLMs to analyze social media trends and user behavior through natural language queries and provide insights
  • Intelligent Community Management: Empower LLMs to help users manage communities, moderate content, and engage with followers
  • Conversational Data Integration: Let LLMs integrate AT Protocol data with other systems through natural language workflows
  • AI-Assisted Research & Analytics: Enable LLMs to conduct social media research and analytics by querying and processing AT Protocol data
  • Smart Bot Development: Build intelligent social media bots where LLMs handle natural language understanding and this server handles AT Protocol actions

How it works: Users interact with their LLM client (like Claude Desktop) in natural language, and the LLM uses this MCP server to access AT Protocol functionality. For example, a user might say "Search for trending posts about AI and summarize them," and the LLM would use the search_posts tool to fulfill that request.

Community ​

Join our growing community of developers building with the AT Protocol:

License ​

Released under the MIT License.

Made with ❤️ by Cameron Rye