Mentionova MCP Server

Connect AI assistants to your Mentionova data. Query workspaces, prompts, runs, citations, brand mentions, and more directly from Claude Code, Claude Desktop, or any MCP-compatible client.

Prerequisites

• A Mentionova account on a Scale plan or higher
• An API key (create one at Settings > API in the Mentionova dashboard)
• Node.js 18+

Setup

Claude Code

Add to your Claude Code settings (~/.claude/settings.json or project-level .claude/settings.json):

{
  "mcpServers": {
    "mentionova": {
      "command": "npx",
      "args": ["-y", "@mentionova/mcp-server"],
      "env": {
        "MENTIONOVA_API_KEY": "mn_live_your_key_here"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on Mac):

{
  "mcpServers": {
    "mentionova": {
      "command": "npx",
      "args": ["-y", "@mentionova/mcp-server"],
      "env": {
        "MENTIONOVA_API_KEY": "mn_live_your_key_here"
      }
    }
  }
}

Then restart Claude Code or Claude Desktop.

Available Tools

| Tool | Description | |------|-------------| | mentionova_list_workspaces | List all workspaces in your organization | | mentionova_get_workspace | Get details for a specific workspace | | mentionova_list_prompts | List tracked prompts (search queries) in a workspace | | mentionova_list_runs | List prompt executions with status and channel results | | mentionova_list_citations | List URLs cited by AI engines, with filters | | mentionova_list_mentions | List verified brand mentions and recommendations | | mentionova_list_pages | List tracked pages from citations and GSC | | mentionova_list_grids | List content grids in a workspace | | mentionova_list_alerts | List notifications and alerts | | mentionova_list_contacts | List enriched contacts for cited domains |

Example Usage

Once connected, just ask your AI assistant naturally:

• "List my Mentionova workspaces"
• "Show me the latest citations for workspace [name]"
• "Which prompts are active in [workspace]?"
• "Get all ChatGPT citations from the last 7 days"
• "Show brand mentions for the most recent run"

API Key Permissions

Your API key's permissions control which tools are available. Configure read/write access per resource in Settings > API in the Mentionova dashboard.

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | MENTIONOVA_API_KEY | Yes | Your Mentionova API key (mn_live_...) | | MENTIONOVA_BASE_URL | No | API base URL (default: https://app.mentionova.com) |