Home

ActivityPub MCP Server Wiki

Welcome to the ActivityPub MCP Server wiki! This is your comprehensive guide to exploring and interacting with the Fediverse using the Model Context Protocol.

What is ActivityPub MCP Server?

A comprehensive Model Context Protocol (MCP) server that enables LLMs like Claude to explore and interact with the existing Fediverse through standardized MCP tools, resources, and prompts.

Key Features

• Fediverse Client: Interact with existing ActivityPub servers (Mastodon, Pleroma, Misskey, etc.)
• WebFinger Discovery: Find and discover actors across the fediverse
• MCP Protocol: Complete MCP server with resources, tools, and prompts
• LLM-Optimized: Designed specifically for LLM interaction patterns
• TypeScript: Fully typed with modern TypeScript and ESM
• Cross-Platform: Works on Windows, macOS, and Linux

Quick Links

Getting Started

• Installation Guide - Get up and running quickly
• Quick Start - Your first steps with the server
• Configuration - Configure the server for your needs
• Claude Desktop Integration - Use with Claude Desktop

Core Concepts

• Architecture Overview - How the server works
• MCP Resources - Read-only access to fediverse data
• MCP Tools - Interactive tools for discovery
• MCP Prompts - Templates for exploration

Usage & Examples

• Usage Guide - Comprehensive usage documentation
• Examples - Practical examples and patterns
• Discovering Actors - Find users across the fediverse
• Fetching Timelines - Access user posts
• Instance Discovery - Explore fediverse instances

Development

• Development Setup - Set up your development environment
• Contributing - How to contribute to the project
• Testing - Running and writing tests
• Performance Monitoring - Monitor server performance
• Security - Security best practices

Reference

• API Reference - Complete API documentation
• ActivityPub Specification - ActivityPub protocol guide
• WebFinger Specification - WebFinger protocol guide
• Troubleshooting - Common issues and solutions
• FAQ - Frequently asked questions

Project Information

• GitHub Repository: cameronrye/activitypub-mcp
• npm Package: activitypub-mcp
• Documentation Site: cameronrye.github.io/activitypub-mcp
• License: MIT

Community

• GitHub Issues - Report bugs and request features
• GitHub Discussions - Ask questions and share ideas
• Pull Requests - Contribute code

---

Made with ❤️ by Cameron Rye