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 structured data maintained by the server. Unlike tools, resources don't perform actions but expose cached information and server state.
Server Resources
Information about the server itself, configuration, and status
Cache Resources
Access to cached actor, instance, and timeline data
Discovery Resources
Aggregated discovery data and instance directories
🖥️ 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.
activitypub://server-config
Exposes current server configuration and environment settings.
Content Structure
Returns server configuration including:
- Environment details (Node version, platform)
- Server settings and timeouts
- Cache configuration
- Rate limiting settings
💾 Cache Resources
activitypub://actor-cache
Access to cached actor information and discovery data.
Content Structure
Returns actor cache information including:
- Cache statistics and hit rates
- Recently discovered actors
- Popular instances
- Cache performance metrics
Usage Examples
Cache Analysis
"Show me the most recently discovered actors and their basic information"
Performance Monitoring
"What's the cache hit rate for actor lookups?"
activitypub://instance-cache
Cached instance information and metadata.
Content Structure
Returns instance cache information including:
- Cache statistics and performance
- Known instance details
- Instance health status
- Aggregate statistics
activitypub://timeline-cache
Recently fetched timeline data and content summaries.
Content Structure
Returns timeline cache information including:
- Cache statistics and entry counts
- Recent timeline data
- Engagement metrics
- Trending topics
🔍 Discovery Resources
activitypub://instance-directory
Curated directory of known fediverse instances with categorization.
Content Structure
Returns instance directory information including:
- Total instance counts by category
- Featured instances
- Categorized instance lists
- Registration and language information
activitypub://discovery-stats
Statistics and insights from discovery operations.
Content Structure
Returns discovery statistics including:
- Discovery metrics and performance
- Popular search queries
- Instance health status
- Trending instances and topics
🔧 Resource Access Patterns
Direct Access
Access resources directly by URI:
# Request specific resource
GET activitypub://server-info
# Access with parameters
GET activitypub://actor-cache?limit=10Filtered Access
Use query parameters to filter resource content:
# Filter by category
GET activitypub://instance-directory?category=technology
# Limit results
GET activitypub://timeline-cache?limit=5&actor=gargronAggregated Views
Combine multiple resources for comprehensive views:
"Show me a dashboard view with server status, cache performance, and recent discovery activity"
⚡ Performance Considerations
Caching Behavior
- Resources are cached for optimal performance
- Cache TTL varies by resource type
- Real-time data may have slight delays
- Use
clear-cachetool for fresh data
Resource Size
- Large resources are paginated automatically
- Use limit parameters to control response size
- Consider filtering for specific data needs
- Monitor memory usage with large datasets
Update Frequency
- Server resources: Updated in real-time
- Cache resources: Updated on cache operations
- Discovery resources: Updated periodically
- Check lastUpdated timestamps for freshness