MaelitoP/mention-mcp-server
3.1
If you are the rightful owner of mention-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Mention MCP Server is a robust solution for social listening and monitoring, leveraging the Mention API to provide comprehensive insights and alerts.
Tools
11
Resources
0
Prompts
0
Mention 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 .