# Mastodon Intelligence MCP

> Mastodon Intelligence tracks real-time activity and trends across any decentralized social network instance. Monitor what topics are spiking, which external articles gain traction, and the general community pulse using authenticated API access.

## Overview
- **Category:** social-media
- **Price:** Free
- **Tags:** fediverse, mastodon-trends, social-listening, osint, public-api

## Description

Tracking conversations across large social platforms used to feel like a guessing game—you only see the highlights reel, filtered by algorithms designed for engagement. This MCP changes that. It lets your AI client pull raw intelligence directly from Mastodon instances, giving you an unfiltered view of community sentiment.

You can discover what topics are genuinely gaining steam using `get_trending_hashtags`, or monitor the live feed to see exactly how people talk about a subject in real time via `get_public_timeline`. Need to know what content is actually influencing the conversation? You can run `get_trending_links` to surface the exact external articles and news stories that the community is sharing right now. This gives you true editorial relevance data, which is crucial for market research or content planning. Since Vinkius hosts this MCP, your agent connects once from any compatible client and gets access to all these specialized tools. It's about getting accurate signals—the ones driven by genuine user activity, not platform whims.

## Tools

### get_instance_info
Retrieves statistics and general information about the specific Mastodon network you are monitoring.

### get_posts_by_hashtag
Gathers the latest public posts from the Fediverse that contain a specified hashtag, like #DevOps or #Privacy.

### get_public_timeline
Fetches a stream of recent public activity across the open, decentralized network in real time.

### get_trending_links
Identifies and lists external articles or news sources that are currently being shared most often on Mastodon.

### get_trending_posts
Finds the posts with the highest levels of engagement (boosts and favorites) happening right now across the network.

### get_trending_hashtags
Lists currently trending hashtags on Mastodon, showing usage counts based purely on community activity.

## Prompt Examples

**Prompt:** 
```
What are the top trending hashtags on Mastodon right now?
```

**Response:** 
```
Here are the top trending hashtags on mastodon.social: #AI (342 uses today), #OpenSource (218 uses), #Privacy (156 uses). These trends are algorithm-free — purely usage-based.
```

**Prompt:** 
```
Show me the latest public posts about #DevOps on the Fediverse.
```

**Response:** 
```
Found 15 recent posts with #DevOps. The most engaged post is from @sre_engineer discussing Kubernetes cost optimization with 47 boosts and 89 favourites.
```

**Prompt:** 
```
What external articles are being shared the most on Mastodon today?
```

**Response:** 
```
The top trending links today: 1) 'The EU AI Act explained' from TechCrunch (shared by 89 accounts), 2) 'Open Source funding crisis' from The Register (67 accounts).
```

## Capabilities

### Analyze network scale
Get statistics and a description of the specific Mastodon instance you are targeting for analysis.

### Monitor topic-specific chatter
Track public posts mentioning a precise hashtag, allowing you to focus on niche industry conversations.

### Watch the real-time feed
Retrieve the latest public posts from the open decentralized network as they happen.

### Identify viral external content
Determine which outside articles and news sources are currently being shared most frequently across the Mastodon community.

### Find high-impact posts
Surface the posts that have received the highest amount of boosts and favorites, indicating organic community interest.

### Discover usage trends
Identify currently trending hashtags based purely on how many times they are used by users.

## Use Cases

### Tracking competitor sentiment
A market researcher needs to know if a major tech shift is causing anxiety. They run `get_posts_by_hashtag` for terms like 'AI ethics' and use `get_trending_hashtags` to see which specific concerns are gaining traction, giving them immediate talking points.

### Preparing for a major launch
A content strategist wants to write an article that hits the current cultural nerve. They run `get_trending_links` and discover that 'decentralized finance' is the most shared external topic, directing their focus and informing their outline.

### Monitoring event coverage
A developer advocate needs to follow a specific conference. They use `get_public_timeline` for real-time updates while simultaneously running `get_trending_posts` to see which key speakers' posts are getting the most attention and buzz.

### Assessing platform health
A communications team needs a baseline understanding of a network. They first run `get_instance_info` to confirm the scale, then use `get_trending_posts` to quickly gauge overall community engagement levels.

## Benefits

- You stop relying on platform-specific analytics. By using `get_trending_hashtags`, you get usage counts for topics that are purely driven by community interest, bypassing algorithmic manipulation.
- Don't waste time searching multiple sites. With this MCP, you can monitor the general conversation pulse of the Fediverse instantly via `get_public_timeline` in a single query.
- You gain immediate insight into external news relevance. The `get_trending_links` tool tells you which outside articles are actually getting traction and shared by the community right now.
- Find what’s truly resonating with people. Instead of guessing, run `get_trending_posts` to identify posts that have earned high engagement through organic sharing and favoriting.
- You maintain focus on key verticals. When you need to track specific industry conversations—say, #Fintech or #Journalism—you use `get_posts_by_hashtag` to filter the noise instantly.

## How It Works

The bottom line is that you get raw, actionable social listening data without having to build and manage complex API integrations yourself.

1. First, you subscribe to this MCP in Vinkius and provide the specific Mastodon instance URL and your access token.
2. Next, you ask your AI client a question—for example, 'What are people saying about #AI today?' or 'Show me trending news links.'
3. Finally, your agent executes the necessary tool calls (like `get_posts_by_hashtag` or `get_trending_links`) and returns structured data directly to you.

## Frequently Asked Questions

**How do I know if a hashtag is actually popular using Mastodon Intelligence MCP?**
You run the `get_trending_hashtags` tool. This provides usage counts based purely on community activity, so you get a reliable measure of current interest.

**Does Mastodon Intelligence MCP track deleted posts?**
No, this MCP pulls public data from the live network feed and trending lists. It doesn't have access to private or deleted content.

**What is the difference between `get_public_timeline` and getting general trends?**
`get_public_timeline` shows a continuous, real-time stream of all public activity. Trends show you what specific topics are spiking or being shared most often right now.

**Can I use Mastodon Intelligence MCP to track discussions about my company?**
Yes, simply run `get_posts_by_hashtag` using a relevant hashtag like #MyCompanyName. You'll see all the public conversations around that topic.

**What kind of data does `get_trending_links` provide?**
This tool gives you the titles and sources of external articles or news stories that are currently receiving the highest number of shares and mentions across the network.