GSC Magic docs

What is GSC Magic

GSC Magic is a hosted MCP server. You sign in once, add one URL to your AI client, and the agent can read your search data directly instead of working from CSV exports and screenshots.

Along the way the dashboard at app.gscmagic.com shows the same data as charts, keeps a history longer than Google’s 16 months, sends alerts, and logs everything your agents do.

Quickstart

1. Create your account. Open the dashboard and continue with Google, or create an account with e-mail and password (you will confirm the address by e-mail). Use the Google account that owns your Search Console properties.
2. Allow access. The first sign-in asks Google once for Search Console, read-only Google Analytics 4 and read-only Tag Manager. Nothing is switched on for writing unless your plan allows it.
3. Import your sites. On the Welcome screen, pick the properties to add. GSC Magic shows the busiest first and respects your plan’s site limit. Bing sites and GA4 properties with the same host are linked automatically.
4. Connect your AI client. Follow AI clients below. The endpoint is https://mcp.gscmagic.com/mcp.
5. Ask something. Start with “List my sites in GSC Magic.” Then try a prompt from Example prompts.

The Connect page in the dashboard has the same instructions, with one-click buttons and a connection test.

AI clients

The endpoint is the same everywhere:

https://mcp.gscmagic.com/mcp

Clients that support OAuth sign you in through a GSC Magic page. For clients that do not, use an access token.

Claude (claude.ai, desktop and mobile)

1. Open Customize → Connectors → Add custom connector, name it GSC Magic and paste the endpoint. The dashboard’s Connect page has an Add to Claude button that pre-fills this.
2. Click Connect next to GSC Magic, continue with Google (or e-mail) and allow access.
3. In a new chat, enable GSC Magic under + → Connectors and ask “List my sites in GSC Magic.”

On Team and Enterprise plans only an Owner can add the connector (Organization settings → Connectors → Add → Custom); members then click Connect themselves. Connectors added on the web appear in the desktop and mobile apps.

ChatGPT

1. Turn on Developer mode: Settings → Apps → Advanced settings → Developer mode. On Business, Enterprise and Edu a workspace admin enables it first.
2. Create an app: name GSC Magic, MCP server URL as above, authentication OAuth. Leave client ID and secret empty and tick “I trust this application.”
3. Sign in with Google when ChatGPT opens the GSC Magic page, then pick GSC Magic from the + menu in a chat.

Custom MCP apps need a paid ChatGPT plan, and OpenAI moves these menus around. ChatGPT has no field for a custom header, so it cannot use an access token.

Claude Code

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp

Then type /mcp, pick gsc-magic and choose Authenticate. With a token instead of a browser sign-in:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp \
  --header "Authorization: Bearer gsm_YOUR_TOKEN"

Cursor

Add this to ~/.cursor/mcp.json, then click Connect next to gsc-magic in Settings → MCP:

{
  "mcpServers": {
    "gsc-magic": {
      "url": "https://mcp.gscmagic.com/mcp"
    }
  }
}

Older Cursor versions finish the sign-in on cursor://, which GSC Magic does not accept. Use a token there:

{
  "mcpServers": {
    "gsc-magic": {
      "url": "https://mcp.gscmagic.com/mcp",
      "headers": {
        "Authorization": "Bearer gsm_YOUR_TOKEN"
      }
    }
  }
}

VS Code, Windsurf and others

Any client that speaks remote MCP over Streamable HTTP works. Give it the endpoint and, if it cannot do OAuth, this request header:

Authorization: Bearer gsm_YOUR_TOKEN

The dashboard’s Connect page lists ready-made snippets for VS Code, Windsurf, Hermes Agent, OpenClaw, Grok and DeepSeek.

Access tokens

An access token (gsm_…) lets a client connect without a browser sign-in. It suits scripts, automation tools and clients without OAuth.

• Create one in the dashboard under Connect → Access tokens (workspace owner or admin). The full token is shown once. Store it in the client’s own config, never in a chat.
• Tokens expire after 365 days by default. You can pick a different lifetime up to 730 days, or none.
• Tick Read-only to make a token incapable of writing, whatever your plan allows.
• A token works on the MCP endpoint only, not on the dashboard API, and can be revoked at any moment. Revoking takes effect immediately.
• The Test connection button on the Connect page checks that an endpoint and token work.

Data sources

Connected is not linked. Access to GA4 or a Bing key only makes properties discoverable. To see data on the Overview page, link a GA4 property and a Bing site to each site under Sites. Sources shows how many sites are linked.

Each source has Reconnect and Disconnect. Disconnecting GA4 stops GSC Magic reading it and removes the GA4 rows we stored; your Google connection and Search Console stay as they are.

Dashboard

History. After you add a site, GSC Magic backfills up to 16 months of daily data (14 days on Free), then refreshes every six hours. Raising your plan pulls in the older months. You can export or delete your stored history at any time.

Alerts and digest

On Pro and Agency, GSC Magic checks your sites after every sync and e-mails you when something needs attention. Delivery is by e-mail to the workspace owner. Every message has an unsubscribe link.

• Traffic drop: a page lost a large share of its clicks (30% by default).
• Indexing: a page that had traffic stopped appearing.
• Cannibalization: two of your pages started splitting a query.
• Ranking: an important query fell several positions.
• AI traffic: sessions from AI assistants jumped (needs GA4).

You can edit thresholds, turn rules off and delete them (with an Undo for a few seconds). A weekly digest summarizes your sites. On Free, the Overview’s What changed card previews what these rules would find. Each finding is reported once per week.

Example prompts

Replace example.com with your site. Your agent picks the right tools by itself.

More ideas in the prompt library.

Tools reference

Tools marked write change something in Google, Bing or IndexNow. They are offered to the agent only when your plan allows writing, write mode is on in Settings, and the source permits it (Search Console writes also need the full Google permission, which the first sign-in requests). Everything else is read-only.

Plans and limits

• 7-day Pro trial on new accounts, with no card needed. When it ends the account returns to Free. One trial per e-mail address.
• Every call to a tool counts, including failed ones. The daily limit resets at midnight UTC.
• If a plan ends and you have more sites than the new plan allows, the dashboard asks which to keep and the MCP endpoint pauses until you choose.
• Payments and invoices are handled by Polar. Cancel any time; the plan stays active to the end of the period you paid for.

Teams and roles

The Agency plan includes five seats counting the owner. Everyone works on the owner’s workspace, data and plan.

Client groups restrict a person to selected sites. A member or admin in a group sees only those sites in the dashboard, in alerts and through MCP, and nothing else. Subdomains count as separate sites, so you can give a.com to one client and blog.a.com to another. Invitations are e-mailed and valid for seven days.

Security and privacy

• Google and Bing credentials are encrypted at rest. Access tokens are stored only as hashes.
• Your agent sees data only from accounts you connected, scoped to your workspace and your role.
• Read-only is the default. Write tools need the right plan, write mode and Google permission, and each token can be forced read-only.
• Sessions expire after 14 idle days. Sensitive actions such as deleting your account require a recent sign-in.
• Export everything we hold about you from Settings, or delete your account and data there. Active paid subscriptions must be cancelled first.

Details are in the privacy policy and terms. To report a vulnerability write to support@gscmagic.com.

Troubleshooting

Still stuck? Write to support@gscmagic.com with the client you use and the error message. Never include an access token.

Quick answers