About Mention MCP Server
Mention MCP Server exposes Mention API social listening and monitoring operations for teams managing alerts and mention data. It supports alert creation and controls, filtered mention retrieval, and alert statistics.
Key features
- 01Retrieve account and app data
- 02List and inspect monitoring alerts
- 03Create basic or advanced alerts
- 04Update, pause, and resume alerts
- 05Filter mentions and retrieve statistics
Use cases
- 01Check account and subscription details
- 02Set up keyword-based brand monitoring
- 03Adjust or pause existing alerts
- 04Review filtered mentions and alert statistics
MCP support
The MCP server exposes Mention API account, alert, mention, and statistics operations as tools for MCP clients.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEMention MCP Server
A production-ready Model Context Protocol (MCP) server for social listening and monitoring through the Mention API. Built with TypeScript, comprehensive error handling, structured logging, and modular architecture.
Supported Tools
| Tool | Description |
|---|---|
get_account_info | Retrieve account details and subscription plan |
get_app_data | Get available languages, countries, sources |
list_alerts | List all monitoring alerts with pagination |
get_alert | Get detailed information about specific alerts |
create_basic_alert | Create alerts with simple keyword matching |
create_advanced_alert | Create alerts with boolean query syntax |
update_alert | Modify existing alert criteria and settings |
pause_alert | Temporarily pause monitoring for specific alerts |
unpause_alert | Resume monitoring for paused alerts |
fetch_mentions | Retrieve mentions with advanced filtering |
fetch_alert_stats | Get comprehensive statistics for alerts |
Installation & Usage
Quick Start with Claude Desktop
Add the following to your Claude Desktop configuration file:
{
"mcpServers": {
"mention": {
"command": "npx",
"args": ["-y", "@maelitop/mention-mcp-server"],
"env": {
"MCP_MENTION_API_KEY": "your_mention_api_key_here"
}
}
}
}
Environment Variables
| Variable | Description | Default |
|---|---|---|
MCP_MENTION_API_KEY | Your Mention API key (required) | - |
MCP_MENTION_API_BASE_URL | Custom API base URL | https://web.mention.com/api |
MCP_LOG_LEVEL | Logging level (debug, info, warn, error) | info |
MCP_CONSOLE_LOGGING | Enable console logging (true/false) | false |
MCP_REQUEST_TIMEOUT | Request timeout in milliseconds | 30000 |
MCP_MAX_RETRIES | Maximum retry attempts | 3 |
Development
# Install dependencies
npm install
# Run in development mode
npm run dev
# Run tests
npm test
# Build for production
npm run build
# Run linting and type checking
npm run ci
Logging
Logs are automatically written to platform-specific directories:
- macOS:
~/Library/Logs/mention-mcp-server/mention-mcp-server.log - Windows:
~/AppData/Local/mention-mcp-server/logs/mention-mcp-server.log - Linux:
~/.local/share/mention-mcp-server/logs/mention-mcp-server.log
Testing
# Run all tests
npm test
# Run tests with coverage
npm run test:coverage
# Run tests in watch mode
npm run test -- --watch
License
This project is licensed under the MIT License.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.