@maelitop/mention-mcp-server

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 MIT License.

Changelog

[1.4.0] - 2025-06-29

Added

• New Tool: fetch_alert_stats - Retrieve comprehensive alert statistics
  • Flexible date range filtering with from, to, and timezone parameters
  • Aggregation by interval: daily (P1D), weekly (P1W), monthly (P1M)
  • Multi-dimensional filtering by tones, languages, sources, countries, tags
  • Statistical analysis with favorite, important, and author influence filtering
  • Geographic insights with configurable country_stats (top N countries)
  • Temporal analysis with week_day_stats and week_day_by_hour_stats
  • Influencer tracking and reach metrics per interval