Skip to main content
MentionScout ships a Model Context Protocol (MCP) server, so you can pull your AI visibility data straight into Claude Code or any other MCP client. Ask questions like “what changed since yesterday?” and let the assistant read your mentions, runs, citations, and answer gaps, or even create and edit the prompts you track.
The AI access settings page showing the create-token form and the list of existing MCP tokens.

​
How it works

You connect a client in two parts:
  • The MCP endpoint is your MentionScout URL with /mcp on the end (for example https://your-mentionscout-domain/mcp). The transport is HTTP.
  • A token authenticates the client as you. You pass it as a bearer token in the Authorization header.
All access is scoped to your own workspaces, and reads default to your currently selected website. Find the page under Settings > AI access.

​
Create a token

1

Open AI access

Go to Settings > AI access.
2

Name the client

Under Create a token, enter a Token name that identifies where it will live, for example Claude Code · MacBook. The name is just a label, so you can recognise and revoke the right token later.
3

Choose an access level

Pick Read only or Read & write (see below), then click Create token.
4

Copy the token now

A card appears with a ready-to-paste connect command and a Copy command button. Copy it immediately.
Tokens are shown once. After you leave the page the plaintext token is gone and cannot be recovered. If you lose it, revoke the token and create a new one.

​
Access levels

Read only (view data) lets the client read your data: prompts, runs, mentions, citations, answer gaps, community sources and social mentions, crawler analytics, and your brand profile. It cannot change anything. Use this for monitoring, reporting, and analysis.
Write access only covers prompt creation and edits. It does not delete data or change billing or account settings.

​
Connect a client

​
Claude Code

The fastest path is the command shown on the AI access page after you create a token. It looks like this: 
claude mcp add --transport http mentionscout https://your-mentionscout-domain/mcp --header "Authorization: Bearer YOUR_TOKEN"
Paste it into your terminal. Claude Code registers a server named mentionscout, and the MentionScout tools become available in your next session.
Copy the exact command from the page rather than typing it. It already contains your endpoint URL and the freshly created token.

​
Other MCP clients

Any client that supports the streamable HTTP transport can connect with the same endpoint and header. Add an entry like this to your client’s MCP server configuration: 
{
  "mcpServers": {
    "mentionscout": {
      "type": "http",
      "url": "https://your-mentionscout-domain/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}
Once connected, the server identifies itself as MentionScout and exposes a set of tools and guided prompts. The client suggests calling list-websites first to discover your website IDs; every tool then accepts an optional website_id and defaults to your selected website when you omit it.

​
Manage tokens

The AI access page lists every token you have created. Each row shows the token name, a badge for its access level (Read only or Read & write), when it was created, and when it was last used. To remove access, click the trash icon next to a token and confirm. Revocation is immediate: any client using that token loses access right away. Create a new token to reconnect.
Connecting more clients does not affect your data. Each token is independent, so you can keep one per machine or tool and revoke them individually.

​
Next steps

MCP tools

See every tool the server exposes, what each returns, and how to use them for daily monitoring.

Account settings

Manage your profile and the rest of your account settings.
Last modified on June 26, 2026