Skip to content
MCP · Connect your AI apps

Connect SearchChamp to your AI apps.

Ask Claude or ChatGPT about your rankings, opportunities, and audits — and let them draft, review, and report back — through a secure MCP connector.

What this is

One connector, every SEO surface.

The SearchChamp connector uses the Model Context Protocol (MCP) to give an AI app a secure, read-and-write window into your own workspace — daily briefs, rank movers, opportunities, site audits, AI visibility, and content briefs — without you ever leaving the chat.

MCP Apps preview

Interactive cards, right in the conversation.

When a connector tool call returns SearchChamp data, supporting AI apps can render it as an interactive preview instead of a wall of text. Here is what shows up.

Audit card

A scored summary of your latest site audit — top issues, severity, and what changed since the last run — rendered inline as you chat.

Opportunities board

Your ranked opportunity queue, grouped by source and effort, so you can triage and queue the next fix without leaving the conversation.

Rank movers

The keywords that moved the most since your last check — up and down — with the page and the likely cause.

AI visibility report

Citation presence and sentiment across the AI engines you track, summarized for the site and date range you ask about.

Brief preview

A generated content brief — outline, target keywords, and sourcing notes — ready to hand off or pull into your own editor.

What data leaves SearchChamp

Summaries only — scoped to what you can already see.

  • The connector returns summaries of your own SEO data — briefs, rankings, AI-visibility results, opportunities, audit issues, and backlinks. It never exports raw bulk data.
  • Every result is scoped to the sites and workspace you already have access to — nothing outside your own permissions is ever returned.
  • Connections are authorized via OAuth sign-in and can be revoked at any time from Settings → Connect your AI apps.
  • Requests originate from the AI provider’s own cloud servers — Anthropic for Claude, OpenAI for ChatGPT — not from your device.
  • Every write action — queuing a fix, drafting content, scheduling a rescan — shows you the exact change before it runs and waits for your confirmation. Read-only lookups don’t need confirmation, but nothing that changes data executes silently.
Alternative setup

Connect with a token (all MCP clients).

Prefer a bearer token over OAuth sign-in — or connecting a client that doesn’t support custom connectors, like Cursor? Generate a token in Settings and drop it into any MCP-compatible client. This path trades the full interactive-card experience for something simpler: no sign-in flow, no browser redirect, just a token your client sends as a Bearer header on every request — which is exactly what tools built for automation, like Cursor and Claude Code, expect.

  1. Create a token

    In your SearchChamp workspace, open Settings → MCP Tokens and create one. Name it after the client you’re connecting (e.g. "cursor-dev"), and pick a scope — a single site or your whole org.

  2. Copy the plaintext token

    SearchChamp shows the full token — it starts with atl_mcp_ — exactly once. Copy it now; after you close the dialog only its short prefix (atl_mcp_…) is shown again, never the full token.

  3. Paste the config into your client

    Drop one of the configs below into your MCP client, swap in your token, and reconnect. The client sends it as a Bearer token on every request — no OAuth sign-in needed.

This release exposes a read-only toolset over the token path: get_rankings and get_ai_visibility (Starter plan and up), plus get_audit_issues, get_backlinks_summary, get_content_drafts, and get_volatility (Pro plan and up). More tools — keyword research, article briefs — are coming soon and aren’t usable over this path yet.

Claude Desktop

Add this to claude_desktop_config.json ~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows — then restart Claude Desktop. That file only accepts local (stdio) servers, so the token reaches us through mcp-remote, a third-party bridge run on demand via npx. Prefer signing in instead? Add SearchChamp as a custom connector — see Connect Claude. Both paths reach the same SearchChamp workspace; the connector adds interactive cards and a sign-in flow on top of what the token config below gives you.

{
  "mcpServers": {
    "searchchamp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp-dev.searchchamp.dev/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer atl_mcp_your_token_here"
      }
    }
  }
}

Cursor

Add this to ~/.cursor/mcp.json (or your project’s .cursor/mcp.json), then reload Cursor’s MCP settings. Cursor connects to the remote URL directly — no bridge needed — and its schema takes no type field. Cursor doesn’t support custom OAuth connectors the way Claude and ChatGPT do, so the token path is the only way to connect it today.

{
  "mcpServers": {
    "searchchamp": {
      "url": "https://mcp-dev.searchchamp.dev/mcp",
      "headers": {
        "Authorization": "Bearer atl_mcp_your_token_here"
      }
    }
  }
}

Codex CLI

Put the token in SEARCHCHAMP_MCP_TOKEN in the shell that launches Codex, then run this command. Codex stores only the environment-variable name — the token is not placed in command arguments or committed configuration. The token path uses its minted read/full and optional site lock; the OAuth connector instead follows your interactive account grant.

codex mcp add searchchamp --url https://mcp-dev.searchchamp.dev/mcp --bearer-token-env-var SEARCHCHAMP_MCP_TOKEN

Claude Code, VS Code & other MCP clients

The standard streamable-HTTP shape — drop it into Claude Code’s .mcp.json (or ~/.claude.json for every project), VS Code’s MCP settings, or any client that reads an mcpServers block. These clients require "type": "http" alongside the URL; a few — Cursor above among them — leave it out. If your client rejects the entry, that key is the first thing to add or drop. This is the shape most newer MCP clients expect by default, so if you’re integrating a tool not listed here, start from this config rather than the Claude Desktop or Cursor variants above.

{
  "mcpServers": {
    "searchchamp": {
      "type": "http",
      "url": "https://mcp-dev.searchchamp.dev/mcp",
      "headers": {
        "Authorization": "Bearer atl_mcp_your_token_here"
      }
    }
  }
}
Common questions

MCP connector — FAQ

Hover or click a question for the answer
01

MCP (Model Context Protocol) is an open standard that lets an AI app like Claude or ChatGPT securely call another product's tools and read its data during a conversation. The SearchChamp connector is our implementation of it — it's what lets Claude answer "what's up with my site today?" by actually calling SearchChamp instead of guessing.

GENERAL
02

It's included with every paid SearchChamp plan — no add-on fee and no separate subscription. What tools are available over the lighter-weight token path (see below) does vary by plan tier, but the connector itself isn't a paid upgrade.

GENERAL
03

Claude (web, desktop, and Claude Code) and ChatGPT both support the OAuth-based connector with the full interactive-card experience. Any other MCP-compatible client — Cursor, VS Code, and similar tools — can connect over the token path described below.

GENERAL
04

Yes — get_backlinks_summary is available over the token path on Pro plan and up, and backlink data is also part of the full OAuth connector experience. It returns a summary, not a raw bulk export.

CAPABILITIES
05

Not yet through the connector — keyword research tools are on the roadmap for this integration but aren't usable over MCP today. Keyword difficulty and volume are available in the SearchChamp dashboard itself in the meantime.

CAPABILITIES
06

There isn't a dedicated content-gap tool yet. The closest available today are the Opportunities board and Brief preview cards, both part of the full OAuth connector — they surface what to work on next, just not framed as a formal gap-analysis report.

CAPABILITIES
07

The OAuth connector (Claude and ChatGPT) is the full experience — interactive cards, sign-in once, tool access tied to your account permissions. The token path is a lighter-weight bearer-token connection for any MCP client that doesn't support custom OAuth connectors, like Cursor — it currently exposes a smaller, read-only toolset.

INTEGRATION & SCALE
08

Every tool call returns a summary scoped to what you asked — briefs, rankings, audit issues, and similar — not a raw bulk export of your underlying data. If you need full historical exports, that's a dashboard workflow rather than something the connector is built for.

INTEGRATION & SCALE
09

Claude Code uses the same OAuth connector as Claude's web and desktop apps. Cursor and VS Code connect over the token path — see "Connect with a token" below for the exact config each one needs.

INTEGRATION & SCALE
10

get_rankings and get_ai_visibility are available on Starter and up. get_audit_issues, get_backlinks_summary, get_content_drafts, and get_volatility require Pro plan and up.

PRICING
11

No — connecting Claude, ChatGPT, and a token-based client like Cursor all draw on the same SearchChamp plan. There's no per-connector or per-app fee.

PRICING
12

It still needs a paid SearchChamp plan — the token path is a different connection method, not a free tier. Which specific tools you can call over it depends on whether you're on Starter or Pro and up, per the plan breakdown above.

PRICING
Get started

Connect your first AI app.

Find your connector URL under Settings → Connect your AI apps in your SearchChamp workspace, then follow the setup guide for Claude or ChatGPT.