# AT Protocol MCP Server

> A comprehensive Model Context Protocol (MCP) server for AT Protocol integration, enabling LLMs to interact directly with the AT Protocol ecosystem including Bluesky and other decentralized social networks.

This MCP server provides a bridge between Large Language Models and the AT Protocol, allowing LLMs to perform social operations, retrieve data, and manage content on the decentralized social web. It exposes 51 tools, 3 resources plus 2 parameterized resource templates, and 2 prompts, and declares the completions capability. The default transport is stdio; --transport http serves the MCP Streamable HTTP transport at /mcp instead.

Key capabilities:
- Full AT Protocol integration using official @atproto/api
- MCP-compliant server implementation with @modelcontextprotocol/sdk
- Type-safe TypeScript implementation with comprehensive validation
- App password authentication (supported); OAuth login is planned but not yet functional
- Extensive social operations (posts, likes, reposts, follows, reply/quote controls)
- Bluesky direct messages, private bookmarks, and starter pack discovery
- Content management (images, videos, rich text)
- User profile, timeline, and notification access
- Real-time firehose streaming is not exposed and not planned as tools (the unused firehose client code was removed — see Experimental & Roadmap)

## Getting Started

- [Installation Guide](https://cameronrye.github.io/atproto-mcp/guide/installation.html): How to install and set up the MCP server
- [Quick Start](https://cameronrye.github.io/atproto-mcp/guide/getting-started.html): Get up and running in minutes
- [Configuration](https://cameronrye.github.io/atproto-mcp/guide/configuration.html): Configure the server for your needs
- [Authentication](https://cameronrye.github.io/atproto-mcp/guide/authentication.html): Set up app password authentication (OAuth login is planned)

## Core Concepts

- [MCP Protocol](https://cameronrye.github.io/atproto-mcp/guide/mcp-protocol.html): Understanding the Model Context Protocol
- [AT Protocol](https://cameronrye.github.io/atproto-mcp/guide/at-protocol.html): Overview of the AT Protocol ecosystem
- [Tools & Resources](https://cameronrye.github.io/atproto-mcp/guide/tools-resources.html): Available MCP tools and resources
- [Error Handling](https://cameronrye.github.io/atproto-mcp/guide/error-handling.html): Best practices for error handling

## API Reference

- [API Overview](https://cameronrye.github.io/atproto-mcp/api/): Complete API documentation
- [Social Operations](https://cameronrye.github.io/atproto-mcp/api/tools/create-post.html): Create posts, replies, likes, and reposts
- [User Management](https://cameronrye.github.io/atproto-mcp/api/tools/follow-user.html): Follow, unfollow, block, and mute users
- [Data Retrieval](https://cameronrye.github.io/atproto-mcp/api/tools/search-posts.html): Search posts, get timelines, and retrieve user data

## Examples

- [Basic Usage](https://cameronrye.github.io/atproto-mcp/examples/basic-usage.html): Simple examples to get started
- [Social Operations](https://cameronrye.github.io/atproto-mcp/examples/social-operations.html): Working with posts, likes, and follows
- [Content Management](https://cameronrye.github.io/atproto-mcp/examples/content-management.html): Managing images, videos, and rich content

## Optional

- [Experimental & Roadmap](https://cameronrye.github.io/atproto-mcp/guide/experimental.html): OAuth login and other planned features (and why streaming is not planned)
- [Deployment Guide](https://cameronrye.github.io/atproto-mcp/guide/deployment.html): Deploy the server to production
- [Troubleshooting](https://cameronrye.github.io/atproto-mcp/guide/troubleshooting.html): Common issues and solutions
- [FAQ](https://cameronrye.github.io/atproto-mcp/FAQ.html): Frequently asked questions
- [Changelog](https://cameronrye.github.io/atproto-mcp/changelog.html): Version history and updates
- [Contributing](https://cameronrye.github.io/atproto-mcp/contributing.html): How to contribute to the project

