Activitypub MCP, developed by Cameronrye, is a Model Context Protocol (MCP) server designed for the mcp platform. Built with TypeScript and running on Node.js, it enables Large Language Models to explore and interact with the Fediverse. Distributed as an npm package or an .mcpb bundle, Activitypub MCP provides a structured interface for AI clients like Claude to engage with decentralized social networks. It offers tools for reading public content, managing authenticated interactions, and performing mutations, making it a key component for AI assistants in the Fediverse ecosystem.

What does Activitypub MCP connect to?

Activitypub MCP connects directly to the Fediverse, a decentralized social network. This includes diverse platforms such as Mastodon, Misskey, Foundkey, Pleroma, Lemmy, PeerTube, GoToSocial, and Pixelfed. As an MCP server, Activitypub MCP specifically enables Large Language Models (LLMs) to navigate and engage with this interconnected web of servers. It acts as a gateway, allowing AI clients to access and interact with content across various independent Fediverse instances, supporting a broad ecosystem of decentralized communication.

Core features and tools

Activitypub MCP exposes callable tools categorized by access level. Public read tools, requiring no account, include discover-actor, fetch-timeline, get-post-thread, and search. Authenticated read tools, needing an account, provide functions like list-accounts, get-home-timeline, and get-notifications. For write operations, mutation tools such as post, reply, boost, and follow are available. These mutation tools are opt-in, requiring the ACTIVITYPUB_ENABLE_WRITES environment variable to be set to "true" for activation, ensuring controlled interaction with the Fediverse.

Who is it for?

The primary audience for Activitypub MCP includes LLMs and developers creating AI assistants that need to interact with the Fediverse. It serves those building systems requiring the ability to browse public content, manage personal accounts, or perform actions like posting and following across decentralized platforms. Its design supports AI clients like Claude, making it suitable for applications that automate or enhance Fediverse engagement. Skip this if your application does not require interaction with decentralized social networks.

How to get started

Access is granted through a standard OAuth authorization flow for Mastodon-family instances or MiAuth for Misskey. A single account can also be configured by setting the ACTIVITYPUB_DEFAULT_INSTANCE and ACTIVITYPUB_DEFAULT_TOKEN environment variables, with stdio as the default transport protocol.

Use cases

• Looking up a Fediverse actor and summarizing their latest posts.
• Generating Fediverse research digests.
• Creating image posts with alt text.

Activitypub MCP provides a structured gateway for AI to engage with the Fediverse. Its support for multiple authentication methods and distinct tool categories allows for varied interaction levels, from public data retrieval to authenticated content creation. The tool is particularly useful for developers building AI assistants that need to navigate and contribute to decentralized social networks.