Add ScoutRival to Claude Code.

Claude Code is the terminal assistant. Add ScoutRival with one command and your tools are available in every session from that project.

3 min read MCP Updated Jul 2026

Claude Code is Anthropic's command-line assistant — it runs in your terminal and works inside a project. Give it a bearer token and it adds ScoutRival as a remote HTTP MCP server, so your tools are available in every session from that project.

// ONE COMMAND

You add the server once with claude mcp add. After that, any Claude Code session in that project can read your briefs, competitors and AI-visibility, and run the paid tools your token allows.

1. Make a token

In ScoutRival, open Settings → MCP and create a connection token. This is a Starter-and-up feature — on the Free plan you'll see an upgrade prompt here instead.

  • Give it a label you'll recognise, for example Claude Code on my laptop.
  • Leave the access level on Read-only to start — it reads everything and spends nothing.
  • The token is shown once. We store only a scrambled copy and can't show it again, so copy it now. If you lose it, revoke it and make a new one. See access tokens for the details.

2. Add the server

1

Add it from the CLI

Run this in your project folder, with your own token in place of sr_mcp_YOUR_TOKEN:

terminalclaude mcp add --transport http scoutrival https://user.scoutrival.com/api/mcp --header "Authorization: Bearer sr_mcp_YOUR_TOKEN"

--transport http tells Claude Code this is a remote HTTP server rather than a local process, and --header carries your bearer token on every request.

2

Choose where it applies

By default the server is added for you in the current project only. Add --scope user to make it available in every project you work in, or --scope project to share it with your team through a committed .mcp.json file. Don't use --scope project with a real token in it — reserve it for team setups where the token is supplied another way.

3

Or hand-edit .mcp.json

If you'd rather edit the file directly, add ScoutRival to the mcpServers block:

.mcp.json{
  "mcpServers": {
    "scoutrival": {
      "type": "http",
      "url": "https://user.scoutrival.com/api/mcp",
      "headers": { "Authorization": "Bearer sr_mcp_YOUR_TOKEN" }
    }
  }
}
// NEVER COMMIT A REAL TOKEN

A .mcp.json committed to a repository is shared with everyone who checks it out. Never commit a real sr_mcp_ token — treat it like any other secret. If one lands in your history, revoke it in Settings → MCP and issue a new one.

3. Verify

Confirm the server is connected:

terminalclaude mcp list

scoutrival should appear as connected. Inside a Claude Code session you can also run /mcp to view the ScoutRival tools it has picked up. If it errors, recheck the URL and the Bearer token, then see troubleshooting — a client will sometimes cache an empty tool list, and toggling the connection or starting a new session makes it re-read the tools.

4. Use it

In a session, ask for something that uses your account:

  • "List my ScoutRival brands."
  • "Today's brief for <your brand>."
  • "How visible am I in AI answers, and what's the top fix?"

Reads are free and return the full dashboard view. Generating content or running a check needs a token with the Content or Full access level — read scopes and access levels before you raise it.

Still stuck?
Contact support

Related

MCP
Quick start — connect in five minutes
MCP
The full tool reference