Skip to content

Examples

Jump to bottom
Cameron Rye edited this page Nov 16, 2025 · 1 revision

Examples

Practical examples of using the ActivityPub MCP Server.

Basic Examples

Example 1: Discover a User

Find information about a specific user on the Fediverse.

Using Claude Desktop:

"Can you discover the actor Gargron@mastodon.social?"

Using MCP Inspector:

{
  "name": "discover-actor",
  "arguments": {
    "identifier": "Gargron@mastodon.social"
  }
}

Expected Result:

  • Actor profile information
  • Display name and bio
  • Follower/following counts
  • Profile links

Example 2: Fetch Recent Posts

Get the latest posts from a user.

Using Claude Desktop:

"Show me the 5 most recent posts from Gargron@mastodon.social"

Using MCP Inspector:

{
  "name": "fetch-timeline",
  "arguments": {
    "identifier": "Gargron@mastodon.social",
    "limit": 5
  }
}

Expected Result:

  • List of recent posts
  • Post content and timestamps
  • Engagement metrics

Example 3: Find Instances by Topic

Discover instances focused on a specific topic.

Using Claude Desktop:

"Find technology-focused Mastodon instances"

Using MCP Inspector:

{
  "name": "discover-instances",
  "arguments": {
    "topic": "technology",
    "category": "mastodon"
  }
}

Expected Result:

  • List of relevant instances
  • Instance descriptions
  • User counts and statistics

Intermediate Examples

Example 4: Compare Instances

Compare multiple instances to choose one to join.

Using Claude Desktop:

"Compare mastodon.social, fosstodon.org, and hachyderm.io"

Using MCP Inspector:

{
  "name": "compare-instances",
  "arguments": {
    "instances": "mastodon.social, fosstodon.org, hachyderm.io",
    "criteria": "size, focus, and community"
  }
}

Expected Result:

  • Side-by-side comparison
  • Key differences highlighted
  • Recommendations

Example 5: Search for Content

Search for specific content on an instance.

Using Claude Desktop:

"Search for TypeScript developers on fosstodon.org"

Using MCP Inspector:

{
  "name": "search-instance",
  "arguments": {
    "domain": "fosstodon.org",
    "query": "TypeScript",
    "type": "accounts"
  }
}

Expected Result:

  • List of matching accounts
  • Account descriptions
  • Relevance scores

Example 6: Get Instance Information

Learn about a specific instance.

Using Claude Desktop:

"Tell me about the instance fosstodon.org"

Using MCP Inspector:

{
  "name": "get-instance-info",
  "arguments": {
    "domain": "fosstodon.org"
  }
}

Expected Result:

  • Instance description
  • Software version
  • User statistics
  • Registration status

Advanced Examples

Example 7: Explore a New Topic

Comprehensive exploration of a topic across the Fediverse.

Workflow:

  1. Discover instances about the topic
  2. Search for content on those instances
  3. Find interesting users
  4. Fetch their timelines

Using Claude Desktop:

"I want to explore AI and machine learning on the Fediverse. Help me find relevant instances, users, and content."

Manual Steps:

// Step 1: Find instances
{
  "name": "discover-instances",
  "arguments": {
    "topic": "artificial intelligence"
  }
}

// Step 2: Search on a promising instance
{
  "name": "search-instance",
  "arguments": {
    "domain": "mastodon.social",
    "query": "machine learning",
    "type": "accounts"
  }
}

// Step 3: Discover interesting users
{
  "name": "discover-actor",
  "arguments": {
    "identifier": "user@mastodon.social"
  }
}

// Step 4: Fetch their timeline
{
  "name": "fetch-timeline",
  "arguments": {
    "identifier": "user@mastodon.social",
    "limit": 10
  }
}

Example 8: Build a Follow List

Create a curated list of users to follow.

Using Claude Desktop:

"Help me build a follow list of open source developers. Find instances, search for developers, and show me their recent posts."

Workflow:

  1. Use discover-instances with topic "open source"
  2. Use search-instance on each instance for "developer"
  3. Use discover-actor for each interesting user
  4. Use fetch-timeline to preview their content
  5. Compile a list of recommended follows

Example 9: Monitor a Community

Track activity in a specific community.

Using Claude Desktop:

"Show me what's happening in the Rust programming community on the Fediverse"

Workflow:

  1. Find Rust-focused instances
  2. Search for Rust-related content
  3. Identify active community members
  4. Fetch recent discussions

Use Case Examples

Use Case 1: New User Onboarding

Goal: Help a new user find the right instance and people to follow.

Steps:

  1. Ask about interests
  2. Use explore-fediverse prompt
  3. Use recommend-instances tool
  4. Use compare-instances prompt
  5. Use discover-content to find people

Claude Desktop Conversation:

User: "I'm new to the Fediverse and interested in technology and photography"

Claude: "Let me help you explore the Fediverse! I'll use the explore-fediverse prompt..."

Use Case 2: Content Discovery

Goal: Find interesting content about a specific topic.

Steps:

  1. Use discover-instances with topic
  2. Use search-instance on relevant instances
  3. Use discover-actor for interesting users
  4. Use fetch-timeline to see their content

Use Case 3: Instance Research

Goal: Research instances before joining.

Steps:

  1. Use discover-instances to find candidates
  2. Use get-instance-info for each
  3. Use compare-instances prompt
  4. Use search-instance to preview content

Integration Examples

Example 10: Using Resources Directly

Access data via MCP resources:

activitypub://remote-actor/Gargron@mastodon.social
activitypub://remote-timeline/Gargron@mastodon.social
activitypub://instance-info/mastodon.social

Example 11: Combining Tools and Resources

Use tools to discover, then resources to access:

  1. Use discover-actor tool to find an actor
  2. Access their timeline via resource
  3. Use get-instance-info for their instance
  4. Access instance info via resource

Next Steps

Made with ❤️ by Cameron Rye

Clone this wiki locally