# CrowdTangle MCP

> CrowdTangle connects your AI client to public social media insights from Meta. Track viral posts, monitor how specific links are shared across platforms, and analyze account engagement leaderboards using natural language queries.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** social-listening, trend-tracking, viral-content, public-insights, media-monitoring, data-aggregation

## Description

This MCP lets you pull raw data on what's actually happening in public social feeds. You can monitor trends by searching for recent posts—not just the content, but which accounts posted it and how those posts performed. Need to know if a competitor is talking about your brand? Use this tool to see who has shared specific URLs across platforms. It also lets you find out which posts are truly performing well versus what was expected. You can even check account leaderboards to rank key players in an industry. If you're managing complex data flows, Vinkius makes it easy to connect this social listening power with your existing AI workflow.

## Tools

### get_account_details
Retrieves basic metadata about your CrowdTangle account setup and configuration limits.

### get_account_leaderboard
Resolves a ranking of accounts in your specified lists, detailing their total interactions and average engagement rates.

### get_link_shares
Identifies which tracked public accounts shared a specific URL and how many total interactions that share generated.

### get_post_details
Retrieves full engagement information for one post, including reaction breakdowns and platform-specific data points.

### get_top_performing_posts
Determines the highest performing posts by calculating their score—the difference between actual and expected interactions.

### list_monitored_lists
Lists every account tracking list you have set up, including the names and number of accounts in each one.

### list_media_posts
Generates a list of recent posts that contain photos or videos, along with their content types and captions.

### list_recent_posts
Lists all recently tracked social media posts by platform, account name, and basic engagement metrics like likes or shares.

### search_tracking_lists
Searches for specific tracking lists using a title filter to quickly locate the right dataset.

### search_posts_by_keyword
Finds all relevant posts across supported platforms by searching them with a specific keyword or phrase.

## Prompt Examples

**Prompt:** 
```
Search for recent viral posts about 'Electric Vehicles' on Instagram.
```

**Response:** 
```
I've found 5 top-performing posts about 'Electric Vehicles'. One post from 'TechDaily' is overperforming by 5x with 12,000 likes and 450 comments. Would you like to see the post URL?
```

**Prompt:** 
```
Who has shared the link 'https://vinkius.com/blog/mcp-server' recently?
```

**Response:** 
```
That link has been shared by 3 public Facebook pages: 'AI News', 'Tech Trends', and 'Developer Hub'. Total interactions from these shares is 1,200. Should I list the individual share details?
```

**Prompt:** 
```
Show me the engagement leaderboard for my 'Competitors' list.
```

**Response:** 
```
On your 'Competitors' list, 'Brand X' is currently leading with 45,000 total interactions this week, followed by 'Brand Y' with 32,000. 'Brand Z' saw a 15% dip in engagement. Would you like to see their top post?
```

## Capabilities

### Identify high-performing content
Find the most viral posts by comparing actual engagement metrics against expected performance scores.

### Track link sharing sources
Determine exactly which public accounts and pages have shared a specific URL, along with their total interaction count.

### Search and monitor posts by keyword
Query across multiple platforms to find all recent social media posts that mention a specific topic or phrase.

### Analyze account rankings
Get an engagement leaderboard for your monitored accounts, showing total interactions and average performance rates.

### List all tracked content
Retrieve lists of media posts containing photos or videos, along with general recent post activity across supported platforms.

## Use Cases

### A PR crisis requires immediate monitoring
The team needs to know if negative sentiment is spreading after an announcement. They ask their agent to run a search for posts by keyword using 'product recall' and then use get_top_performing_posts to immediately identify the most volatile and highest-engagement complaints.

### Analyzing campaign effectiveness
Marketing wants to know which piece of content is driving traffic. They feed a specific landing page URL into the MCP, run get_link_shares, and instantly see that 'TechReviewBlog' was responsible for 60% of all shares and interactions.

### Competitive analysis on product features
A researcher wants to map out industry chatter. They use list_recent_posts to pull a broad overview, then filter by 'competitor X' using search_posts_by_keyword and run get_account_details for the main competitor accounts.

### Identifying key influencers in a niche
A brand needs to find its top advocates. They check their existing lists with list_monitored_lists, then use get_account_leaderboard to rank the members and pinpoint who has the highest average engagement rate.

## Benefits

- Stop guessing which content is popular. Use get_top_performing_posts to see the actual performance score, identifying posts that genuinely went viral versus those that just got lucky.
- Need to know who's talking? Running get_link_shares shows you every public account that shared a specific URL, giving immediate credit and context for every share.
- Keep your focus tight with list_monitored_lists. You can quickly see all the competitor or topic lists you’ve set up without digging through settings menus.
- Track conversations in real-time using search_posts_by_keyword. Instead of checking feeds manually, just ask your agent to find everything related to 'AI ethics' across platforms.
- Understand market dynamics by running get_account_leaderboard. This gives you a clear ranking of key accounts based on overall interaction rates.

## How It Works

The bottom line is you get actionable intelligence on public discourse without having to manually check multiple social dashboards.

1. Connect the CrowdTangle MCP to your AI client and authorize it using your API Token.
2. Directly ask your agent to analyze public social media data, such as 'Show me all posts about renewable energy last week.'
3. Receive a structured report detailing which accounts posted the content, how many people interacted with it, and whether the post was genuinely viral.

## Frequently Asked Questions

**How does CrowdTangle help me find viral posts?**
It calculates a performance score for every post, letting you identify content that genuinely outperformed expectations. You use get_top_performing_posts to see these high-scoring pieces.

**Can I track who shared my link using CrowdTangle?**
Yes. Use the get_link_shares tool, and it resolves which tracked accounts shared your specific URL along with their total interactions generated from that share.

**Is this MCP only for large companies?**
No. The tools allow you to monitor any public account list you create; you can track small niche communities or massive competitor accounts alike using list_monitored_lists.

**What if I want posts about a certain topic but don't know the keywords?**
You can still use search_posts_by_keyword. While it works best with specific phrases, you can also refine your initial searches using list_recent_posts to narrow down content types.

**How do I see all the available accounts to monitor?**
Start by running list_monitored_lists. This shows you every tracking list ID and name, plus how many accounts are in each one.