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.
Serveurs connexes
Bright Data
sponsorDiscover, extract, and interact with the web - one interface powering automated access across the public internet.
Automatic MCP Discovery
AI powered automation toolkit which acts as an agent that discovers MCP servers for you. Point it at GitHub/npm/configure your own discovery, let GPT or Claude analyze the API or MCP or any tool, get ready-to-ship plugin configs. Zero manual work.
YouTube Transcript Extractor
Extracts transcripts from public YouTube videos.
Monad MCP Magic Eden
Retrieve NFT data from the Monad testnet, including holder addresses, collection values, and top-selling collections.
scraping-api-marketplace
Real-time product data from Amazon, eBay, Walmart, Kaufland and many others — directly inside your AI assistant
Fetch as Markdown MCP Server
Fetches web pages and converts them to clean markdown, focusing on main content extraction.
getsonar-mcp
KYB due diligence, competitive intelligence, and strategic accounts research for AI agents. KYB covers corporate registries, sanctions screening (OFAC/UN/EU/UK), FCA Register lookup, directors, UBOs, and adverse media. CI covers pricing, hiring, product, sentiment, and corporate events. New accounts get 3 free trial calls. Pay-per-call after: $0.40 per /findings, $2.00 per /run with Claude analysis. Top up from $20 at getsonar.report.
Crawl4AI RAG
Integrate web crawling and Retrieval-Augmented Generation (RAG) into AI agents and coding assistants.
ShopGraph
Structured product data from the open web — where platform APIs don't reach. Schema.org + AI extraction. Pay per call via Stripe MPP.
XPath MCP Server
Execute XPath queries on XML content.