# Mention MCP

> Mention MCP connects your social listening and brand monitoring data directly to your AI client. Track every mention, analyze public sentiment, and get real-time alerts across all channels simply by talking to your agent. Stop checking dashboards; start having conversations.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** brand-monitoring, social-listening, alerting, sentiment-analysis, media-tracking

## Description

Monitoring what people are saying about your brand used to mean juggling ten different platforms and manually compiling reports. Now, you connect Mention to any AI client through Vinkius, giving your agent complete control over social monitoring and brand alerts. Instead of digging through feeds, you just ask your agent questions. You can list all active alerts or search for specific topics across thousands of mentions. Need to know how the conversation is trending? Your agent runs a sentiment analysis on recent posts, letting you see volume stats instantly. It’s about turning massive amounts of public chatter into actionable insights without ever leaving your chat window.

## Tools

### get_account_info
Retrieves high-level information about the main Mention account settings.

### get_alert
Fetches specific configuration details for a single monitoring alert you manage.

### get_alert_statistics
Provides key performance metrics, like total mention volume, for any given alert.

### get_mention_details
Pulls the full content, source metadata, and sentiment analysis for a single public post.

### list_account_users
Shows who has access to the account by listing associated users.

### list_alerts
Retrieves a comprehensive list of all active and inactive monitoring alerts you have set up.

### list_connected_external_accounts
Lists which external social media accounts are currently linked to the Mention dashboard.

### list_favorite_mentions
Retrieves a curated list of mentions you have specifically marked as favorites for an alert.

### list_mentions
Lists the most recent social media mentions tied to a specific monitoring alert.

### search_mentions
Searches through all historical and current mentions using custom text keywords.

## Prompt Examples

**Prompt:** 
```
List all active alerts in my Mention account.
```

**Response:** 
```
Retrieving alerts... I found 3 active alerts including 'Brand Monitor', 'Competitor A', and 'Industry Trends'.
```

**Prompt:** 
```
Search mentions for 'artificial intelligence' in alert ID 123.
```

**Response:** 
```
Searching mentions... I found 5 recent posts mentioning AI in your brand alert stream.
```

**Prompt:** 
```
Show volume statistics for my primary brand alert.
```

**Response:** 
```
Calculating statistics... You had 150 mentions today, a 10% increase compared to yesterday.
```

## Capabilities

### Manage Brand Alerts
List all monitoring alerts and grab detailed metadata for any specific alert configuration.

### Search and Retrieve Mentions
Pull recent social media mentions, search by keyword, or filter the list down to your favorites.

### Analyze Mention Details
Get full content, metadata, and sentiment scores for any single mention you point out.

### Measure Brand Performance
Access volume and sentiment statistics for your alerts to track changes over time.

### Audit Account Access
List all authorized users or connected social media accounts associated with the Mention profile.

## Use Cases

### Crisis Response
A PR manager notices a spike in negative chatter. They ask their agent to list mentions, filter for those mentioning the product name, and then run get_mention_details on the top five results to understand the core complaint.

### Campaign Performance Review
A marketing analyst wants to measure a new campaign's reach. They ask their agent to check brand analytics for the associated alert, seeing volume and sentiment statistics that prove the campaign moved the needle compared to last quarter.

### Competitive Analysis
The team needs to know what competitors are doing. They use search_mentions to track competitor names alongside their brand name, allowing them to see how often the discussion shifts from your company to theirs.

### Account Health Check
A new employee joins the team and needs access. The agent runs list_account_users to confirm who has permissions, while also checking list_connected_external_accounts to ensure all necessary social channels are linked.

## Benefits

- Instant Sentiment Scoring: When you need to know if people are happy or angry, your agent runs deep inspection on specific mentions and provides an immediate sentiment score. You don't read thousands of comments; you get the consensus.
- Track Everything at Once: Instead of checking separate dashboards, simply ask your agent to list all monitoring alerts, and it gives you a single overview of every brand conversation happening.
- Deep Dive Data Access: Need more than just the text? Use get_mention_details to fetch full content, metadata, and detailed analysis for any post. It's the complete picture in one go.
- Measure Trends Instantly: When you want hard numbers, ask your agent about brand analytics; it gives volume and sentiment statistics instantly, letting you compare performance against yesterday or last month.
- Stay Organized: Keep track of everything with list_favorite_mentions. You can mark the most important posts right in conversation and pull them up later without searching.

## How It Works

The bottom line is that you treat complex social data like a simple conversation with your AI client.

1. First, subscribe to this MCP and enter your unique Mention Access Token and Account ID.
2. Next, connect your preferred AI client—Claude, Cursor, or any compatible agent—to Vinkius.
3. Finally, simply ask your agent to perform an action; it handles the rest of the data retrieval.

## Frequently Asked Questions

**How do I check if a specific alert is active with Mention MCP?**
You can use list_alerts to see all your monitoring alerts and verify their current status. This gives you a quick overview of everything that's running.

**Can Mention MCP search for mentions across different topics?**
Yes, the search_mentions tool lets you run keyword searches across various topics. You can combine keywords to track complex narratives or multiple product lines at once.

**What if I want to see how my brand performance has changed? Do I use Mention MCP?**
You should use the get_alert_statistics tool. This pulls volume and sentiment statistics for your alerts, letting you measure changes over time accurately.

**Does list_account_users help with security on Mention MCP?**
Absolutely. Using list_account_users lets you see exactly who has access to the account, which is crucial for maintaining proper internal controls and data security.

**How do I analyze a single mention's sentiment using Mention MCP?**
You use get_mention_details. This tool fetches all the necessary context—the full content, metadata, and the detailed sentiment score for that one specific post.