mention-mcp-server

MaelitoP/mention-mcp-server

3.2

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

  1. get_account_info

    Retrieve account details and subscription plan

  2. get_app_data

    Get available languages, countries, sources

  3. list_alerts

    List all monitoring alerts with pagination

  4. get_alert

    Get detailed information about specific alerts

  5. create_basic_alert

    Create alerts with simple keyword matching

  6. create_advanced_alert

    Create alerts with boolean query syntax

  7. update_alert

    Modify existing alert criteria and settings

  8. pause_alert

    Temporarily pause monitoring for specific alerts

  9. unpause_alert

    Resume monitoring for paused alerts

  10. fetch_mentions

    Retrieve mentions with advanced filtering

  11. fetch_alert_stats

    Get comprehensive statistics for alerts

Mention MCP Server

License: MIT NPM Version NPM Downloads

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

ToolDescription
get_account_infoRetrieve account details and subscription plan
get_app_dataGet available languages, countries, sources
list_alertsList all monitoring alerts with pagination
get_alertGet detailed information about specific alerts
create_basic_alertCreate alerts with simple keyword matching
create_advanced_alertCreate alerts with boolean query syntax
update_alertModify existing alert criteria and settings
pause_alertTemporarily pause monitoring for specific alerts
unpause_alertResume monitoring for paused alerts
fetch_mentionsRetrieve mentions with advanced filtering
fetch_alert_statsGet 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

VariableDescriptionDefault
MCP_MENTION_API_KEYYour Mention API key (required)-
MCP_MENTION_API_BASE_URLCustom API base URLhttps://web.mention.com/api
MCP_LOG_LEVELLogging level (debug, info, warn, error)info
MCP_CONSOLE_LOGGINGEnable console logging (true/false)false
MCP_REQUEST_TIMEOUTRequest timeout in milliseconds30000
MCP_MAX_RETRIESMaximum retry attempts3

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 .