{"id":"01KHNJ6DFXMQ4ZNXJ0182B70VA","type":"mcp_connector","title":"ActivityPub MCP Server","slug":"vb-activitypub-mcp","short_description":"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.","description_md":" $\"ActivityPub$ \n

\n\n

ActivityPub MCP Server

\n\n

\n Fediverse Client for LLMs\n

\n\n

\n 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.\n

\n\n\n\n

\n $\"npm$ \n $\"License:$ \n $\"TypeScript\"$ \n $\"Node.js\"$ \n $\"MCP$ \n

\n\n

\n $\"CI\"$ \n $\"npm$ \n $\"GitHub$ \n

\n\n---\n\n

What's New in v1.1.0

\n\n

\n The biggest release yet! Now with full write capabilities, multi-account support, and enterprise-ready features.\n

\n\n\n \n \n \n \n \n \n \n \n \n \n

Post & Interact Create posts, reply, boost, favourite, and bookmark directly from your LLM	Multi-Account Manage multiple fediverse accounts with secure credential storage	Media & Polls Upload images with alt text, vote on polls, schedule posts
Export Anywhere Export timelines, threads, and accounts to JSON, Markdown, or CSV	HTTP Transport Production-ready HTTP/SSE mode for enterprise deployments	53 Tools 21 read-only + 28 authenticated + 4 export tools

\n\n

\n See Authenticated Tools |\n See Export Tools |\n Full Changelog\n

\n\n---\n\n## Features\n\n### Core Capabilities\n\n- **Fediverse Client**: Interact with existing ActivityPub servers (Mastodon, Pleroma, Misskey, etc.)\n- **WebFinger Discovery**: Find and discover actors across the fediverse\n- **MCP Protocol**: Complete MCP server with resources, tools, and prompts\n- **LLM-Optimized**: Designed specifically for LLM interaction patterns\n- **TypeScript**: Fully typed with modern TypeScript and ESM\n- **High Performance**: Efficient resource management and caching\n- **Secure**: Built-in security features and input validation\n- **Dual Transport**: Supports both stdio (Claude Desktop) and HTTP transport modes\n\n### Fediverse Interaction Features\n\n- **Remote Actor Discovery**: Find users on any fediverse instance\n- **Timeline Fetching**: Get posts from any user's timeline with pagination support\n- **Trending Content**: Access trending hashtags and posts\n- **Instance Discovery**: Find and explore fediverse instances via live API\n- **Instance Information**: Get detailed info about any server\n- **Search Capabilities**: Search for accounts, hashtags, and posts across instances\n- **Post Threads**: Fetch complete conversation threads with replies\n- **WebFinger Support**: Resolve actor identifiers across the network\n- **Multi-Platform Support**: Works with Mastodon, Pleroma, Misskey, and more\n- **Follower/Following Lists**: Access social connections\n- **Batch Operations**: Fetch multiple actors or posts in a single request\n\n### MCP Features\n\n- **Resources** (10 total): Access remote ActivityPub data (actors, timelines, trending, instance info)\n- **Tools** (53 total): Discover, interact, and create content in the fediverse\n - 21 read-only tools for discovery and exploration (including unified search)\n - 28 authenticated tools for posting, interactions, polls, media, and scheduling\n - 4 export tools for data export in JSON, Markdown, or CSV formats\n- **Prompts** (11 total): Templates for fediverse exploration, content strategy, and community analysis\n- **Monitoring**: Built-in logging, audit trails, and performance metrics\n- **Health Checks**: Server health monitoring and diagnostics\n\n### Authenticated Features (v1.1.0)\n\n- **Multi-Account Support**: Manage multiple fediverse accounts with secure credential storage\n- **Posting Operations**: Create, reply to, and delete posts\n- **Social Interactions**: Boost, favourite, bookmark, follow, mute, and block\n- **Authenticated Timelines**: Access home timeline, notifications, bookmarks, and favourites\n- **Content Export**: Export timelines, threads, and account data in multiple formats\n\n### Security & Administration\n\n- **Instance Blocklist**: Block specific instances by domain or wildcard pattern\n- **Audit Logging**: Comprehensive logging of all tool invocations and resource access\n- **Content Warnings**: Respect and display content warnings from posts\n- **Rate Limiting**: Protect against abuse with configurable rate limits\n\n## Quick Start\n\n### Prerequisites\n\n- **Node.js 18+** (LTS recommended)\n- **npm** or **yarn** package manager\n- **Git** for cloning the repository\n\n### Cross-Platform Support\n\nThis project works on **Windows**, **macOS**, and **Linux** with automatic platform detection and appropriate script selection.\n\n### One-Click Installation\n\nFor the fastest setup, use our automated installation script:\n\n#### Universal (All Platforms)\n```bash\n# Install directly with npx (recommended)\nnpx activitypub-mcp install\n\n# Or clone and run setup\ngit clone https://github.com/cameronrye/activitypub-mcp.git\ncd activitypub-mcp\nnpm run setup\n```\n\n#### Platform-Specific Installation\n\n**Windows (PowerShell):**\n```powershell\n# Clone and setup\ngit clone https://github.com/cameronrye/activitypub-mcp.git\ncd activitypub-mcp\nnpm run setup:windows\n\n# Or run PowerShell script directly\n.\\scripts\\setup.ps1\n```\n\n**macOS/Linux (Bash):**\n```bash\n# Clone and setup\ngit clone https://github.com/cameronrye/activitypub-mcp.git\ncd activitypub-mcp\nnpm run setup:unix\n\n# Or run bash script directly\nbash scripts/setup.sh\n```\n\n### Manual Installation\n\n1. **Clone and install dependencies**:\n\n```bash\ngit clone https://github.com/cameronrye/activitypub-mcp.git\ncd activitypub-mcp\nnpm install\n```\n\n2. **Configure environment**:\n\n**Windows:**\n```cmd\n# Copy environment template\ncopy .env.example .env\n\n# Edit configuration (optional)\nnotepad .env\n```\n\n**macOS/Linux:**\n```bash\n# Copy environment template\ncp .env.example .env\n\n# Edit configuration (optional)\nnano .env\n```\n\n3. **Start the MCP server**:\n\n```bash\n# Start the MCP server (no local ActivityPub server needed)\nnpm run mcp\n```\n\n### Testing the Setup\n\n**Test MCP server** with MCP Inspector:\n\n```bash\n# Install MCP Inspector\nnpm install -g @modelcontextprotocol/inspector\n\n# Connect to the MCP server\nmcp-inspector\n```\n\n### Claude Desktop Integration\n\nTo use this MCP server with Claude Desktop:\n\n1. **Locate your Claude Desktop config file**:\n - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n - **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n2. **Add the server configuration**:\n\n```json\n{\n \"mcpServers\": {\n \"activitypub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"activitypub-mcp\"]\n }\n }\n}\n```\n\n3. **Restart Claude Desktop** to load the new server.\n\n## Documentation\n\n### Quick Reference\n\nFor detailed usage instructions, examples, and troubleshooting, see:\n\n- **[Usage Guide](docs/guides/USAGE_GUIDE.md)** - Comprehensive usage documentation\n- **[Examples](docs/guides/EXAMPLES.md)** - Practical examples and integration patterns\n- **[API Reference](#api-reference)** - Complete API documentation (below)\n\n### API Reference\n\n### MCP Resources\n\nResources provide read-only access to fediverse data from any ActivityPub server. All resources return JSON data unless otherwise specified.\n\n#### Server Info Resource\n\nGet information about the ActivityPub MCP server:\n\n```uri\nactivitypub://server-info\n```\n\n**Parameters:**\n- None required\n\n**Example Response:**\n\n```json\n{\n \"name\": \"activitypub-mcp\",\n \"version\": \"1.1.0\",\n \"description\": \"A Model Context Protocol server for exploring and interacting with the existing Fediverse\",\n \"capabilities\": {\n \"resources\": [\"server-info\", \"remote-actor\", \"remote-timeline\", \"remote-followers\", \"remote-following\", \"instance-info\", \"trending\", \"local-timeline\", \"federated-timeline\", \"post-thread\"],\n \"tools\": {\n \"discovery\": [\"discover-actor\", \"discover-instances\", \"discover-instances-live\", \"recommend-instances\"],\n \"content\": [\"fetch-timeline\", \"get-post-thread\", \"search-instance\", \"search-accounts\", \"search-hashtags\", \"search-posts\"],\n \"timelines\": [\"get-trending-hashtags\", \"get-trending-posts\", \"get-local-timeline\", \"get-federated-timeline\"],\n \"utility\": [\"convert-url\", \"batch-fetch-actors\", \"batch-fetch-posts\"],\n \"system\": [\"health-check\", \"performance-metrics\"]\n },\n \"prompts\": [\"explore-fediverse\", \"discover-content\", \"compare-instances\", \"compare-accounts\", \"analyze-user-activity\", \"find-experts\", \"summarize-trending\"]\n },\n \"features\": {\n \"auditLogging\": true,\n \"instanceBlocklist\": true,\n \"contentWarnings\": true,\n \"batchOperations\": true\n }\n}\n```\n\n#### Remote Actor Resource\n\nGet information about any actor in the fediverse:\n\n```uri\nactivitypub://remote-actor/{identifier}\n```\n\n**Parameters:**\n- `identifier` (string): The actor's fediverse handle (e.g., user@mastodon.social)\n\n**Example Response:**\n\n```json\n{\n \"@context\": [\"https://www.w3.org/ns/activitystreams\"],\n \"id\": \"https://mastodon.social/users/alice\",\n \"type\": \"Person\",\n \"preferredUsername\": \"alice\",\n \"name\": \"Alice Smith\",\n \"summary\": \"Software developer passionate about decentralized social networks\",\n \"inbox\": \"https://mastodon.social/users/alice/inbox\",\n \"outbox\": \"https://mastodon.social/users/alice/outbox\"\n}\n```\n\n#### Remote Timeline Resource\n\nAccess any actor's timeline/outbox from across the fediverse:\n\n```uri\nactivitypub://remote-timeline/{identifier}\n```\n\n**Parameters:**\n- `identifier` (string): The actor's fediverse handle (e.g., user@mastodon.social)\n\n**Example Response:**\n\n```json\n{\n \"@context\": \"https://www.w3.org/ns/activitystreams\",\n \"type\": \"OrderedCollection\",\n \"id\": \"https://mastodon.social/users/alice/outbox\",\n \"totalItems\": 42,\n \"orderedItems\": [...]\n}\n```\n\n#### Instance Info Resource\n\nGet information about any fediverse instance:\n\n```uri\nactivitypub://instance-info/{domain}\n```\n\n**Parameters:**\n- `domain` (string): The instance domain (e.g., mastodon.social)\n\n**Example Response:**\n\n```json\n{\n \"domain\": \"mastodon.social\",\n \"software\": \"mastodon\",\n \"version\": \"4.2.1\",\n \"description\": \"The original server operated by the Mastodon gGmbH non-profit\",\n \"registrations\": true,\n \"stats\": {\n \"user_count\": 900000,\n \"status_count\": 50000000\n }\n}\n```\n\n#### Remote Followers/Following Resources\n\nAccess follower and following lists from any actor:\n\n```uri\nactivitypub://remote-followers/{identifier}\nactivitypub://remote-following/{identifier}\n```\n\n#### Trending Resource (New)\n\nGet trending hashtags and posts from an instance:\n\n```uri\nactivitypub://trending/{domain}\n```\n\n#### Local Timeline Resource (New)\n\nGet the local public timeline from an instance:\n\n```uri\nactivitypub://local-timeline/{domain}\n```\n\n#### Federated Timeline Resource (New)\n\nGet the federated public timeline from an instance:\n\n```uri\nactivitypub://federated-timeline/{domain}\n```\n\n#### Post Thread Resource (New)\n\nGet a post and its full conversation thread:\n\n```uri\nactivitypub://post-thread/{postUrl}\n```\n\n### MCP Tools\n\nTools enable LLMs to discover and interact with the fediverse. All tools return structured responses with success/error information.\n\n#### Discover Actor\n\nDiscover and get information about any actor in the fediverse:\n\n```json\n{\n \"name\": \"discover-actor\",\n \"arguments\": {\n \"identifier\": \"user@mastodon.social\"\n }\n}\n```\n\n**Parameters:**\n- `identifier` (string, required): Fediverse handle (e.g., user@mastodon.social)\n\n#### Fetch Timeline\n\nFetch posts from any actor's timeline with pagination support:\n\n```json\n{\n \"name\": \"fetch-timeline\",\n \"arguments\": {\n \"identifier\": \"user@mastodon.social\",\n \"limit\": 20,\n \"cursor\": null,\n \"maxId\": null\n }\n}\n```\n\n**Parameters:**\n\n- `identifier` (string, required): Fediverse handle\n- `limit` (number, optional): Number of posts to fetch (1-50, default: 20)\n- `cursor` (string, optional): Pagination cursor from previous response\n- `minId` (string, optional): Return results newer than this ID\n- `maxId` (string, optional): Return results older than this ID\n- `sinceId` (string, optional): Return results since this ID\n\n#### Get Instance Info\n\nGet detailed information about any fediverse instance:\n\n```json\n{\n \"name\": \"get-instance-info\",\n \"arguments\": {\n \"domain\": \"mastodon.social\"\n }\n}\n```\n\n**Parameters:**\n- `domain` (string, required): Instance domain\n\n#### Search Instance\n\nSearch for content on a specific fediverse instance:\n\n```json\n{\n \"name\": \"search-instance\",\n \"arguments\": {\n \"domain\": \"mastodon.social\",\n \"query\": \"typescript\",\n \"type\": \"accounts\"\n }\n}\n```\n\n**Parameters:**\n- `domain` (string, required): Instance domain to search\n- `query` (string, required): Search query\n- `type` (string, optional): Type of content (\"accounts\", \"statuses\", \"hashtags\")\n\n#### Discover Instances\n\nFind popular fediverse instances by category or topic:\n\n```json\n{\n \"name\": \"discover-instances\",\n \"arguments\": {\n \"category\": \"mastodon\",\n \"topic\": \"technology\",\n \"size\": \"medium\"\n }\n}\n```\n\n**Parameters:**\n- `category` (string, optional): Software type (\"mastodon\", \"pleroma\", \"misskey\", etc.)\n- `topic` (string, optional): Topic or interest to search for\n- `size` (string, optional): Instance size (\"small\", \"medium\", \"large\")\n- `region` (string, optional): Geographic region or language\n- `beginnerFriendly` (boolean, optional): Show only beginner-friendly instances\n\n#### Recommend Instances\n\nGet personalized instance recommendations based on interests:\n\n```json\n{\n \"name\": \"recommend-instances\",\n \"arguments\": {\n \"i","ai_tags":["claude"],"domain_tags":[{"child_name":"API","child_slug":"api","parent_name":"Development","parent_slug":"development"},{"child_name":"Code Generation","child_slug":"code-generation","parent_name":"Development","parent_slug":"development"}],"author_user_id":"system-parser","author_name":null,"visibility":"public","pricing_type":"free","price_credits":0,"status":"published","version":"1.0.0","content_mode":"inline_text","inline_content":"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.\n\n## Installation\n\n### NPX\n\n```bash\nnpx activitypub-mcp install\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/cameronrye/activitypub-mcp.git\ncd activitypub-mcp\nnpm install\nnpm run setup\n```\n\n### Windows PowerShell\n\n```bash\ngit clone https://github.com/cameronrye/activitypub-mcp.git\ncd activitypub-mcp\nnpm run setup:windows\n```\n\n### macOS/Linux\n\n```bash\ngit clone https://github.com/cameronrye/activitypub-mcp.git\ncd activitypub-mcp\nnpm run setup:unix\n```\n\n## Configuration\n\n### Claude Desktop\n\n```json\n{\n \"mcpServers\": {\n \"activitypub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"activitypub-mcp\"]\n }\n }\n}\n```\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `discover-actor` | Find and get information about any actor on the fediverse |\n| `fetch-timeline` | Get recent posts from any actor's timeline |\n| `get-instance-info` | Get detailed information about any fediverse instance |\n| `search-instance` | Search for content on a specific fediverse instance |\n| `discover-instances` | Find popular fediverse instances by category or topic |\n| `recommend-instances` | Get personalized instance recommendations based on interests |\n| `health-check` | Check the MCP server's health status |\n| `performance-metrics` | Get MCP server performance metrics |\n\n## Features\n\n- Fediverse client — interact with ActivityPub servers (Mastodon, Pleroma, Misskey, and more)\n- WebFinger Discovery — discover and find actors across the fediverse\n- Remote actor discovery — find users on any fediverse instance\n- Timeline fetching — get posts from any user's timeline\n- Instance discovery — search and explore fediverse instances\n- Search capabilities — search content across instances\n- Multi-platform support — works with Mastodon, Pleroma, Misskey, and others\n- Follower/following lists — access social connections\n- Cross-platform compatibility — support for Windows, macOS, and Linux\n\n## Environment Variables\n\n### Optional\n- `MCP_SERVER_NAME` — MCP server configuration name\n- `MCP_SERVER_VERSION` — MCP server version\n- `RATE_LIMIT_ENABLED` — enable request rate limiting\n- `RATE_LIMIT_MAX` — maximum number of requests\n- `RATE_LIMIT_WINDOW` — rate limit window in milliseconds\n- `LOG_LEVEL` — logging level\n\n## Usage Examples\n\n```\nFind information about a user on Mastodon\n```\n\n```\nGet recent posts from a specific fediverse account\n```\n\n```\nDiscover popular instances in a particular category\n```\n\n```\nSearch for content about artificial intelligence across the fediverse\n```\n\n```\nGet recommendations for technology-focused instances\n```## Notes\n\nThis 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.","metadata_json":{"original_tags":["API","Integration","Web Scraping","Search","Messaging"],"original_author":"cameronrye","vibebaza_featured":false},"downloads_count":0,"rating_avg":4.0,"rating_count":1,"is_featured":true,"is_verified":true,"is_free_service":false,"external_source_name":"Cameron Rye","external_source_url":"https://github.com/cameronrye/activitypub-mcp","claimed_by_user_id":null,"claimed_at":null,"files":[],"bundle_items":[],"chain_steps":[],"created_at":"2026-02-17T10:26:34.307671Z","updated_at":"2026-03-14T20:55:18.424908Z"}

ActivityPub MCP Server

Claim this listing