Mention MCP Server

from MaelitoP

Monitor web and social media using the Mention API.

🔥🔥🔥✓ VerifiedPaid serviceNeeds API keys

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

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.

Copy & paste — that's it

# 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

Before it works, you'll need: MCP_MENTION_API_KEY

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