# Install SearchCon (instructions for AI agents)

SearchCon is a read-only remote MCP server that gives you live access to the user's
Google Search Console: clicks, impressions, rankings, opportunities, URL indexing and sitemaps.

- MCP server URL: `https://searchcon.onrender.com/mcp`
- Transport: Streamable HTTP
- Auth: OAuth 2.1 with dynamic client registration and PKCE. Your client registers itself;
  never ask the user for an API key or token.

## Steps

1. Detect which client you are running in and add the server with the matching command below.
   Show the user the exact command before you run it.
2. Start the OAuth sign-in. A browser window opens: the user signs in with the Google account
   that owns their Search Console properties and approves read-only access.
3. Verify the connection by calling the `list_sites` tool and showing the user their sites.

## Claude Code

```bash
claude mcp add --transport http --scope user searchcon https://searchcon.onrender.com/mcp
```

Then ask the user to type `/mcp`, select **searchcon** and sign in. Tools appear in new sessions.

## Codex CLI

```bash
codex mcp add searchcon --url https://searchcon.onrender.com/mcp
codex mcp login searchcon
```

Always pass `--url`, otherwise Codex treats the address as a local command.
The user can type `/mcp` in Codex to confirm the server is connected.

## Cursor

Add to `~/.cursor/mcp.json` (create it if needed), then sign in from Cursor's MCP settings:

```json
{
  "mcpServers": {
    "searchcon": { "url": "https://searchcon.onrender.com/mcp" }
  }
}
```

## VS Code

Add to `.vscode/mcp.json` in the workspace, then start the server from the MCP view:

```json
{
  "servers": {
    "searchcon": { "type": "http", "url": "https://searchcon.onrender.com/mcp" }
  }
}
```

## ChatGPT and Claude.ai (web apps)

You cannot add connectors to these apps for the user. Send them to https://searchcon.onrender.com/onboarding?step=ai,
which walks them through it (Claude.ai has a one-click install link).

## Good first questions

- "How did my site do in the last 28 days?"
- "Why did my traffic change compared with the previous period?"
- "Which keywords rank 4–20 that I could push to page one?"
- "Is this URL indexed? If not, why?"
- "Is my homepage fast enough? What should I fix first?"