MCP Resources Reference
Complete reference for all Model Context Protocol resources provided by the ActivityPub MCP Server. Resources provide structured access to cached data and server information.
Resource Overview
MCP Resources provide read-only access to remote ActivityPub data from any fediverse server. Resources use URI templates to access specific actors, timelines, and instances.
Server Resources
Information about the MCP server itself
Actor Resources
Access to remote actor profiles, timelines, and social graphs
Instance Resources
Information about fediverse instances
Server Resources
activitypub://server-info
Provides comprehensive information about the MCP server instance.
Content Structure
Returns comprehensive server information including:
- Server name, version, and uptime
- Available tools and resources
- Configuration settings
- Performance statistics
Usage Examples
Check Server Status
"What's the current status of the ActivityPub MCP server?"
Claude will access the server-info resource to provide uptime, performance metrics, and configuration details.
Troubleshooting
"Are there any errors or performance issues with the server?"
Claude will examine error counts, cache performance, and system health indicators.
Actor Resources
activitypub://remote-actor/{identifier}
Retrieve actor information from any fediverse server.
URI Template
activitypub://remote-actor/{identifier}
Replace {identifier} with the actor identifier (e.g., user@example.social)
Content Structure
Returns ActivityPub Actor object including:
- Actor ID and type
- Display name and username
- Profile information (bio, avatar, header)
- Public key for verification
- Endpoints (inbox, outbox, followers, following)
Usage Examples
Get Actor Profile
URI: activitypub://remote-actor/mastodon@mastodon.social
"Show me the profile information for mastodon@mastodon.social"
activitypub://remote-timeline/{identifier}
Retrieve actor's timeline/outbox from any fediverse server.
URI Template
activitypub://remote-timeline/{identifier}
Replace {identifier} with the actor identifier
Content Structure
Returns ActivityPub OrderedCollection with:
- Collection metadata (total items, first/last pages)
- Array of recent activities/posts
- Post content and metadata
- Engagement metrics
Usage Examples
Get Recent Posts
URI: activitypub://remote-timeline/user@fosstodon.org
"What are the recent posts from user@fosstodon.org?"
activitypub://remote-followers/{identifier}
Retrieve followers of an actor from any fediverse server.
URI Template
activitypub://remote-followers/{identifier}
Replace {identifier} with the actor identifier
Content Structure
Returns ActivityPub OrderedCollection with:
- Total follower count
- Collection pagination info
- Follower actor URIs
Usage Examples
Get Followers
URI: activitypub://remote-followers/admin@mastodon.social
"How many followers does admin@mastodon.social have?"
activitypub://remote-following/{identifier}
Retrieve who an actor is following from any fediverse server.
URI Template
activitypub://remote-following/{identifier}
Replace {identifier} with the actor identifier
Content Structure
Returns ActivityPub OrderedCollection with:
- Total following count
- Collection pagination info
- Following actor URIs
Usage Examples
Get Following
URI: activitypub://remote-following/user@pixelfed.social
"Who is user@pixelfed.social following?"
Instance Resources
activitypub://instance-info/{domain}
Get information about any fediverse instance.
URI Template
activitypub://instance-info/{domain}
Replace {domain} with the instance domain (e.g., mastodon.social)
Content Structure
Returns instance metadata including:
- Instance name and description
- Software version and type
- User and post statistics
- Instance rules and policies
- Contact information
- Supported features
Usage Examples
Get Instance Info
URI: activitypub://instance-info/fosstodon.org
"Tell me about the fosstodon.org instance"
Resource Access Patterns
Direct Access
Access resources directly by URI:
# Request server information
GET activitypub://server-info
# Access actor profile
GET activitypub://remote-actor/user@mastodon.socialURI Templates
Use URI templates with parameters:
# Get actor timeline
GET activitypub://remote-timeline/admin@fosstodon.org
# Get instance information
GET activitypub://instance-info/pixelfed.socialNatural Language Access
Claude can access resources through natural language:
"Show me the profile and recent posts from user@mastodon.social"
Claude will automatically access the appropriate resources.
Performance Considerations
Remote Data Fetching
- Resources fetch data from remote fediverse servers
- Response times depend on remote server performance
- Rate limiting applies to protect remote servers
- Network errors may occur with unreachable instances
Resource Size
- Timeline and follower collections may be large
- ActivityPub collections use pagination
- First page of data is typically returned
- Use tools for more control over data retrieval
Data Freshness
- Server info: Real-time server status
- Remote resources: Fetched on-demand from remote servers
- Data reflects current state of remote instances
- No local caching of remote data in resources