MCP server for exploring and interacting with Fediverse through the ActivityPub protocol. Supports actor discovery, timeline fetching, instance exploration, and WebFinger resolution across decentralized social networks.

Installation

NPX

npx activitypub-mcp install

From Source

git clone https://github.com/cameronrye/activitypub-mcp.git
cd activitypub-mcp
npm install
npm run setup

Windows PowerShell

git clone https://github.com/cameronrye/activitypub-mcp.git
cd activitypub-mcp
npm run setup:windows

macOS/Linux

git clone https://github.com/cameronrye/activitypub-mcp.git
cd activitypub-mcp
npm run setup:unix

Configuration

Claude Desktop

{
  "mcpServers": {
    "activitypub": {
      "command": "npx",
      "args": ["-y", "activitypub-mcp"]
    }
  }
}

Available Tools

Tool	Description
discover-actor	Find and get information about any actor on the fediverse
fetch-timeline	Get recent posts from any actor's timeline
get-instance-info	Get detailed information about any fediverse instance
search-instance	Search for content on a specific fediverse instance
discover-instances	Find popular fediverse instances by category or topic
recommend-instances	Get personalized instance recommendations based on interests
health-check	Check the MCP server's health status
performance-metrics	Get MCP server performance metrics

Features

• Fediverse client — interact with ActivityPub servers (Mastodon, Pleroma, Misskey, and more)
• WebFinger Discovery — discover and find actors across the fediverse
• Remote actor discovery — find users on any fediverse instance
• Timeline fetching — get posts from any user's timeline
• Instance discovery — search and explore fediverse instances
• Search capabilities — search content across instances
• Multi-platform support — works with Mastodon, Pleroma, Misskey, and others
• Follower/following lists — access social connections
• Cross-platform compatibility — support for Windows, macOS, and Linux

Environment Variables

Optional

• MCP_SERVER_NAME — MCP server configuration name
• MCP_SERVER_VERSION — MCP server version
• RATE_LIMIT_ENABLED — enable request rate limiting
• RATE_LIMIT_MAX — maximum number of requests
• RATE_LIMIT_WINDOW — rate limit window in milliseconds
• LOG_LEVEL — logging level

Usage Examples

Find information about a user on Mastodon

Get recent posts from a specific fediverse account

Discover popular instances in a particular category

Search for content about artificial intelligence across the fediverse

Get recommendations for technology-focused instances

Notes

This is a read-only client for the fediverse that requires no authentication or account creation. It works by exploring existing public ActivityPub content across the decentralized social network. The server includes comprehensive documentation, cross-platform installation scripts, and built-in performance monitoring.