cameronrye avatar

Activitypub Mcp

cameronrye/activitypub-mcp

Brings ActivityPub timelines, profiles, and search into your LLM context. Works with Mastodon, Misskey, Pleroma, and other federated servers. Ships read-only by default so injected content can't trigger posts or follows, but you can flip ACTIVITYPUB_ENABLE_WRITES to unlock mutations: post, reply, boost, favorite, follow, mute, block. Handles OAuth and MiAuth login flows through a CLI command that saves credentials locally, supports multiple accounts with switching. Public tools let you explore instances and trending posts without auth. Notifications and home timelines require login. Wraps untrusted content in XML envelopes to mitigate prompt injection from the open fediverse.

GitHub stars
17
tools
17
transport
STDIO
env vars
2
last updated
Jun 22, 2026

Tools

17 tools

Public tool metadata for what this MCP can expose to an agent.

discover-actorPublic read tools (no account needed): `discover-actor`, `fetch-timeline`, `get-post-thread`, `get-instance-info`, `get-public-timeline`, `get-trending-hashtags`, `get-trending-posts`, `search`, `discover-instances`.

Public read tools (no account needed): `discover-actor`, `fetch-timeline`, `get-post-thread`, `get-instance-info`, `get-public-timeline`, `get-trending-hashtags`, `get-trending-posts`, `search`, `discover-instances`.

No parameter schema in public metadata yet.

fetch-timeline

No parameter schema in public metadata yet.

get-post-thread

No parameter schema in public metadata yet.

get-instance-info

No parameter schema in public metadata yet.

get-public-timeline

No parameter schema in public metadata yet.

get-trending-hashtags

No parameter schema in public metadata yet.

get-trending-posts

No parameter schema in public metadata yet.

search

No parameter schema in public metadata yet.

discover-instances

No parameter schema in public metadata yet.

list-accountsAuthenticated read tools (account required): `list-accounts`, `switch-account`, `verify-account`, `get-home-timeline`, `get-notifications`, `get-bookmarks`, `get-favourites`, `get-relationship`.

Authenticated read tools (account required): `list-accounts`, `switch-account`, `verify-account`, `get-home-timeline`, `get-notifications`, `get-bookmarks`, `get-favourites`, `get-relationship`.

No parameter schema in public metadata yet.

switch-account

No parameter schema in public metadata yet.

verify-account

No parameter schema in public metadata yet.

get-home-timeline

No parameter schema in public metadata yet.

get-notifications

No parameter schema in public metadata yet.

get-bookmarks

No parameter schema in public metadata yet.

get-favourites

No parameter schema in public metadata yet.

get-relationship

No parameter schema in public metadata yet.

Sponsors

Configuration

ACTIVITYPUB_ENABLE_WRITESdefault: false

Enable write/mutation tools (post, reply, follow, boost, block). Off by default: read-only unless set to 'true'. See SECURITY.md.

LOG_LEVELdefault: info

Logging verbosity: debug, info, warn, or error.

Readme

ActivityPub MCP Logo

ActivityPub MCP Server

Fediverse Client for LLMs

A lightweight Model Context Protocol (MCP) server that lets an LLM explore and interact with the existing Fediverse — Mastodon, Misskey, Foundkey, Pleroma, and compatible servers. Read-only by default; write tools are opt-in.


View the full README on GitHub

Details

Repository
github.com/cameronrye/activitypub-mcp
Package
activitypub-mcp
Transport
STDIO
Registry
MCP registry, active