# Mention MCP

> Mention monitors brand mentions across social media, blogs, and news in real time. It lets your AI client track sentiment, spot negative buzz, and monitor competitors automatically. You can set up keyword alerts or search for specific content without leaving your chat window.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** brand-monitoring, social-listening, sentiment-analysis, media-tracking, reputation-management, competitor-analysis

## Description

**Mention lets your AI client monitor brand mentions across social media, blogs, and news sources in real time.** You can set up triggers to watch for specific topics or phrases, letting you catch negative buzz or track competitor moves without even leaving your chat window. 

**Setting Up Your Watches (Alerts)**

You don't have to manually check everything; you just need to tell the system what to look for. You use `create_monitoring_alert` when you want to set up a new keyword alert, telling it exactly which topic or phrase needs tracking. Once that’s done, you can run `list_monitoring_alerts` to pull up a list of every single monitoring alert you've got active. If you need to change what you're watching, you first check the details using `get_alert_details`, and when you're done with a topic, you use `remove_monitoring_alert` to delete that specific trigger.

**Checking Your Alert Performance**

It ain't just about knowing *if* something was mentioned; it's about how big the deal was. You can check the reach metrics—the number of people who saw or talked about a topic—by calling `get_alert_statistics`. This gives you hard numbers on an alert’s visibility. If you wanna see what alerts are running right now, simply call `list_active_webhooks` to list all event configurations set up for pushing data out to other services.

**Searching the Feed and Deep Diving into Mentions**

Want a quick look at everything that went down in the last hour? Run `list_recent_mentions`; it pulls a feed of every mention found across all sources into one spot. If you're hunting for something specific, forget scrolling—you run `search_mentions_by_keyword`, which performs a targeted search across all monitored sites using your custom word or phrase. When you see a mention that looks important—maybe it’s a great piece of PR or some negative garbage—you can use `favorite_mention` to flag it so you won't lose it later.

When you pull up any single mention, you get the full rundown using `get_mention_content`. This reads all the details for that specific post: where it came from (the source), what it says (the text), and exactly when it went live (the timestamp). When you've reviewed a piece of content, you run `mark_mention_as_read` to change its status in your dashboard.

**Analyzing the Tone and Tracking Findings**

Getting the raw text is only half the job. With any mention you pull up using `get_mention_content`, your agent can give you real-time analysis of the tone—whether it's positive or negative. You can also track all the alerts you’ve set up by calling `list_monitoring_alerts` to see a clear overview, and if you need to confirm basic account info for reporting purposes, just run `get_my_profile`. If your system is tied into other tools that need constant data feeds, you use `list_active_webhooks` to verify all the event configurations are running smoothly.

## Tools

### create_monitoring_alert
Sets up a new keyword alert, telling the system exactly what topic or phrase to watch for.

### favorite_mention
Flags an important mention in your feed so you can easily find it later.

### get_alert_details
Retrieves specific information and status updates about a monitoring alert you already have running.

### get_alert_statistics
Checks the reach metrics, giving you numbers on how many people saw or talked about an alert topic.

### get_mention_content
Reads all the details of a specific mention found online—the source, text, and timestamp.

### get_my_profile
Pulls basic account information for confirmation or reporting purposes.

### list_active_webhooks
Lists all the event configurations currently set up to push data to external services.

### list_monitoring_alerts
Shows a list of every monitoring alert you've created and which ones are still active.

### list_recent_mentions
Pulls the most recent mentions found across all sources into one view.

### mark_mention_as_read
Changes the status of a mention in your dashboard, indicating that you have reviewed it.

### remove_monitoring_alert
Deletes an alert from your system when you no longer need to track that specific keyword or topic.

### search_mentions_by_keyword
Performs a targeted search across all monitored sources for a specific word or phrase.

## Prompt Examples

**Prompt:** 
```
Show recent mentions for the 'Vinkius Launch' alert.
```

**Response:** 
```
Alert 'Vinkius Launch': 145 mentions in 24h. Sources: Twitter (89), News (34), Blogs (22). Sentiment: 78% Positive 🟢, 20% Neutral ⚪, 2% Negative 🔴. Top mention: TechCrunch article ('Vinkius redefines AI agents').
```

**Prompt:** 
```
List all active alerts and their mention volumes.
```

**Response:** 
```
Active Alerts: 4. 1) 'Brand Name' (1,240 mentions/week). 2) 'Competitor X' (3,400 mentions/week). 3) '#IndustryConf2024' (890 mentions). 4) 'CEO Name' (45 mentions). Total volume: 5,575. Unread mentions: 342.
```

**Prompt:** 
```
Show negative mentions from the last 2 days.
```

**Response:** 
```
Found 12 negative mentions. 1) @user (Twitter): 'Support is taking too long to reply.' 2) Reddit (/r/saas): 'Pricing update is confusing.' 3) Blog review: 'Great features, but UX needs work.' Would you like to read the full Reddit thread?
```

## Capabilities

### Search for specific content
Use `search_mentions_by_keyword` to instantly find mentions matching custom keywords across all tracked sources.

### Manage keyword alerts
Create, list, and delete monitoring alerts using tools like `create_monitoring_alert` or `list_monitoring_alerts` to set up triggers for specific topics.

### Analyze mention sentiment
Get real-time analysis of the tone (positive/negative) from any retrieved mention content via tools like `get_mention_content`.

### Review and track findings
Use `list_recent_mentions` to pull a feed of all recent mentions, or call `get_alert_details` for specific alert metrics.

## Use Cases

### Crisis Management: Catching the first whiff of trouble.
A PR manager suspects a product failure is causing chatter. Instead of manually checking Twitter, they ask their agent to 'Find all mentions related to overheating.' The agent runs `search_mentions_by_keyword`, which immediately returns 50 negative hits from niche blogs and forums. They then use `get_mention_content` on the top three to draft a statement.

### Competitor Analysis: Tracking market share shifts.
A marketing team wants to see if Competitor X's new campaign is getting traction. They ask their agent to 'Compare our brand mentions vs. theirs.' The agent runs `list_monitoring_alerts` and compares the resulting metrics, showing a 40% spike in competitor volume over the last week.

### Post-Launch Review: Measuring immediate public reaction.
After a major product launch, a support lead needs to know if the feature worked. They ask their agent to 'Check sentiment around the new dashboard.' The agent runs `list_recent_mentions` and provides a breakdown showing 65% positive vs. 20% negative mentions, directing them to read the flagged issues.

### Ongoing Monitoring: Setting up passive surveillance.
A brand manager needs to track industry trends for Q3 planning. They ask their agent to 'Start tracking discussions about AI ethics.' The agent uses `create_monitoring_alert` with the appropriate keywords, setting the system up to automatically flag any future discussion.

## Benefits

- Get full visibility into negative buzz. Use `get_alert_statistics` to see the volume and reach of mentions related to a topic before it becomes a PR crisis.
- Stop hunting for details. Call `search_mentions_by_keyword` when you need to find all references to 'Product X' from six months ago, regardless of source.
- Know what needs attention right now. Use `list_recent_mentions` with your AI client to immediately pull a digest of everything happening in the last few hours.
- Manage alerts without leaving chat. You can call `create_monitoring_alert` and instantly set up tracking for a competitor or industry hashtag, all through conversation.
- Keep records clean. Once you've analyzed a mention using `get_mention_content`, use `mark_mention_as_read` to signal that it's been addressed.

## How It Works

The bottom line is: you talk to your AI client like it's an employee who just pulled up your brand monitoring dashboard for you.

1. Subscribe to the Mention server and provide your Access Token and Account ID.
2. Your AI client connects this data stream—you tell it, 'Find out what people are saying about our new product launch.'
3. The agent runs the necessary tools (like `search_mentions_by_keyword`) and returns a summarized report with sources, sentiment scores, and top mentions.

## Frequently Asked Questions

**How do I set up monitoring alerts with Mention MCP Server?**
You use the `create_monitoring_alert` tool. You just tell your agent what keywords to watch for (e.g., 'pricing update'), and it handles setting up the persistent tracking.

**What is the difference between list_recent_mentions and search_mentions_by_keyword?**
Listing recent mentions shows a time-based feed of *everything* that happened. Searching by keyword lets you filter the entire historical data set for one specific phrase, no matter when it was posted.

**Can I check competitor performance with Mention MCP Server?**
Yes. You can create alerts and use `get_alert_statistics` to track mentions related to competitors, allowing you to compare their volume against your own brand's activity.

**How do I see if an alert is still working?**
You run the `list_monitoring_alerts` tool. This shows all active alerts and allows you to use `get_alert_details` on any specific one to check its current status and metrics.

**How do I check if my API access is valid using `get_my_profile`?**
Calling `get_my_profile` confirms your current account credentials and basic usage limits. It returns key details about your profile, confirming that the system recognizes your connection token and providing insight into your overall monitoring quota.

**What extra data do I get when using the `get_mention_content` tool?**
You receive the full context of a mention, not just a snippet. This includes the source URL, the complete body text, and metadata like the exact time it was posted. You can analyze the content thoroughly.

**How do I access deep performance metrics using `get_alert_statistics`?**
This tool gives you quantitative reach data beyond simple counts. It provides metrics on total impressions, unique sources, and time-based volume shifts. This helps you measure the true impact of your brand mentions.

**What happens when I run `remove_monitoring_alert`?**
The tool immediately deletes the specified alert configuration from your account. Once removed, the system stops tracking and processing any data for that specific keyword or competitor set.

**Can I monitor specific keywords and brands?**
Yes. Create alerts with boolean queries to track specific brand names, competitors, or industry hashtags.

**How does Mention authentication work?**
Mention requires both an **Access Token** (Bearer) and an **Account ID** against `api.mention.net/api/v1`.

**Does Mention provide sentiment analysis?**
Yes. Mentions are automatically tagged with positive, negative, or neutral sentiment scores.