Mention MCP Server
Monitor web and social media using the Mention API.
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.
Server Terkait
Bright Data
sponsorDiscover, extract, and interact with the web - one interface powering automated access across the public internet.
JCrawl4AI
A Java-based MCP server for interacting with the Crawl4ai web scraping API.
GasBuddy MCP Price Tracker
MCP server to get the cheapest gas prices in a particular city or zip code from gasbuddy.com
Opengraph.io
Opengraph data, web scraping, screenshot features in a handy MCP tool
Fetch
Fetch web content as HTML, JSON, plain text, or Markdown.
Github to MCP
Convert GitHub repositories to MCP servers automatically. Extract tools from OpenAPI, GraphQL & REST APIs for Claude Desktop, Cursor, Windsurf, Cline & VS Code. AI-powered code generation creates type-safe TypeScript/Python MCP servers. Zero config setup - just paste a repo URL. Built for AI assistants & LLM tool integration.
Yahoo Finance
Provides comprehensive financial data from Yahoo Finance, including historical prices, company info, financial statements, and market news.
Yanyue MCP
Fetches cigarette data and information from Yanyue.cn.
Puppeteer
Provides browser automation using Puppeteer, enabling interaction with web pages, taking screenshots, and executing JavaScript.
Simple MCP Tool Server
A simple MCP server that provides a tool for fetching website content using SSE transport.
Puppeteer MCP Server
Automate browser interactions using Puppeteer, controlling new or existing Chrome instances.