MCP Prompts Reference
Pre-built prompts and templates for common ActivityPub operations. These prompts help you get started quickly and demonstrate best practices for fediverse exploration.
Registered MCP Prompts
The ActivityPub MCP Server provides 11 registered prompts that can be invoked directly through the MCP protocol:
explore-fediverse
Description
Get guidance on exploring and discovering content in the fediverse.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
interests | string | Yes | Your interests or topics you want to explore |
instanceType | enum | No | Preferred type of fediverse instance: "mastodon", "pleroma", "misskey", "pixelfed", "peertube", or "any" |
Example Usage
"I'm interested in exploring the fediverse, particularly content related to: open source software and privacy. I prefer mastodon instances. Can you help me discover interesting actors, instances, and communities to follow?"
compare-instances
Description
Get help comparing different fediverse instances.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
instances | string | Yes | Comma-separated list of instance domains to compare |
criteria | string | No | Specific criteria for comparison (e.g., size, rules, features) |
Example Usage
"Please help me compare these fediverse instances: mastodon.social, fosstodon.org, pixelfed.social. I'm particularly interested in: community size, moderation policies, and technical features."
discover-content
Description
Get recommendations for discovering interesting content and people.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
topics | string | Yes | Comma-separated topics or subjects you want to explore |
contentType | enum | No | Type of content to discover: "people", "hashtags", "instances", or "all" (default: "all") |
Example Usage
"I want to discover people related to 'photography, nature, wildlife' in the fediverse. Can you suggest specific accounts to follow that would be interesting for someone interested in photography, nature, wildlife?"
compare-accounts
Description
Compare different fediverse accounts side by side.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
accounts | string | Yes | Comma-separated list of account identifiers to compare (e.g., user1@mastodon.social, user2@fosstodon.org) |
aspects | string | No | Specific aspects to compare (e.g., posting frequency, topics, engagement) |
Example Usage
"Please compare these accounts: @gargron@mastodon.social and @Mastodon@mastodon.social. I'm interested in their posting frequency and engagement styles."
analyze-user-activity
Description
Get a detailed analysis of a fediverse user's activity and posting patterns.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
identifier | string | Yes | Actor identifier (e.g., user@mastodon.social) |
depth | enum | No | Analysis depth: "quick" (10 posts), "standard" (20 posts), or "comprehensive" (50 posts) |
Example Usage
"Analyze the activity of @gargron@mastodon.social. Do a comprehensive analysis of their posting patterns, topics, and engagement style."
find-experts
Description
Find fediverse accounts that are experts or active contributors in a specific topic.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
topic | string | Yes | The topic or field to find experts in (e.g., "machine learning", "rust programming", "climate science") |
instances | string | No | Comma-separated list of instances to search (default: searches popular instances) |
Example Usage
"Find experts and active contributors discussing machine learning in the fediverse. Search fosstodon.org and hachyderm.io."
summarize-trending
Description
Get a summary of what's currently trending and being discussed in the fediverse.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
instances | string | No | Comma-separated list of instances to check (default: mastodon.social) |
focus | enum | No | Focus area: "general", "tech", "news", "art", "science", or "all" |
Example Usage
"Summarize what's trending on mastodon.social and fosstodon.org right now. Focus on tech topics."
content-strategy v1.1.0
Description
Plan a fediverse content strategy based on trends, audience analysis, and engagement patterns.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
niche | string | Yes | Your content niche or focus area (e.g., "web development", "digital art", "climate activism") |
goals | string | No | Your goals (e.g., "grow audience", "build community", "share knowledge") |
currentAccount | string | No | Your current account identifier for personalized analysis |
Example Usage
"Help me develop a content strategy for my web development niche. My goal is to build a community and share knowledge. Analyze what's working for similar accounts and suggest posting strategies."
community-health v1.1.0
Description
Analyze the moderation practices, community culture, and overall health of a fediverse instance.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
instance | string | Yes | Instance domain to analyze (e.g., "mastodon.social") |
aspects | string | No | Specific aspects to analyze: "moderation", "activity", "culture", "safety", or "all" |
Example Usage
"Analyze the community health of fosstodon.org. I want to understand their moderation practices, community culture, and whether it's a safe space for tech discussions."
migration-helper v1.1.0
Description
Get guidance on migrating between fediverse instances, including feature comparison and migration steps.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
currentInstance | string | Yes | Your current instance domain |
targetInstance | string | No | Instance you're considering (if you have one in mind) |
priorities | string | No | What matters most to you (e.g., "community size", "moderation", "uptime", "features") |
Example Usage
"I'm considering migrating from mastodon.social. Help me evaluate alternatives that prioritize strong moderation and have an active tech community. Walk me through the migration process."
thread-composer v1.1.0
Description
Help compose well-structured threaded posts for the fediverse, with proper formatting and engagement optimization.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
topic | string | Yes | The main topic or subject of your thread |
keyPoints | string | No | Comma-separated key points to cover in the thread |
tone | enum | No | Desired tone: "informative", "casual", "professional", "humorous" |
maxPosts | number | No | Maximum number of posts in the thread (default: 10) |
Example Usage
"Help me compose a thread about the benefits of open source software. Key points: community collaboration, transparency, security. Keep it informative but accessible, max 5 posts."
Prompt Pattern Examples
Below are example prompt patterns you can use with Claude when the ActivityPub MCP Server is connected. These demonstrate effective ways to interact with the fediverse through natural language.
Community Discovery
Prompt Template:
"Help me discover active communities in the fediverse focused on [TOPIC]. Find relevant instances, identify key actors, and show me what they're discussing. Provide a summary of each community's focus and activity level."
Example Usage:
Technology Communities
"Help me discover active communities in the fediverse focused on open source software. Find relevant instances, identify key actors, and show me what they're discussing. Provide a summary of each community's focus and activity level."
Art Communities
"Help me discover active communities in the fediverse focused on digital art and creative work. Find relevant instances, identify key actors, and show me what they're discussing. Provide a summary of each community's focus and activity level."
Expected Workflow:
- Use
discover-instancesto find topic-relevant instances - Use
get-instance-infoto analyze each instance - Use
discover-actorto find key community members - Use
fetch-timelineto sample recent content - Synthesize findings into a comprehensive community overview
Actor Research
Prompt Template:
"Research the fediverse actor [ACTOR_IDENTIFIER]. Provide their profile information, recent activity summary, engagement patterns, and identify their main topics of interest. Also show their connections to other notable actors."
Example Usage:
Specific Actor Research
"Research the fediverse actor @gargron@mastodon.social. Provide their profile information, recent activity summary, engagement patterns, and identify their main topics of interest. Also show their connections to other notable actors."
Instance Comparison
Prompt Template:
"Compare the fediverse instances [INSTANCE1] and [INSTANCE2]. Analyze their size, community focus, rules, activity levels, and notable members. Help me understand which might be a better fit for someone interested in [INTEREST_AREA]."
Example Usage:
Tech Instance Comparison
"Compare the fediverse instances fosstodon.org and hachyderm.io. Analyze their size, community focus, rules, activity levels, and notable members. Help me understand which might be a better fit for someone interested in open source development."
Analysis Prompts
Trend Analysis
Prompt Template:
"Analyze current trends and discussions about [TOPIC] across the fediverse. Find instances and actors discussing this topic, summarize the main points of conversation, and identify any emerging themes or controversies."
Example Usage:
AI Discussion Analysis
"Analyze current trends and discussions about artificial intelligence across the fediverse. Find instances and actors discussing this topic, summarize the main points of conversation, and identify any emerging themes or controversies."
Engagement Analysis
Prompt Template:
"Analyze the engagement patterns of [ACTOR_IDENTIFIER]. Look at their recent posts, reply rates, boost frequency, and interaction with other users. Identify their most engaging content types and optimal posting patterns."
Content Categorization
Prompt Template:
"Analyze and categorize the recent content from [INSTANCE/ACTOR]. Group posts by topic, identify the most common themes, and provide statistics on content types (original posts, replies, boosts, media posts)."
Research Prompts
Academic Research
Prompt Template:
"Conduct a systematic analysis of [RESEARCH_TOPIC] discussions in the fediverse for academic research. Find relevant communities, identify key voices and experts, analyze discourse patterns, and provide data suitable for scholarly analysis. Include methodology notes and data quality assessments."
Example Usage:
Climate Change Research
"Conduct a systematic analysis of climate change discussions in the fediverse for academic research. Find relevant communities, identify key voices and experts, analyze discourse patterns, and provide data suitable for scholarly analysis. Include methodology notes and data quality assessments."
Market Research
Prompt Template:
"Research market sentiment and discussions about [PRODUCT/INDUSTRY] in the fediverse. Identify target demographics, analyze user needs and pain points, find potential early adopters, and assess competitive landscape discussions."
Network Analysis
Prompt Template:
"Map the network structure of [COMMUNITY/TOPIC] in the fediverse. Identify key nodes (influential actors), connection patterns between instances, information flow pathways, and community clusters. Provide insights into network dynamics and influence patterns."
Monitoring Prompts
Brand Monitoring
Prompt Template:
"Monitor mentions and discussions of [BRAND/ORGANIZATION] across the fediverse. Track sentiment, identify key conversations, find influential voices discussing the brand, and alert me to any significant changes in discussion volume or tone."
Community Health Monitoring
Prompt Template:
"Monitor the health and activity of [INSTANCE/COMMUNITY]. Track user engagement, content quality, growth patterns, and community dynamics. Identify any concerning trends or positive developments that warrant attention."
Topic Tracking
Prompt Template:
"Track discussions and developments related to [TOPIC] across the fediverse. Monitor for new information, changing sentiment, emerging sub-topics, and key contributors to the conversation. Provide regular updates on significant changes."
Custom Prompt Building
Prompt Structure
1. Objective Statement
Clearly state what you want to accomplish
"Help me [ACTION] [TARGET] in the fediverse" 2. Scope Definition
Specify the scope and boundaries
"Focus on [INSTANCES/ACTORS/TOPICS]" 3. Output Requirements
Define what kind of output you need
"Provide [ANALYSIS/SUMMARY/DATA/RECOMMENDATIONS]" 4. Context Information
Add relevant context or constraints
"Consider [TIMEFRAME/AUDIENCE/PURPOSE]" Best Practices
- Be Specific: Use exact actor identifiers and instance names
- Set Expectations: Clearly state what kind of analysis you want
- Provide Context: Explain the purpose or use case
- Request Methodology: Ask for explanation of the approach used
- Specify Format: Request specific output formats if needed
Common Variables
[TOPIC] Subject area or theme of interest
[ACTOR_IDENTIFIER] @username@instance.com or actor URL
[INSTANCE] Domain name of fediverse instance
[TIMEFRAME] Time period for analysis (e.g., "past week")
[COMMUNITY] Specific community or group focus
⚡ Quick Start Prompts
Explore a New Topic
"Show me what the fediverse is saying about [TOPIC]"
Find Communities
"Find active [TOPIC] communities in the fediverse"
Research an Actor
"Tell me about @username@instance.com"
Compare Instances
"Compare instance1.com and instance2.com"
Monitor Activity
"What's new with @username@instance.com?"
Analyze Trends
"What are the trending topics in [COMMUNITY]?"