Skip to main content

​
Overview

MentionLab provides a remote MCP (Model Context Protocol) server that lets you work with your brand analytics directly from AI tools like Claude, Cursor, and Windsurf. It is a hosted, remote server — there is nothing to install and no local process to run. You point your client at a URL, sign in through MentionLab, and your assistant can manage projects, queries, entities and tags, and query every analytics surface in plain language.
The MCP server is currently in beta and is subject to breaking changes.

​
Server URL

Some clients cap how many tools they will load. For those, use the lean URL instead — see Choosing a URL.

​
Authentication

The server uses OAuth 2.1 with dynamic client registration and PKCE. On first connection your client opens a browser window, you sign in to MentionLab and approve access, and the client stores the token. There are no API keys to create and nothing to paste. Your assistant sees exactly what your MentionLab account sees — the same organizations, projects and permissions. To revoke access, disconnect the server in your client.

​
Connect your client

Claude Desktop, Claude web and the Claude mobile apps all connect the same way — as a custom connector. There is no config file to edit.
  1. Open Settings → Connectors.
  2. Click Add custom connector.
  3. Paste the URL:
  4. Click Add, then Connect and sign in to MentionLab when the browser opens.
The connector then appears in the attachments menu of any chat.

​
Choosing a URL

The server exposes a large tool surface. Which URL you use decides how much of it is loaded up front — the capabilities themselves are identical either way.
Nothing is lost on the lean profile. The assistant can find any hidden tool with search_tools, load it with describe_tool, or call it directly through run_code. If your client shows a truncated tool list or complains about too many tools, switch to the lean URL.

​
Example usage

Once connected, work in plain language:
“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’.”
Ask the assistant to call guide first when starting a bigger analysis. It returns the domain model and a set of workflow playbooks, which makes the follow-up answers noticeably better.

​
Troubleshooting

Your client is not persisting the OAuth token. Reconnect the server; if it keeps happening, remove and re-add it so a fresh client registration is issued.
Switch to https://mcp.mentionlab.io/mcp?profile=lean.
The access token expired or was revoked. Disconnect and reconnect the server to re-authorize.
Ask the assistant to re-run the same call inside run_code and aggregate there, so only the summary comes back.

​
Next steps

REST API

Learn the basics of the MentionLab REST API.

Core Concepts

Understand projects, queries, entities, and tags.