Skip to main content

​
Overview

MentionLab provides a remote MCP (Model Context Protocol) server that lets you interact with your brand analytics data directly from AI tools like Claude Desktop, Cursor, Windsurf, and others. With the MCP server you can manage projects, queries, entities, tags, and access all analytics — visibility, sentiment, sources, shopping, and more — through natural conversation with your AI assistant.
The MCP server is currently in beta and is subject to breaking changes.

​
Server URL

https://mcp.mentionlab.io/mcp

​
Authentication

The MCP server uses OAuth 2.0 for authentication. When you first connect, your MCP client will open a browser window where you sign in with your MentionLab account. The client handles the token exchange automatically — no API keys or manual configuration needed.

​
Configuration

Add this to your claude_desktop_config.json:
{
  "mcpServers": {
    "mentionlab": {
      "type": "url",
      "url": "https://mcp.mentionlab.io/mcp"
    }
  }
}
On first use, your MCP client will prompt you to sign in via your browser. Once authorized, the session is persisted automatically.

​
Available Tools

The MCP server exposes the same capabilities as the REST API, organized into these categories:
List, get, update, and delete projects. List organisations.
Create, list, update, and delete queries. Get query counts and locales.
Create, list, update, and delete entities. Manage aliases, merge and unmerge entities.
Create, list, update, and delete tags for queries and job executions. Link and unlink tags.
Trigger job executions, list jobs, and get execution details.
Access all analytics endpoints: visibility scores, share of voice, sentiment, sources, shopping, fan-outs, per-query stats, and per-model breakdowns — all with timeseries support.

​
Example Usage

Once connected, you can interact with MentionLab through natural language in your AI assistant:
“Show me my brand’s visibility trend for the last 30 days.”
“Which domains cite my brand most frequently?”
“Compare sentiment across my top 5 competitors.”
“Create a new query: ‘What is the best CRM for startups?’ with the tag ‘Product’.”

​
Next Steps

REST API

Learn the basics of the MentionLab REST API.

Core Concepts

Understand projects, queries, entities, and tags.